Rätselhafte Fragezeichen bei Zitaten beseitigen

Tippfehler, fehlende Durchläufe, falscher Pfad, BibTeX und Biber passen nicht zusammen.

Rätselhafte Fragezeichen bei Zitaten beseitigen

Das Symptom

Das Dokument kompiliert, aber dort, wo ein Zitat stehen sollte, erscheint ein fettes Fragezeichen, [?], und das Log enthält Zeilen wie LaTeX Warning: Citation 'knuth84' undefined. Manchmal sind alle Zitate betroffen, manchmal nur eines oder zwei. Weil dies eine Warnung und kein Fehler ist, wird das PDF trotzdem erzeugt, und die Marken sind leicht zu übersehen, bis ein Leser sie anmerkt.

Warum es passiert

LaTeX löst Zitate nicht direkt auf. Im ersten Durchlauf trägt es jeden angeforderten Schlüssel in eine Hilfsdatei ein. Ein Backend-Programm (bibtex oder biber) schlägt diese Schlüssel dann in Ihrer .bib-Datenbank nach und schreibt formatierte Einträge. Zwei weitere LaTeX-Durchläufe arbeiten die Ergebnisse wieder ein. Ein Fragezeichen bedeutet, dass im Moment des letzten Durchlaufs für diesen Schlüssel kein formatierter Eintrag existierte. Jede Ursache dieses Symptoms ist eine Möglichkeit, diese Pipeline zu unterbrechen.

Die Ursachen der Reihe nach durchgehen

Prüfen Sie zuerst den Schlüssel selbst. \cite{knuth84} und @article{knuth1984,...} sind verschiedene Zeichenketten, und der Abgleich ist exakt, Groß- und Kleinschreibung eingeschlossen. Suchen Sie in Ihrer .bib-Datei nach dem Schlüssel aus der Warnung; ein Tippfehler auf einer der beiden Seiten ist der häufigste Übeltäter, und die erste Warnung über einen fehlenden Schlüssel im Log ist die, der Sie nachgehen sollten.

Stellen Sie als Nächstes sicher, dass der vollständige Kompilierzyklus gelaufen ist. Die Abfolge ist LaTeX, dann bibtex oder biber, dann noch zweimal LaTeX. Eine einzelne Kompilierung kann Zitate nie auflösen, weil das Backend noch nicht gelaufen ist. Oleafly verwaltet die Build-Durchläufe; verwenden Sie TinyTeX oder eine TeX-Engine des Systems, wenn das Literaturverzeichnis Biber verlangt, aber ein manueller Build oder ein falsch konfigurierter Editor kann nach dem ersten Durchlauf stehen bleiben.

Prüfen Sie drittens den Pfad zur Datenbank. \bibliography{refs} und \addbibresource{refs.bib} werden relativ zur Hauptdatei aufgelöst, daher muss eine Datenbank in einem Unterordner als bib/refs oder bib/refs.bib geschrieben werden. Ein falscher Pfad schlägt still fehl und reißt meist das gesamte Literaturverzeichnis mit; für diesen größeren Fehler siehe Leeres Literaturverzeichnis.

Passen Sie schließlich das Backend an das verwendete System an. Ein Dokument, das biblatex lädt, muss mit biber verarbeitet werden. Füttert man es mit dem klassischen bibtex, entsteht keine brauchbare Ausgabe, und jedes Zitat bleibt ein Fragezeichen, egal wie oft Sie neu kompilieren.

Wenn alles andere scheitert

Veraltete Hilfsdateien können an einem alten, defekten Zustand festhalten. Löschen Sie die Dateien .aux, .bbl und .blg neben Ihrem Dokument und bauen Sie von Grund auf neu. Die Datei .blg ist auch lesenswert, bevor Sie sie löschen: Sie ist das eigene Log des Backends und benennt fehlende Datenbanken und fehlerhafte Einträge ausdrücklich.

Zurück zu Zitieren Sie Ihre Quellen