Des packages qui s'affrontent
hyperref en dernier, cleveref après, paires obsolètes, exemples minimaux.
Des packages qui s’affrontent
Les packages LaTeX sont libres de redéfinir les commandes des autres, et beaucoup le font délibérément. C’est ainsi que hyperref transforme chaque référence croisée en lien. Cela signifie aussi que deux packages peuvent chacun modifier la même commande avec des hypothèses incompatibles, et le résultat va d’une franche erreur comme Command \footnote already defined ou Option clash for package xcolor à un rendu silencieusement faux. Les conflits apparaissent presque toujours juste après l’ajout d’un package à un préambule qui fonctionnait jusque-là, ce qui est aussi le meilleur indice.
L’ordre de chargement fait la moitié du travail
De nombreux conflits se règlent uniquement par l’ordre, car le package chargé en dernier a le dernier mot. La règle la plus importante : chargez hyperref vers la fin du préambule. Il réécrit de larges pans du mécanisme de références croisées de LaTeX, et les packages chargés après lui risquent de défaire ces modifications. Une courte liste d’exceptions doit venir encore plus tard, et celle que vous rencontrerez réellement est cleveref, conçu pour se placer par-dessus hyperref et qui doit être chargé après lui :
\usepackage{graphicx}\usepackage{amsmath}% ... everything else ...\usepackage{hyperref}\usepackage{cleveref} % after hyperref, by designQuand la documentation d’un package précise une position par rapport à un autre package, croyez-la. Ces notes existent parce que quelqu’un a déjà rencontré le conflit que vous êtes sur le point d’avoir.
Packages obsolètes et leurs remplaçants
Certains conflits viennent du chargement d’un package mort à côté de son successeur. Ne combinez pas epsfig avec graphicx, subfigure avec subcaption, ni les vieux raccourcis times et mathptmx avec des packages de polices modernes comme newtxtext. Les anciens modèles en sont la source habituelle : ils chargent ce qui était d’actualité au moment de leur écriture, et vous ajoutez l’équivalent moderne par-dessus. Retirez l’obsolète et gardez le remplaçant. Le package nag peut signaler pour vous les usages périmés au moment de la compilation.
Conflits d’options
Option clash for package X signifie que le package a été chargé deux fois avec des options différentes, souvent une fois par votre classe de document dans votre dos. Vous ne pouvez pas le recharger avec de nouvelles options, mais vous pouvez injecter des options avant que quiconque le charge : placez \PassOptionsToPackage{table}{xcolor} avant \documentclass, et les options sont fusionnées dans le premier chargement qui survient.
Isoler le problème avec un exemple minimal
Quand la cause n’est pas évidente, construisez un exemple minimal fonctionnel : un document contenant seulement \documentclass, les deux packages suspects et un \begin{document}...\end{document} avec une ligne de texte. Si l’erreur se reproduit, changez l’ordre de chargement et les options jusqu’à ce qu’elle disparaisse. Si elle ne se reproduit pas, rajoutez vos autres packages par moitiés jusqu’à ce qu’elle revienne. Cette recherche dichotomique converge en quelques compilations et vous donne une paire claire sur laquelle chercher. La même technique sauve les préambules hérités, comme le décrit Fichiers de classe d’université qui ne compilent pas.