Leeres Literaturverzeichnis

Pfad, Backend, fehlendes Zitat, printbibliography statt bibliography.

Leeres Literaturverzeichnis

Das Symptom

Ihr Dokument kompiliert ohne schwerwiegenden Fehler, aber der Abschnitt mit dem Literaturverzeichnis fehlt ganz, oder die Überschrift erscheint ohne jeden Eintrag darunter. Oft zeigt sich gleichzeitig jedes \cite im Text als fettes Fragezeichen. Nichts ist abgestürzt, es gibt also keine offensichtliche Fehlermeldung, der man nachgehen könnte, und genau das macht diesen Fall so lästig.

Warum es passiert

Das Literaturverzeichnis entsteht nicht allein durch LaTeX. Zuerst schreibt LaTeX die Liste der zitierten Schlüssel in eine Hilfsdatei. Ein separates Backend-Programm (bibtex oder biber) liest Ihre .bib-Datenbank und formatiert die passenden Einträge. Zuletzt liest LaTeX dieses formatierte Ergebnis im nächsten Durchlauf wieder ein. Ein leeres Literaturverzeichnis bedeutet, dass diese Kette an irgendeiner Stelle gerissen ist: Das Backend ist nie gelaufen, es ist gelaufen, hat die Datenbank aber nicht gefunden, es hat die Datenbank gefunden, aber keine Schlüssel angefordert bekommen, oder das Dokument fordert das Ergebnis mit dem falschen Befehl an.

Die Ursachen der Reihe nach prüfen

Prüfen Sie zuerst, ob die Datenbankdatei dort liegt, wo das Dokument sie erwartet. \bibliography{refs} und \addbibresource{refs.bib} suchen beide nach refs.bib relativ zur Hauptdatei, eine Datei in einem Unterordner bib/ muss also als bib/refs beziehungsweise bib/refs.bib angegeben werden. Ein falscher Pfad scheitert stillschweigend.

Stellen Sie zweitens sicher, dass das Backend wirklich gelaufen ist. Ein einzelner Kompilierlauf reicht nie; der vollständige Ablauf ist LaTeX, dann bibtex oder biber, dann LaTeX noch zweimal. Oleafly verwaltet die Durchläufe für Sie; wählen Sie für ein Biber-Projekt TinyTeX oder eine System-TeX-Engine. Ein von Hand gesteuerter Build oder eine falsch konfigurierte Werkzeugkette im Editor kann aber den mittleren Schritt auslassen, und das Ergebnis ist genau eine leere Literaturliste.

Prüfen Sie drittens, ob mindestens ein \cite-Befehl vorhanden ist. Das Backend formatiert nur Einträge, die das Dokument anfordert, ein Entwurf ohne Zitate bekommt also von Natur aus eine leere Liste. Während der frühen Entwurfsphase können Sie mit \nocite{*} alles hineinzwingen: Der Befehl fordert jeden Eintrag der Datenbank an, ohne im Text etwas auszugeben.

Passen Sie viertens den Befehl an das System an. Klassische BibTeX-Dokumente enden mit \bibliographystyle{...} und \bibliography{refs}. biblatex-Dokumente laden die Datenbank in der Präambel mit \addbibresource{refs.bib} und geben sie mit \printbibliography aus. Wer beides mischt, etwa biblatex lädt, aber trotzdem \bibliography aufruft, löst genau diesen Fehler aus. Dasselbe gilt für das falsche Backend: biblatex braucht biber, und wenn man ihm das klassische bibtex vorsetzt, kommt nichts heraus.

Das Protokoll des Backends lesen

Das Backend schreibt seine Beschwerden in eine .blg-Datei neben Ihrem Dokument. Dort tauchen fehlerhafte Einträge, doppelte Schlüssel und Meldungen wie „I couldn’t open database file“ auf. Wenn die obigen Schritte stimmen und die Liste trotzdem leer bleibt, nennt das .blg-Protokoll fast immer den eigentlichen Übeltäter. Falls Fragezeichen bleiben, obwohl das Literaturverzeichnis selbst erscheint, lesen Sie Rätselhafte Fragezeichen bei Zitaten beseitigen.

Zurück zu Protokollkompetenz