包含主 *.tex 文件的超级/子目录中的 *.sty 文件

Question

我想通过 git 与许多其他人分享乳胶文档。 因此，我们决定将每个人的 Latex 安装中不存在的所有特殊 sty 文件放入资源目录中。如果这个目录是超级目录，那就太酷了。实际工作目录的 我究竟如何导入这些样式文件？

重要的是，即使这些远程样式的依赖关系也可以通过其他远程样式来解决。

Answer 1

您可以通过两种方式将样式文件 (mystyle.sty) 导入到文档中：

1. 如果它位于您的路径中或与 .tex 文件位于同一文件夹中，只需在序言中包含此行： \usepackage{mystyle}
2. 如果您将其放在其他文件夹中，则可以使用其完整路径 \usepackage{/path/to/folder/ 进行访问也就是说

，如果您不确定样式文件是否在每个人的安装中，只需将其包含在同一目录中，并确保执行 git add mystyle.sty 并跟踪它与您的其他文件一起保存（尽管很可能不会对其进行任何更改）。不需要父目录。但如果您坚持使用不同的目录，请参阅上面的选项 2。

如果它位于子目录中会比位于父目录中更好，因为您仍然可以将该文件称为 \usepackage{subdir/mystyle} 并确保您正在调用样式文件。但是，如果您转义到父目录，您永远不知道其他用户是否有一个不属于您的包的类似名称的文件夹，这可能会导致错误。

Answer 2

这可能与您不再相关，但这里有另一种方法可以实现您想要的功能。
像这样设置你的 git 存储库：

mystyle.sty
project/
    makefile
    project.tex

并将 \usepackage{mystyle} 放在 project.tex 的序言中。
当然，手动编译 project.tex 是行不通的，因为 mystyle.sty 与 project.tex 不在同一目录中。

但是，如果 makefile 包含以下内容：

project.pdf: mystyle.sty project.tex
    pdflatex project

mystyle.sty: ../mystyle.sty
    cp ../$@ $@

那么从 project 目录中运行 make 将导致 mystyle.styproject.tex 编译（这次成功）之前将 code> 复制到正确的位置。

这种方式可能看起来有点夸张，但它确实结合了其他方法的最佳功能。

1. 如果同一存储库中的多个项目需要 mystyle.sty，那么在它们之上放置一个通用的 mystyle.sty 比在每个项目目录中都有一个副本更有意义；所有这些副本都必须保留。
2. 编译是可移植的，从某种意义上说，如果您给了我 mystyle.sty 和 project.tex 的副本，那么我（至少在理论上）将能够编译手动，无需修改您给我的文件。
   例如，我不必将 \usepackage{/your/path/mystyle} 替换为 \usepackage{/my/path/mystyle}。

Answer 3

您可以按照上面的建议使用 Makefile。另一个选择是 CMake。我没有测试父目录。

如果您有以下文件结构：

    ├── CMakeLists.txt
    ├── cmake
    │   └── UseLATEX.cmake
    ├── img
    │   └── logo.jpg
    ├── lib
    │   └── framed.sty
    └── main.tex

• 您应该安装 CMake，请参阅 CMake 资源

• UseLATEX.cmake 可以从此处

• 然后在CMakeLists.txt

  ╚═$ cat CMakeLists.txt
  cmake_minimum_required（2.6 版）
  设置（PROJECT_NAME_STR myProject）
  项目（${PROJECT_NAME_STR}）
  
  设置（CMAKE_MODULE_PATH“$ {CMAKE_CURRENT_SOURCE_DIR} / cmake”）
  包括（使用LATEX）
  
  ADD_LATEX_DOCUMENT（主.tex
                     IMAGE_DIRS 图片
                     默认_PDF
                     MANGLE_TARGET_NAMES）
  

• main.tex 的一些示例内容（注意图像）

  ╚═$ cat main.tex
  \documentclass{报告}
  
  \开始{文档}
  
  \开始{中心}
    \includegraphics[宽度=300px]{img/logo.jpg}
  \结束{中心}
  
  \结束{文档}
  

• lib 目录包含 *.sty 文件

• 您可以现在编译：

  cd /directory/that/has/CMakeLists.txt/
  mkdir 构建
  光盘构建
  ..
  制作
  

• 然后您可以查看构建目录中的 main.pdf。

Answer 4

当您使用使用 kpathsea 的 TeX 发行版时，您可以使用 TEXINPUTS 环境变量指定 TeX 在哪里查找文件。该变量需要按以下方式使用。

TEXINPUTS 中的路径由 : 分隔。空路径将包含默认搜索路径，即仅包含冒号。两个连续的斜杠表示搜索该目录及其所有子目录。

因此，例如，要构建一个文件 document.pdf ，该文件使用当前目录、resources 目录的所有子目录和默认目录中的文件，您可以使用以下Makefile。

document.pdf: document.tex
    TEXINPUTS=.:./resources//: pdflatex document.tex

要加快文件名查找速度，您可以使用 mktexlsr 命令构建 ls-R 数据库。

有关 kpathsea 的所有详细信息，请参阅手册。

Answer 5

您可以使用 Latexmk 及其工具

第 48 页的 Utility subroutines 下记录了一个功能 这里在latexmk中，它可以在运行期间更新TEXINPUTS。如果您可以考虑使用 .latexmkrc 文件来配置您的链和选项，您可以将 ensure_path() 添加到该文件：

这是一个示例：

# .latexmkrc
ensure_path('TEXINPUTS', './path/to/something//', '/full/path/to/something/else//')
# [...] Other options goes here.
$pdf_update_method = 3;
$xelatex = 'xelatex -synctex=1 -interaction=nonstopmode -file-line-error %O %S';
$pdf_previewer = 'start "%ProgramFiles%/SumatraPDF/SumatraPDF.exe" %O %S';
$out_dir = 'build/';

注意 // 位于路径末尾，这将帮助 LaTeX 搜索指定目录和所有子目录中的文件。

请注意，虽然这是一个令人惊叹的功能，但您需要妥善保管您的命名方案。如果您在多个位置使用相同的文件名，则在使用 \include{somefile} 导入它们时可能会遇到麻烦。