Klassendateien von Hochschulen, die sich nicht kompilieren lassen

Sichtung: erster Fehler, Engine, veraltete Pakete, Halbierungssuche.

Klassendateien von Hochschulen, die sich nicht kompilieren lassen

Hochschulvorlagen für Abschlussarbeiten sind eine besondere Art von Altlast. Vor fünfzehn Jahren schrieb ein Doktorand die Klassendatei für die damalige TeX-Distribution, schloss sein Studium ab und ließ sie unverändert, während sich das LaTeX-Ökosystem weiterentwickelte. Wenn Sie universitythesis.cls heute herunterladen und es mit einem Bildschirm voller Fehler abbricht, ist die Klasse meist nicht so sehr kaputt, sondern in der Zeit gestrandet. Die Fehlerbilder sind aber vorhersehbar, und eine feste Reihenfolge bei der Sichtung löst die meisten davon.

Beginnen Sie nur mit dem ersten Fehler

Ein LaTeX-Fehler zieht Folgefehler nach sich: Ein einziger undefinierter Befehl früh in der Klasse kann Dutzende nachgelagerter Fehler auslösen, die nichts bedeuten. Scrollen Sie im Log zur ersten Zeile, die mit ! beginnt, beheben Sie diesen Fehler und kompilieren Sie neu, bevor Sie irgendetwas anderes lesen. Wiederholen Sie diese Schleife, und eine einschüchternde Wand aus Fehlern ist oft nach drei oder vier Durchgängen verschwunden. Ist der erste Fehler ein unbekannter Befehl, führt Undefined control sequence durch die Diagnose.

Prüfen Sie die Engine

Viele Vorlagen setzen eine bestimmte Engine voraus und scheitern mit jeder anderen auf merkwürdige Weise. Eine Klasse, die fontspec lädt oder Schriften per Namen setzt, braucht XeLaTeX oder LuaLaTeX. Eine Klasse, die auf pdftex-spezifischen Primitiven aufbaut, kann unter beiden scheitern. Suchen Sie oben in der Klassendatei nach einem Kommentar oder in den Vorgaben der Hochschule nach einer Zeile, die die vorgesehene Engine nennt, und stellen Sie sie ein, bevor Sie irgendetwas anderes debuggen. Die Unterschiede fasst Welche Engine für dieses Projekt zusammen.

Modernisieren Sie, was Sie selbst in der Hand haben

Alte Vorlagen laden veraltete Pakete, deren moderne Nachfolger bereits in Ihrer Distribution stecken, und beide geraten dann aneinander. Pakete, die sich gegenseitig stören listet die klassischen Kombinationen auf. Praktikabel ist es, die Klassendatei selbst in Ruhe zu lassen, da dort die Formatvorgaben der Hochschule stecken, und nur Ihre eigene Präambel zu modernisieren: Entfernen Sie veraltete \usepackage-Zeilen, laden Sie hyperref spät und vermeiden Sie es, etwas erneut zu laden, was die Klasse schon lädt.

Halbieren Sie die Präambel

Widersteht der Fehler der Untersuchung, kommentieren Sie die zweite Hälfte Ihrer Präambel aus und kompilieren Sie neu. Verschwindet der Fehler, liegt der Auslöser in der auskommentierten Hälfte. Nehmen Sie die Hälfte davon wieder hinein und wiederholen Sie das. Mit wenigen Kompilierungen ist die eine fehlerhafte Zeile eingegrenzt, und das geht viel schneller, als über eine Präambel nachzudenken, die Sie nicht geschrieben haben.

Suchen Sie, bevor Sie leiden

Jeder Student an dieser Hochschule kompiliert dieselbe Klasse, also ist Ihr Fehler mit ziemlicher Sicherheit schon einmal aufgetreten. Suchen Sie nach der genauen Fehlermeldung zusammen mit dem Namen der Klassendatei und prüfen Sie, ob die Hochschule oder ein Nachfolger einen gepatchten Fork auf GitHub pflegt. Ein gepflegter Fork, falls es einen gibt, ist besser, als bekannte Fehler noch einmal selbst zu beheben.

Zurück zu Lange Form