一个根文件,多个章节

include 与 input 的区别、includeonly,以及一次只起草一章。

一个根文件,多个章节

把整篇学位论文放在一个 .tex 文件里,到第二章前后就会变得难以忍受:滚动代替了思考,而且每次编译都要处理全部内容。标准的解决办法是用一个根文件存放文档类和导言区,每一章放在各自的文件里。根文件把它们缝合在一起。

根文件

% main.tex
\documentclass{report}
\begin{document}
\include{chapters/intro}
\include{chapters/methods}
\include{chapters/results}
\end{document}

main.tex 是你唯一需要编译的文件。每个 \include 写出另一个文件的名字,不带 .tex 扩展名,在所有平台上都用正斜杠,并在该处把它的内容拉进来。章节文件本身只包含内容,通常以 \chapter{...} 开头。它们没有自己的 \documentclass,也没有自己的 document 环境,因为它们是这篇文档的片段,而不是独立的文档。

include 与 input

这两个包含命令的行为不同,这些差异决定了在哪里用哪一个。\include 在被包含的内容之前另起一页,适合章节,并且为每个被包含的文件写出单独的 .aux 文件,这正是能够选择性编译的原因。\input 就是一次纯粹的文本粘贴:没有分页,没有单独的 .aux,而且可以嵌套在另一个 input 之中。因此对于比一章更小的片段,\input 是合适的工具,比如放在独立文件里的一张大表格,或者共享的宏文件。需要记住的一条结构规则是:\include 不能嵌套在被包含的文件里,而 \input 可以用在任何地方。

一次只起草一章

\includeonly{chapters/methods}

放在导言区时,\includeonly 告诉 LaTeX 只处理所列出的文件,同时仍读取其他所有文件已保存的 .aux 数据。编译会快得多,而且由于其他章节的标签和页数是从它们的 .aux 文件中重放的,你正在起草的那一章里的交叉引用和编号仍然正确。后半点正是应当优先选用它、而不是注释掉 \include 行的原因,后者会把其他章节忘得一干二净,让每个指向它们的 \ref 都变成 ??。

完整构建时请把 \includeonly 这一行注释掉,并且在分享 PDF 之前一定要完整编译一次,因为过时的 .aux 数据可能落后于对被排除章节所做的编辑。至于得到的文件夹里哪些文件是你的、哪些是生成的,参见真实项目中的文件。

返回 长文