Pourquoi on compile plusieurs fois
Fichiers auxiliaires, passes de bibliographie, et pourquoi les références affichent ?? à la première exécution.
Pourquoi on compile plusieurs fois
Tôt ou tard, vous compilerez un document, ouvrirez le PDF et trouverez ?? là où devrait figurer un numéro de figure ou une citation. Rien n’est cassé. Une seule compilation est une seule passe sur votre fichier, et certaines informations ne peuvent tout simplement pas être connues en une seule passe.
Voici le problème en miniature. À la page 2, vous écrivez « voir Figure \ref{fig:results} », mais cette figure atterrit à la page 7. Quand le moteur compose la page 2, il n’a pas encore atteint la page 7 et ne peut donc pas savoir quel numéro la figure recevra. Il en va de même pour la table des matières, qui a besoin du numéro de page de chaque section avant même que la première page soit terminée.
Comment le moteur résout le problème
Un moteur LaTeX lit votre fichier .tex, résout chaque macro et écrit un PDF. À côté du PDF, il écrit aussi de petits fichiers auxiliaires : .aux pour les étiquettes et les citations, .toc pour la table des matières, .bbl pour la bibliographie mise en forme. Ces fichiers sont des notes que le moteur laisse à son futur lui-même.
- À la première passe, le moteur compose votre texte et écrit dans le fichier
.auxchaque\labelet chaque\citequ’il rencontre, en imprimant??partout où il lui faut un numéro qu’il ne connaît pas encore. - Si vous citez quoi que ce soit, un outil de bibliographie (bibtex ou biber) lit alors le fichier
.aux, cherche chaque citation dans votre base.bibet écrit la liste de références mise en forme dans un fichier.bbl. - À la deuxième passe, et parfois à la troisième, le moteur relit ces fichiers auxiliaires, de sorte que les références croisées, les entrées de la table des matières et les étiquettes de citation se résolvent enfin en vrais numéros.
Les configurations modernes lancent ces passes pour vous automatiquement, donc en pratique vous tapez rarement les commandes vous-même. Mais connaître le cycle explique le symptôme : un nouveau ?? après l’ajout d’une étiquette ou d’une citation signifie seulement que les fichiers auxiliaires n’ont pas encore rattrapé leur retard, et une compilation de plus règle le problème.
Les moteurs en une ligne chacun
Plusieurs programmes peuvent jouer le rôle de « moteur ». pdfLaTeX est le choix classique, avec la plus large prise en charge par les revues. XeLaTeX ajoute l’Unicode complet et permet d’utiliser les polices installées sur votre système. LuaLaTeX comprend aussi l’Unicode et embarque un langage de script pour les paquets avancés. Tectonic est un moteur moderne qui télécharge les paquets à la demande, la première fois que vous en avez besoin. Oleafly l’intègre pour qu’un nouveau projet se compile sans qu’il faille d’abord installer une distribution TeX.
Pour la plupart des documents, les différences comptent à peine : choisissez ce qu’attendent votre modèle ou la revue ou conférence visée, et passez à autre chose. Voir les moteurs comparés quand vous devez choisir délibérément.
Quand quelque chose échoue vraiment
Une compilation échouée déverse un long journal, et l’instinct naturel est de le lire de bas en haut. Résistez. Lisez la première erreur du journal et corrigez uniquement celle-là ; les erreurs suivantes sont très souvent du bruit en cascade causé par la première. Si les références affichent encore ?? après deux compilations réussies consécutives, le coupable habituel est une faute de frappe dans le nom du \label ou du \ref plutôt qu’une passe manquante.