空の参考文献

症状

文書は致命的なエラーなしでコンパイルされますが、「参考文献」セクションが完全に欠落しているか、見出しの下に何も表示されません。多くの場合、テキスト内のすべての「\cite」は同時に太字の疑問符として表示されます。何もクラッシュしていないため、追跡すべき明らかなエラーがないため、これがイライラさせられます。

なぜそれが起こるのか

参考文献目録は LaTeX だけで作成されるものではありません。 LaTeX はまず、引用されたキーのリストを補助ファイルに書き込みます。別のバックエンド プログラム (bibtex または biber) が .bib データベースを読み取り、一致するエントリをフォーマットします。最後に、LaTeX はそのフォーマットされた結果を次のパスで読み取ります。空の参考文献は、このパイプラインがどこかで壊れたことを意味します。バックエンドが実行されなかった、実行されたがデータベースが見つからなかった、データベースは見つかったがキーが要求されなかった、またはドキュメントが間違ったコマンドで結果を要求していることを意味します。

原因を順番に解決します

まず、ドキュメントに記載されている場所にデータベース ファイルが存在することを確認します。 \bibliography{refs} と \addbibresource{refs.bib} はどちらもメイン ファイルを基準にして refs.bib を検索するため、bib/ サブフォルダーにあるファイルは bib/refs または bib/refs.bib として参照する必要があります。間違った道は静かに失敗します。

次に、バックエンドが実際に実行されていることを確認します。 1 回のコンパイルだけでは決して十分ではありません。全サイクルは LaTeX、次に bibtex または biber、そしてさらに 2 回 LaTeX です。 Oleafly はこのサイクルを自動的に実行しますが、手動でビルドしたり、エディター ツールチェーンが正しく設定されていないと、中間のステップがスキップされ、その結果、まさに空の参照リストが作成される可能性があります。

3 番目に、少なくとも 1 つの \cite コマンドが存在することを確認します。バックエンドはドキュメントが要求するエントリのみをフォーマットするため、引用のないドラフトは設計上空のリストを取得します。草稿の初期段階では、\nocite{*} を使用してすべてを強制的に組み込むことができます。これにより、テキストには何も出力せずにデータベース内のすべてのエントリが要求されます。

4 番目に、コマンドをシステムに合わせます。従来の BibTeX 文書は \bibliographystyle{...} と \bibliography{refs} で終わります。 biblatex ドキュメントは、\addbibresource{refs.bib} を使用してプリアンブル内のデータベースをロードし、\printbibliography を使用して印刷します。この 2 つを混在させると、たとえば biblatex をロードしながら \bibliography を呼び出すと、まさにこのエラーが発生します。間違ったバックエンドを実行する場合も同様です。biblatex には biber が必要ですが、従来の bibtex を入力しても何も生成されません。

バックエンド自身のログを読み取る

バックエンドは苦情をドキュメントの隣にある .blg ファイルに書き込み、そこに不正なエントリ、重複キー、および「データベース ファイルを開けませんでした」メッセージが表示されます。上記の手順は正しく行われているように見えても、リストがまだ空である場合、.blg ログにはほとんどの場合、真の原因が記載されています。参考文献自体が表示された後も残る疑問符については、謎の引用符のクリア を参照してください。