将 LaTeX 论文拆分为多个文件
用主文档、独立章节、图片和参考文献数据组织长篇稿件。
本页内容
一个主文件负责文档设置,较小文件分别负责章节或资源,长稿件会更容易导航。本课组织的是一篇论文和一个根文档;如果要把不同论文放在一起并切换预览,请查看在一个项目中撰写多篇论文。
规划项目文件树#
典型研究论文可以这样组织:
main.tex
sections/
introduction.tex
methods.tex
results.tex
figures/
calibration.pdf
references.bib
macros.tex将 \documentclass、宏包、全局设置和 document 环境保留在 main.tex 中。复用定义放在 macros.tex,文献记录放在 references.bib,每个章节文件负责一段连贯内容。章节文件不应重复文档类,也不应开始另一个文档。
引入章节文件#
在 CorTeX 文件树创建文件夹和文件,再按阅读顺序从 main.tex 引入:
\documentclass{article}
\input{macros}
\begin{document}
\input{sections/introduction}
\input{sections/methods}
\input{sections/results}
\bibliographystyle{plain}
\bibliography{references}
\end{document}\input 将文件内容插入当前位置,不强制分页,可以省略 .tex 扩展名。\include 面向章级内容,通常另起一页,并可配合 \includeonly 对大型书籍选择性编译。
以下编译示例仅为保持文档示例自包含而使用 filecontents*。真实项目应另行创建 introduction.tex 文件。
\begin{filecontents*}{introduction.tex}
\section{Introduction}
This section is stored in its own file.
\end{filecontents*}
\documentclass{article}
\begin{document}
\input{introduction}
\section{Results}
The main file controls the document order.
\end{document}从主文档解析路径#
项目路径使用 /,并区分大小写。LaTeX 相对路径从主文档所在目录解析,而不是从命令所在章节的目录解析。如果 main.tex 位于项目根目录,那么即使图片在 sections/results.tex 中被引用,也仍写作 figures/calibration.pdf。
打开 main.tex,选择该论文的预览。如果还应将它作为项目打开默认项,通过行菜单选择设为主文档。编辑器可以保持章节文件打开,同时 CorTeX 编译该章节所属论文。合作者因而可以在各自章节中写作,而不改变共用的正文顺序和导言区。
重命名或移动文件时,CorTeX 会更新已识别的 LaTeX 引用,并显示项目更改。自定义宏、计算得到的路径和正文中的路径未必能安全重写,请另外检查。
保持项目可复现#
每项设置只保留一处来源:不要在章节文件中重复加载宏包,也不要维护相互竞争的宏文件。除非由所选 TeX Live 快照提供,否则请把论文需要的 .bib、文档类、样式、字体和图片保存在项目中。大范围整理前保存命名版本。
添加或移动文件后,从 main.tex 编译。整篇论文按预期顺序出现、交叉引用和文献引用正常,且另一位合作者无需您的本地私有文件也能编译时,即完成检查。缺少依赖时,请查看文件缺失指南。
