Des fichiers de classe d'université qui ne compilent pas
Triage : première erreur, moteur, packages obsolètes, recherche dichotomique.
Des fichiers de classe d’université qui ne compilent pas
Les modèles de thèse universitaires sont une forme particulière de code hérité. Un doctorant a écrit le fichier de classe il y a quinze ans pour la distribution TeX de l’époque, a soutenu sa thèse et l’a laissé figé pendant que l’écosystème LaTeX évoluait. Quand vous téléchargez aujourd’hui universitythesis.cls et qu’il plante avec un écran d’erreurs, la classe n’est généralement pas tant cassée que restée figée dans le temps. Les modes de défaillance sont cependant prévisibles, et un ordre de diagnostic fixe en résout la plupart.
Commencez uniquement par la première erreur
Un échec LaTeX se propage en cascade : une commande non définie au début de la classe peut produire des dizaines d’erreurs en aval qui ne signifient rien. Faites défiler le journal jusqu’à la première ligne qui commence par !, corrigez-la et recompilez avant de lire quoi que ce soit d’autre. Répéter cette boucle vient souvent à bout d’un mur d’erreurs intimidant en trois ou quatre passes. Si la première erreur est une commande inconnue, Undefined control sequence détaille le diagnostic.
Vérifiez le moteur
Beaucoup de modèles supposent un moteur précis et échouent de façon étrange avec tout autre. Une classe qui charge fontspec ou choisit les polices par leur nom exige XeLaTeX ou LuaLaTeX ; une classe construite autour de primitives propres à pdftex peut échouer avec les deux. Cherchez un commentaire en haut du fichier de classe, ou une ligne dans les instructions de l’université, qui nomme le moteur prévu, et alignez-vous dessus avant de déboguer quoi que ce soit d’autre. Les différences sont résumées dans Quel moteur pour ce projet.
Modernisez ce que vous contrôlez
Les vieux modèles chargent des packages obsolètes dont les remplaçants modernes sont déjà dans votre distribution, et les deux se battent alors ; Des packages qui se battent entre eux liste les combinaisons classiques. La stratégie praticable consiste à ne pas toucher au fichier de classe lui-même, puisque les exigences de mise en forme de l’université s’y trouvent, et à moderniser seulement votre propre préambule : supprimez les lignes \usepackage obsolètes, chargez hyperref en dernier et évitez de recharger ce que la classe charge déjà.
Recherche dichotomique dans le préambule
Quand l’erreur résiste à l’inspection, mettez en commentaire la seconde moitié de votre préambule et recompilez. Si l’erreur disparaît, le déclencheur se trouve dans la moitié commentée ; rétablissez-en la moitié et recommencez. Une poignée de compilations isole l’unique ligne fautive, ce qui est bien plus rapide que de raisonner sur un préambule que vous n’avez pas écrit.
Cherchez avant de souffrir
Chaque étudiant de cette université compile la même classe : votre erreur a donc presque certainement déjà été rencontrée. Cherchez le message d’erreur exact avec le nom du fichier de classe, et vérifiez si l’université ou un étudiant successeur maintient sur GitHub un fork corrigé. Utiliser un fork maintenu, quand il existe, vaut mieux que de corriger soi-même des bogues déjà connus.