目次、図の一覧、表の一覧

tableofcontents と、2 回目のコンパイルが重要な理由。

目次、図の一覧、表の一覧

LaTeX の目次は、自分で作ったり、保守したりするものではありません。置きたい場所にコマンドを 1 つ書けば、すでに書いてある見出しから LaTeX が項目を組み立てます。図の一覧と表の一覧も同じで、こちらは見出しではなくキャプションを集めます。構造を宣言しておく利点が、そのまま表れる場面の 1 つです。節の名前を変えたり、図を移動したりしても、前付けが自動で直ります。

3 つのコマンド

\tableofcontents
\listoffigures
\listoftables

\tableofcontents は、書いた位置に目次を出力します。通常はタイトルページか概要の直後です。番号付きの \chapter、\section、\subsection が、番号、タイトル、ページとともに載ります。深さは、見出しのレッスン で説明した tocdepth カウンタで決まります。\listoffigures と \listoftables は、図と表のキャプションに対して同じことをし、それぞれの \caption{...} から文字を取り出します。論文(article)ではあまり見かけませんが、学位論文ではたいてい両方が必要で、目次の後ろに専用のページとして置きます。

2 回目のコンパイルが重要な理由

構造を変更した後は、2 回コンパイルしてください。これは迷信ではなく、仕組みによるものです。コンパイル中、LaTeX は 2 ページ目の時点で、何が 47 ページ目に来るかを知ることができません。そのため、すべての見出しと最終的なページ番号を、進めながら補助ファイル(.toc、.lof、.lot)に書き出します。\tableofcontents が読むのは、前回の実行で残ったファイルです。作ったばかりのプロジェクトにはそのファイルがまだないので、最初のコンパイルでは目次が空になります。節を追加したり移動したりした後は、次に実行するまで、目次に古いタイトルや誤ったページ番号が表示されます。2 回目のコンパイルで、書き出されたばかりのファイルが読み込まれ、すべてが揃います。latexmk や同等のラッパーを実行するエディタは、再実行を自動で行うので、この仕組みに気づいたことがないかもしれません。目次がおかしいときは、他のことをデバッグする前に、もう一度コンパイルしてください。

アスター付きの節と目次

アスター付きの節を目次に載せたい場合は、\addcontentsline{toc}{section}{Title} が必要です。\section*{Acknowledgments} のようにアスターを付けた見出しは、番号付けと目次ファイルへの記録の両方をあえて省くので、載せたいなら自分で項目を追加します。このコマンドの 3 つの引数は、書き込み先のファイル(toc)、項目のレベル(section)、表示するテキストです。記録されるページ番号が正しくなるよう、アスター付きの見出しの直後に書いてください。

身につけておくとよい習慣が 1 つあります。PDF を共有する前に、目次を見て、ビルドが古いときの兆候がないか確認します。たとえば、疑問符、抜けている項目、最後の章まで届いていない最終項目などです。ほとんどの場合、もう一度コンパイルすれば直ります。査読者に見つけられるより、自分で見つけるほうが楽です。同じ補助ファイルの仕組みが、\ref などにも使われています。詳しくは 相互参照 を見てください。

論文の骨格 に戻る