CorTeX 文档打开 CorTeX
打开 CorTeX
浏览全部主题

将 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 文件。

LaTeX 源代码
\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 编译。整篇论文按预期顺序出现、交叉引用和文献引用正常,且另一位合作者无需您的本地私有文件也能编译时,即完成检查。缺少依赖时,请查看文件缺失指南