Warum Sie mehr als einmal kompilieren

Aux-Dateien, Literaturdurchläufe und warum Verweise beim ersten Lauf als ?? erscheinen.

Warum Sie mehr als einmal kompilieren

Früher oder später kompilieren Sie ein Dokument, öffnen das PDF und finden ?? dort, wo eine Abbildungsnummer oder ein Zitat stehen sollte. Nichts ist kaputt. Eine einzelne Kompilierung ist ein einziger Durchlauf über Ihre Datei, und manche Informationen lassen sich in einem Durchlauf schlicht nicht kennen.

Hier das Problem im Kleinen. Auf Seite 2 schreiben Sie „siehe Abbildung \ref{fig:results}“, doch diese Abbildung landet auf Seite 7. Wenn die Engine Seite 2 setzt, hat sie Seite 7 noch nicht erreicht und weiß daher nicht, welche Nummer die Abbildung bekommt. Dasselbe gilt für das Inhaltsverzeichnis, das die Seitenzahl jedes Abschnitts braucht, bevor Seite eins überhaupt fertig ist.

Wie die Engine das löst

Eine LaTeX-Engine liest Ihre .tex-Datei, löst jedes Makro auf und schreibt ein PDF. Neben dem PDF schreibt sie außerdem kleine Hilfsdateien: .aux für Labels und Zitate, .toc für das Inhaltsverzeichnis, .bbl für das formatierte Literaturverzeichnis. Diese Dateien sind Notizen, die die Engine für ihr späteres Ich hinterlässt.

  1. Im ersten Durchlauf setzt die Engine Ihren Text und schreibt jedes \label und \cite, das ihr begegnet, in die .aux-Datei. Wo sie eine Nummer braucht, die sie noch nicht kennt, gibt sie ?? aus.
  2. Wenn Sie etwas zitieren, liest ein Literaturwerkzeug (bibtex oder biber) anschließend die .aux-Datei, sucht jedes Zitat in Ihrer .bib-Datenbank und schreibt das formatierte Literaturverzeichnis in eine .bbl-Datei.
  3. Im zweiten und manchmal dritten Durchlauf liest die Engine diese Hilfsdateien wieder ein, sodass Querverweise, Einträge im Inhaltsverzeichnis und Zitatmarken endlich zu echten Nummern aufgelöst werden.

Moderne Setups führen diese Durchläufe automatisch für Sie aus, daher tippen Sie die Befehle in der Praxis selten selbst. Doch der Zyklus erklärt das Symptom: Ein frisches ?? nach dem Hinzufügen eines Labels oder Zitats heißt nur, dass die Hilfsdateien noch nicht nachgezogen haben, und ein weiterer Kompilierlauf behebt es.

Die Engines in je einer Zeile

Mehrere Programme können die Rolle der „Engine“ übernehmen. pdfLaTeX ist die klassische Wahl mit der breitesten Unterstützung durch Zeitschriften. XeLaTeX bringt vollständiges Unicode mit und erlaubt es, auf Ihrem System installierte Schriftarten zu verwenden. LuaLaTeX versteht ebenfalls Unicode und enthält eine Skriptsprache für fortgeschrittene Pakete. Tectonic ist eine moderne Engine, die Pakete beim ersten Bedarf nachlädt. Oleafly bündelt sie, sodass ein neues Projekt kompiliert, ohne dass Sie zuerst eine TeX-Distribution installieren müssen.

Bei den meisten Dokumenten spielen die Unterschiede kaum eine Rolle; nehmen Sie, was Ihre Vorlage oder die Zeitschrift bzw. Konferenz erwartet, und arbeiten Sie weiter. Wenn Sie bewusst wählen müssen, lesen Sie Welche Engine für dieses Projekt.

Wenn tatsächlich etwas schiefgeht

Ein fehlgeschlagener Kompilierlauf wirft ein langes Log aus, und der natürliche Instinkt ist, es von unten nach oben zu lesen. Widerstehen Sie dem. Lesen Sie den ersten Fehler im Log und beheben Sie nur diesen; spätere Fehler sind sehr oft Folgerauschen, das der erste verursacht hat. Wenn Verweise nach zwei erfolgreichen Kompilierläufen in Folge weiterhin ?? ausgeben, ist meist ein Tippfehler im \label- oder \ref-Namen schuld und kein fehlender Durchlauf.

Zurück zu Die Schleife öffnen