謎の引用マークを消す

タイプミス、実行回数の不足、誤ったパス、BibTeX と Biber の不一致。

謎の引用マークを消す

症状

文書はコンパイルできるのに、引用が表示されるはずの場所に太字の疑問符 [?] が出て、ログには LaTeX Warning: Citation 'knuth84' undefined のような行が含まれます。すべての引用に出ることもあれば、1、2 個だけのこともあります。エラーではなく警告なので PDF は作られ、読者に指摘されるまでマークに気づきにくいものです。

原因

LaTeX は引用を直接は解決しません。最初の実行で、要求された各キーを補助ファイルに記録します。次にバックエンドのプログラム (bibtex または biber) が、そのキーを .bib データベースから探し、整形したエントリーを書き出します。さらに 2 回 LaTeX を実行して結果を取り込みます。疑問符は、最後の実行の時点で、そのキーに対する整形済みのエントリーが存在しなかったことを意味します。この症状の原因はすべて、このパイプラインを壊す何らかの方法です。

原因を順番に調べる

まず、キーそのものを確認します。\cite{knuth84} と @article{knuth1984,...} は別の文字列で、一致は大文字小文字も含めて厳密です。警告に出ているキーを .bib ファイルで検索してください。どちらか一方のタイプミスが最もよくある原因で、ログに最初に出るキー欠落の警告から追いかけます。

次に、コンパイルのサイクル全体が実行されたかを確認します。順序は LaTeX、次に bibtex または biber、さらに LaTeX を 2 回です。1 回のコンパイルだけでは、バックエンドがまだ実行されていないため、引用は決して解決されません。Oleafly はビルドの実行回数を管理します。参考文献に Biber が必要な場合は TinyTeX かシステムの TeX エンジンを使ってください。ただし、手動のビルドや誤った設定のエディタは、1 回目の実行で止まることがあります。

3 つ目に、データベースのパスを確認します。\bibliography{refs} と \addbibresource{refs.bib} はメインファイルからの相対パスで解決されるので、サブフォルダ内のデータベースは bib/refs または bib/refs.bib と書く必要があります。誤ったパスは静かに失敗し、たいていは参考文献リスト全体も道連れになります。その大きな失敗については、参考文献が空になるを参照してください。

最後に、バックエンドをシステムに合わせます。biblatex を読み込む文書は biber で処理しなければなりません。従来の bibtex に渡しても使える出力は得られず、何度再コンパイルしても、すべての引用が疑問符のままです。

どうしてもだめなら

古い補助ファイルが、壊れた古い状態を保持していることがあります。文書の隣にある .aux、.bbl、.blg のファイルを削除して、最初からビルドし直してください。.blg ファイルは、削除する前に読む価値もあります。これはバックエンド自身のログで、見つからないデータベースや不正な形式のエントリーを、はっきり名指ししてくれます。

出典を引用する に戻る