Pakete, die sich bekämpfen

hyperref zuletzt, cleveref danach, veraltete Paare, minimale Beispiele.

Pakete, die sich bekämpfen

LaTeX-Pakete dürfen die Befehle anderer Pakete frei neu definieren, und viele tun das bewusst. So macht hyperref aus jedem Querverweis einen Link. Es bedeutet aber auch, dass zwei Pakete denselben Befehl mit unvereinbaren Annahmen ändern können. Das Ergebnis reicht von einem offenen Fehler wie Command \footnote already defined oder Option clash for package xcolor bis zu stillschweigend falscher Ausgabe. Konflikte treten fast immer unmittelbar auf, nachdem Sie einer zuvor funktionierenden Präambel ein Paket hinzugefügt haben, und das ist auch der größte Hinweis.

Die Ladereihenfolge ist die halbe Miete

Viele Konflikte lösen sich allein durch die Reihenfolge, denn das später geladene Paket hat das letzte Wort. Die wichtigste Regel: Laden Sie hyperref gegen Ende der Präambel. Es schreibt große Teile der Querverweismechanik von LaTeX um, und Pakete, die danach geladen werden, können diese Änderungen rückgängig machen. Eine kurze Liste von Ausnahmen muss noch später kommen, und die einzige, der Sie wirklich begegnen werden, ist cleveref. Es ist dafür gebaut, auf hyperref aufzusetzen, und muss danach geladen werden:

\usepackage{graphicx}
\usepackage{amsmath}
% ... everything else ...
\usepackage{hyperref}
\usepackage{cleveref} % after hyperref, by design

Wenn die Dokumentation eines Pakets eine Position relativ zu einem anderen Paket nennt, vertrauen Sie ihr. Diese Hinweise gibt es, weil jemand schon auf den Konflikt gestoßen ist, der Ihnen gleich bevorsteht.

Veraltete Pakete und ihre Nachfolger

Manche Konflikte entstehen, wenn ein totes Paket neben seinem Nachfolger geladen wird. Kombinieren Sie nicht epsfig mit graphicx, subfigure mit subcaption oder die alten Notbehelfe times und mathptmx mit modernen Schriftpaketen wie newtxtext. Alte Vorlagen sind die übliche Quelle: Sie laden, was zur Entstehungszeit der Vorlage aktuell war, und Sie setzen das moderne Gegenstück obendrauf. Entfernen Sie das veraltete Paket und behalten Sie den Nachfolger. Das Paket nag kann veraltete Verwendung beim Kompilieren für Sie anzeigen.

Optionskonflikte

Option clash for package X bedeutet, dass das Paket zweimal mit unterschiedlichen Optionen geladen wurde, oft einmal von Ihrer Dokumentklasse hinter Ihrem Rücken. Sie können es nicht noch einmal mit neuen Optionen laden, aber Sie können Optionen einschleusen, bevor jemand es lädt: Setzen Sie \PassOptionsToPackage{table}{xcolor} vor \documentclass, dann werden die Optionen in den Ladevorgang übernommen, der zuerst kommt.

Mit einem Minimalbeispiel eingrenzen

Ist die Ursache nicht offensichtlich, bauen Sie ein minimales Beispiel: ein Dokument, das nur \documentclass, die beiden verdächtigen Pakete und ein \begin{document}...\end{document} mit einer Textzeile enthält. Tritt der Fehler auf, ändern Sie Ladereihenfolge und Optionen, bis er verschwindet. Tritt er nicht auf, nehmen Sie Ihre übrigen Pakete halbweise wieder hinzu, bis er zurückkehrt. Diese binäre Suche konvergiert in wenigen Kompilierungen und liefert ein klares Paar, nach dem Sie suchen können. Dieselbe Technik rettet geerbte Präambeln, wie unter Universitätsklassen, die nicht kompilieren beschrieben.

Zurück zu Laufzeit