為什麼要編譯不只一次

aux 檔、參考文獻的處理輪次,以及為什麼第一次編譯時參照會顯示 ??。

為什麼要編譯不只一次

遲早你會編譯一份文件,打開 PDF,卻在應該出現圖片編號或引用的位置看到 ??。沒有任何東西壞掉。單次編譯就是把你的檔案從頭處理一輪,而有些資訊在一輪之中根本不可能知道。

這是問題的縮影。你在第 2 頁寫了「見圖 \ref{fig:results}」,但那張圖落在第 7 頁。引擎排第 2 頁時,還沒有排到第 7 頁,所以完全不知道那張圖會得到什麼編號。目錄也是同樣的情況,它需要每一節的頁碼,而第一頁都還沒排完。

引擎如何解決這個問題

LaTeX 引擎讀取你的 .tex 檔,展開每個巨集,並寫出 PDF。除了 PDF,它也會寫出一些小型的輔助檔:.aux 存放標籤與引用,.toc 存放目錄,.bbl 存放排好格式的參考文獻。這些檔案是引擎留給未來的自己的筆記。

  1. 第一輪時,引擎排出你的文字,並把它遇到的每個 \label 和 \cite 寫入 .aux 檔,凡是需要一個它還不知道的編號時,就印出 ??。
  2. 如果你有引用任何東西,接著由參考文獻工具(bibtex 或 biber)讀取 .aux 檔,到你的 .bib 資料庫中查找每一筆引用,並把排好格式的參考文獻清單寫入 .bbl 檔。
  3. 在第二輪,有時還有第三輪,引擎會把這些輔助檔讀回來,於是交互參照、目錄項目和引用標籤終於都解析成真正的編號。

現代的環境會自動替你跑完這些輪次,所以實際上你很少需要自己輸入這些指令。但是了解這個循環就能解釋這個症狀:在新增標籤或引用之後出現新的 ??,只表示輔助檔還沒跟上,再編譯一次就能解決。

一行說明各個引擎

有好幾個程式都可以扮演「引擎」的角色。pdfLaTeX 是經典的選擇,期刊的支援最廣。XeLaTeX 加入完整的 Unicode,並讓你使用系統上安裝的字型。LuaLaTeX 同樣支援 Unicode,並內嵌一種腳本語言供進階套件使用。Tectonic 是現代的引擎,會在你第一次需要時依需求下載套件。Oleafly 內建了它,所以新專案不必先安裝 TeX 發行版就能編譯。

對大多數文件來說,這些差異幾乎無關緊要;範本或期刊、研討會期待哪一個,就選哪一個,然後繼續往前。當你需要審慎做選擇時,請見引擎比較。

真的失敗時

編譯失敗時會傾倒出一長串記錄,而人的直覺是從底部往上讀。請克制這個衝動。讀記錄中的第一個錯誤,只修那一個;後面的錯誤往往是第一個錯誤引起的連鎖雜訊。如果連續兩次成功編譯後,參照仍然顯示 ??,通常的元兇是 \label 或 \ref 名稱打錯了,而不是少跑了一輪。

返回 打開循環