コンパイルを複数回行う理由

aux ファイル、参考文献の処理、初回に参照が ?? と表示される理由。

コンパイルを複数回行う理由

そのうち、文書をコンパイルして PDF を開くと、図番号や引用があるはずの場所に ?? が出ていることがあります。壊れているわけではありません。1 回のコンパイルはファイルを 1 回なぞるだけで、1 回では本当に知りようがない情報があるのです。

問題を小さくして見てみましょう。2 ページ目に「see Figure \ref{fig:results}」と書いたのに、その図は 7 ページ目に置かれます。エンジンが 2 ページ目を組版する時点では、7 ページ目にまだ達していないので、その図に何番が付くのか分かりません。目次も同じで、1 ページ目が終わる前に、すべての節のページ番号が必要になります。

エンジンはどう解決するか

LaTeX エンジンは .tex ファイルを読み、すべてのマクロを展開して、PDF を書き出します。PDF と並んで、小さな補助ファイルも書きます。ラベルと引用のための .aux、目次のための .toc、整形された参考文献のための .bbl です。これらのファイルは、エンジンが未来の自分に残すメモです。

  1. 1 回目で、エンジンは本文を組版し、出会った \label と \cite をすべて .aux ファイルに書き出します。まだ分からない番号が必要な箇所には ?? を出力します。
  2. 何かを引用していれば、次に参考文献ツール(bibtex または biber)が .aux ファイルを読み、各引用を .bib データベースから探し、整形された参考文献リストを .bbl ファイルに書き込みます。
  3. 2 回目、場合によっては 3 回目で、エンジンはそれらの補助ファイルを読み戻し、相互参照、目次の項目、引用ラベルがようやく本物の番号に解決されます。

最近の環境ではこれらの処理を自動で行ってくれるので、実際には自分でコマンドを打つことはほとんどありません。それでもこの流れを知っておくと、症状の理由が分かります。ラベルや引用を追加した直後にまた ?? が出るのは、補助ファイルがまだ追いついていないだけで、もう一度コンパイルすれば直ります。

エンジンを一言ずつ

「エンジン」の役を担えるプログラムはいくつかあります。pdfLaTeX は、ジャーナルへの対応が最も広い、昔ながらの選択肢です。XeLaTeX は完全な Unicode に対応し、システムにインストールされたフォントを使えます。LuaLaTeX も Unicode に対応し、高度なパッケージ向けにスクリプト言語を組み込んでいます。Tectonic は、必要になった初回にパッケージをダウンロードする現代的なエンジンです。Oleafly はそれを同梱しているので、新しいプロジェクトも TeX ディストリビューションを先にインストールせずにコンパイルできます。

ほとんどの文書では、違いはほとんど問題になりません。テンプレートや投稿先が想定しているものを選んで、先に進みましょう。意図して選ぶ必要があるときは、エンジンの比較を見てください。

実際に失敗したとき

コンパイルに失敗すると長いログが出力され、つい下から読みたくなります。それは我慢してください。ログの最初のエラーを読み、それだけを直します。後ろのエラーは、最初のエラーが引き起こした連鎖的なノイズであることがとても多いからです。連続して 2 回コンパイルに成功しても参照が ?? のままなら、原因は多くの場合、処理回数の不足ではなく、\label や \ref の名前のタイプミスです。

ループを開く に戻る