参考文献リストが空になる
パス、バックエンド、cite の欠落、printbibliography と bibliography の違い。
参考文献リストが空になる
症状
ドキュメントは致命的なエラーなしでコンパイルできるのに、「参考文献」セクションがまるごと消えている、または見出しだけが出て中身がありません。同時に、本文中の \cite がすべて太字の疑問符になることもよくあります。何もクラッシュしていないので追いかけるべきエラーが見当たらず、そこがこの問題のやっかいなところです。
なぜ起こるのか
参考文献は LaTeX だけでは作られません。LaTeX はまず、引用されたキーの一覧を補助ファイルに書き出します。次に、別のバックエンドプログラム(bibtex または biber)が .bib データベースを読み、該当するエントリを整形します。最後に、LaTeX が次のコンパイルでその整形結果を読み戻します。参考文献リストが空ということは、この流れのどこかが途切れているということです。バックエンドが一度も実行されなかった、実行されたがデータベースが見つからなかった、データベースは見つかったが要求されたキーがなかった、または結果を取り込むコマンドが間違っている、のいずれかです。
原因を順に確認する
まず、データベースファイルが、ドキュメントに書かれた場所に実在することを確認します。\bibliography{refs} も \addbibresource{refs.bib} も、メインファイルからの相対パスで refs.bib を探します。したがって、bib/ サブフォルダーにあるファイルは bib/refs または bib/refs.bib と指定する必要があります。パスが間違っていても、エラーは出ず、静かに失敗します。
次に、バックエンドが実際に実行されたかを確認します。コンパイルを 1 回行うだけでは決して足りません。LaTeX、bibtex または biber、そして LaTeX をさらに 2 回、という一連の流れが必要です。Oleafly はビルドの各パスを自動で管理します。Biber を使うプロジェクトでは TinyTeX かシステムの TeX エンジンを選んでください。ただし、手動で動かすビルドや、設定を誤ったエディターのツールチェーンでは中間のステップが抜けることがあり、その結果がまさに空の参考文献リストです。
3 つ目に、\cite コマンドが少なくとも 1 つあることを確認します。バックエンドは、ドキュメントが要求したエントリしか整形しません。そのため、まだ引用が 1 つもない下書きでは、リストが空になるのは仕様どおりです。下書きの初期には \nocite{*} を使うと、データベース内のすべてのエントリを、本文には何も出力せずに要求できます。
4 つ目に、コマンドを方式に合わせます。従来の BibTeX のドキュメントは、\bibliographystyle{...} と \bibliography{refs} で終わります。biblatex のドキュメントは、プリアンブルで \addbibresource{refs.bib} によってデータベースを読み込み、\printbibliography で出力します。両者を混ぜると、たとえば biblatex を読み込んでいるのに \bibliography を呼んでいると、まさにこの失敗が起こります。誤ったバックエンドを実行した場合も同じです。biblatex には biber が必要で、従来の bibtex に渡しても何も出力されません。
バックエンド自身のログを読む
バックエンドは問題点を、ドキュメントの隣にある .blg ファイルに書き出します。形式の崩れたエントリ、重複したキー、「I couldn’t open database file」というメッセージは、ここに現れます。上の手順が正しそうなのにリストがまだ空なら、.blg ログがほぼ確実に本当の原因を示しています。参考文献自体が表示されたあとも疑問符が残る場合は、引用に出る謎の疑問符を消すを参照してください。