空白的參考文獻
路徑、後端、缺少的引用,以及 printbibliography 與 bibliography 的差別。
空白的參考文獻
症狀
你的文件編譯時沒有致命錯誤,但「參考文獻」章節完全不見了,或是標題出現了,底下卻什麼都沒有。內文中的每個 \cite 往往同時顯示成粗體問號。沒有任何東西當掉,所以沒有明顯的錯誤可以追查,這正是這個問題令人沮喪的地方。
為什麼會發生
參考文獻不是單靠 LaTeX 產生的。LaTeX 先把被引用的鍵名清單寫進一個輔助檔。另一個獨立的後端程式(bibtex 或 biber)讀取你的 .bib 資料庫,並把相符的條目格式化。最後 LaTeX 在下一輪編譯時,把格式化的結果讀回來。空白的參考文獻表示這條流程在某處斷掉了:後端根本沒有執行、執行了卻找不到資料庫、找到了資料庫但沒有任何鍵名被要求,或是文件用了錯誤的指令來索取結果。
依序排查原因
首先,確認資料庫檔案真的位在文件所指的地方。\bibliography{refs} 和 \addbibresource{refs.bib} 都是相對於主檔案尋找 refs.bib,所以放在 bib/ 子資料夾中的檔案,必須以 bib/refs 或 bib/refs.bib 來引用。錯誤的路徑會悄悄失敗。
其次,確認後端確實執行過。只編譯一次永遠不夠;完整的循環是 LaTeX,接著 bibtex 或 biber,然後再 LaTeX 兩次。Oleafly 會替你管理建置的各輪次;Biber 專案請選擇 TinyTeX 或系統 TeX 引擎,不過手動驅動的建置,或設定有誤的編輯器工具鏈,可能會跳過中間那一步,結果正是一份空白的參考文獻清單。
第三,檢查至少有一個 \cite 指令存在。後端只會格式化文件索取的條目,所以尚未有任何引用的草稿,依設計就會得到一份空清單。在早期起草階段,你可以用 \nocite{*} 強制把所有條目都放進來,它會索取資料庫中的每一筆條目,卻不在內文中印出任何東西。
第四,讓指令與系統相符。傳統 BibTeX 文件以 \bibliographystyle{...} 和 \bibliography{refs} 結尾。biblatex 文件則在前置區(preamble)用 \addbibresource{refs.bib} 載入資料庫,並用 \printbibliography 印出。把兩者混用,例如載入了 biblatex 卻仍然呼叫 \bibliography,正會產生這種失敗。執行錯誤的後端也是同樣的情況:biblatex 需要 biber,餵給它傳統的 bibtex 什麼也得不到。
閱讀後端自己的日誌
後端會把它的抱怨寫進你文件旁邊的 .blg 檔,格式錯誤的條目、重複的鍵名,以及「I couldn’t open database file」這類訊息都會出現在那裡。如果上面的步驟看起來都對,清單卻仍然是空的,.blg 日誌幾乎一定會點出真正的元凶。至於參考文獻本身出現之後仍然持續存在的問號,請見清除莫名其妙的引用標記。