目录、插图清单和表格清单

tableofcontents 命令,以及为什么需要编译第二遍。

目录、插图清单和表格清单

LaTeX 中的目录不需要你构建或维护。你在想要的位置放一条命令,LaTeX 就会从你已写好的标题中汇编出条目。插图清单和表格清单也是同样的道理,只是收集的是题注而不是标题。这是声明式结构直接带来回报的地方之一:重命名一个章节或移动一张插图,前置部分就会自行更新。

三条命令

\tableofcontents
\listoffigures
\listoftables

\tableofcontents 在它出现的位置打印目录,通常紧跟在标题页或摘要之后。每个带编号的 \chapter、\section 和 \subsection 都会连同编号、标题和页码显示出来,深入到标题课程中讲到的 tocdepth 计数器所设定的深度。\listoffigures 和 \listoftables 对插图和表格的题注做同样的事情,从每条 \caption{...} 中提取文本。在 article 类的短文中它们并不常见,但学位论文通常两者都需要,各自单独成页放在目录之后。

为什么第二遍编译很重要

结构性修改之后编译两次。这不是迷信,而是机制如此。在一次编译过程中,LaTeX 无法知道第 2 页上的内容最终会落在第 47 页,所以它边编译边把每个标题及其最终页码写入辅助文件(.toc、.lof、.lot)。\tableofcontents 读取的是上一次运行留下的文件。在全新项目中该文件还不存在,所以第一次编译会生成空的目录。在你添加或移动章节之后,目录会显示过时的标题或错误的页码,直到下一次运行。第二次编译读取新写入的文件,一切就对齐了。运行 latexmk 或等效包装器的编辑器会替你处理这些重复运行,这就是你可能从未注意到它的原因。如果你的目录看起来不对,先再编译一次,再去排查别的问题。

带星号的章节与目录

如果带星号的章节应该出现在目录中,就需要 \addcontentsline{toc}{section}{Title}。像 \section*{Acknowledgments} 这样的带星号标题会刻意跳过编号和目录文件,所以如果你希望它被列出来,就要自己添加条目。这条命令的三个参数分别是要写入的文件(toc)、条目的级别(section)和要显示的文本。把这一行紧跟在带星号的标题之后,这样记录到的页码才是正确的。

一个值得养成的习惯:在分享 PDF 之前,扫一眼目录,看看有没有陈旧构建的明显迹象,比如问号、缺失的条目,或者最后一个条目停在你的最后一章之前。它几乎总是再编译一次就能解决。自己发现问题,比审阅者替你发现问题代价小得多。同样的辅助文件机制也支撑着 \ref 及其相关命令,见交叉引用。

返回 论文骨架