コンパイルを複数回行う理由
aux ファイル、参考文献の処理、初回に参照が ?? と表示される理由。
コンパイルを複数回行う理由
そのうち、文書をコンパイルして PDF を開くと、図番号や引用があるはずの場所に ?? が出ていることがあります。壊れているわけではありません。1 回のコンパイルはファイルを 1 回なぞるだけで、1 回では本当に知りようがない情報があるのです。
問題を小さくして見てみましょう。2 ページ目に「see Figure \ref{fig:results}」と書いたのに、その図は 7 ページ目に置かれます。エンジンが 2 ページ目を組版する時点では、7 ページ目にまだ達していないので、その図に何番が付くのか分かりません。目次も同じで、1 ページ目が終わる前に、すべての節のページ番号が必要になります。
エンジンはどう解決するか
LaTeX エンジンは .tex ファイルを読み、すべてのマクロを展開して、PDF を書き出します。PDF と並んで、小さな補助ファイルも書きます。ラベルと引用のための .aux、目次のための .toc、整形された参考文献のための .bbl です。これらのファイルは、エンジンが未来の自分に残すメモです。
- 1 回目で、エンジンは本文を組版し、出会った
\labelと\citeをすべて.auxファイルに書き出します。まだ分からない番号が必要な箇所には??を出力します。 - 何かを引用していれば、次に参考文献ツール(bibtex または biber)が
.auxファイルを読み、各引用を.bibデータベースから探し、整形された参考文献リストを.bblファイルに書き込みます。 - 2 回目、場合によっては 3 回目で、エンジンはそれらの補助ファイルを読み戻し、相互参照、目次の項目、引用ラベルがようやく本物の番号に解決されます。
最近の環境ではこれらの処理を自動で行ってくれるので、実際には自分でコマンドを打つことはほとんどありません。それでもこの流れを知っておくと、症状の理由が分かります。ラベルや引用を追加した直後にまた ?? が出るのは、補助ファイルがまだ追いついていないだけで、もう一度コンパイルすれば直ります。
エンジンを一言ずつ
「エンジン」の役を担えるプログラムはいくつかあります。pdfLaTeX は、ジャーナルへの対応が最も広い、昔ながらの選択肢です。XeLaTeX は完全な Unicode に対応し、システムにインストールされたフォントを使えます。LuaLaTeX も Unicode に対応し、高度なパッケージ向けにスクリプト言語を組み込んでいます。Tectonic は、必要になった初回にパッケージをダウンロードする現代的なエンジンです。Oleafly はそれを同梱しているので、新しいプロジェクトも TeX ディストリビューションを先にインストールせずにコンパイルできます。
ほとんどの文書では、違いはほとんど問題になりません。テンプレートや投稿先が想定しているものを選んで、先に進みましょう。意図して選ぶ必要があるときは、エンジンの比較を見てください。
実際に失敗したとき
コンパイルに失敗すると長いログが出力され、つい下から読みたくなります。それは我慢してください。ログの最初のエラーを読み、それだけを直します。後ろのエラーは、最初のエラーが引き起こした連鎖的なノイズであることがとても多いからです。連続して 2 回コンパイルに成功しても参照が ?? のままなら、原因は多くの場合、処理回数の不足ではなく、\label や \ref の名前のタイプミスです。