Undefinierte Steuersequenz

Unbekannte Befehlsnamen: Tippfehler, fehlende Pakete, falsche Engine.

Undefinierte Steuersequenz

Das Symptom

Die Kompilierung bricht mit ! Undefined control sequence. ab. Das Log zeigt dann die Zeile, in der es passiert ist, in zwei Teile gebrochen: in einer Zeile alles, was TeX bis einschließlich des fehlerhaften Befehls gelesen hat, darunter den Rest der Quelltextzeile. Das letzte Token in der oberen Zeile ist der Befehl, den TeX nicht erkannt hat. Damit ist dies einer der Fehler, die sich leichter genau lokalisieren lassen.

Warum es passiert

Eine Steuersequenz ist alles, was mit einem Backslash beginnt. TeX hat kein festes Vokabular: Befehle gibt es nur, weil der Kernel, die Dokumentklasse, ein Paket oder Ihr eigenes \newcommand sie definiert hat. Liest TeX einen Backslash, gefolgt von einem Namen, den nichts definiert, kann es nicht erraten, was Sie meinten, und hält an. Der Fehler besagt nie, dass der Befehl ganz allgemein „falsch“ sei. Er besagt, dass dieser Name in diesem Dokument, an dieser Stelle und mit dieser Engine unbekannt ist.

In drei Prüfungen beheben

Prüfen Sie zuerst die Schreibweise. \texbf statt \textbf, \lable statt \label oder ein verirrtes Leerzeichen, das einen Namen in zwei Teile reißt, erklärt die meisten Fälle. Die Zeilennummer im Log führt Sie direkt zum Tippfehler.

Stimmt die Schreibweise, fehlt wahrscheinlich das Paket, das den Befehl definiert. \includegraphics tut ohne \usepackage{graphicx} nichts, \toprule braucht booktabs, und \SI braucht siunitx. Am häufigsten passiert das, wenn Sie ein Beispiel aus einem anderen Dokument oder aus der Antwort eines Modells kopieren: Der Text kam mit, die Zeile in der Präambel nicht. Welches Paket einen Befehl definiert, finden Sie in Jeder Befehl erklärt. Fügen Sie die Zeile \usepackage hinzu und kompilieren Sie neu. Ist das Paket selbst nicht installiert, lesen Sie Ein fehlendes Paket installieren.

Ist das Paket geladen und der Fehler bleibt, verdächtigen Sie die Engine. Manche Befehle gibt es nur unter einer bestimmten Engine: \fontspec und seine Verwandten brauchen XeLaTeX oder LuaLaTeX und scheitern unter pdfLaTeX mit genau diesem Fehler. Vorlagen, die in ihrer Dokumentation eine Engine nennen, tun das meist aus diesem Grund. Welche Engine für dieses Projekt erklärt die Unterschiede.

Zwei Eigenheiten, die man kennen sollte

Die Reihenfolge zählt: Ein Befehl, der vor der Zeile \usepackage benutzt wird, die ihn definiert, ist an dieser Stelle noch undefiniert. Laden Sie Pakete daher in der Präambel, oberhalb von \begin{document}. Und ein Fehler versteckt oft einen anderen, denn nachdem sich TeX gefangen hat, liest es womöglich alles Folgende falsch. Beheben Sie die erste undefinierte Steuersequenz im Log, kompilieren Sie neu und sehen Sie sich erst dann an, was übrig bleibt.

Zurück zu Protokollkompetenz