Table des matières, listes des figures, listes des tableaux
tableofcontents et pourquoi la deuxième passe compte.
Table des matières, listes des figures, listes des tableaux
En LaTeX, une table des matières n’est pas quelque chose que l’on construit ou que l’on entretient. Vous placez une seule commande là où vous la voulez, et LaTeX assemble les entrées à partir des titres que vous avez déjà écrits. Il en va de même pour la liste des figures et la liste des tableaux, qui rassemblent des légendes au lieu de titres. C’est l’un des endroits où déclarer la structure paie directement : renommez une section ou déplacez une figure et les pages liminaires se corrigent toutes seules.
Les trois commandes
\tableofcontents\listoffigures\listoftables\tableofcontents affiche la table des matières à l’endroit où elle apparaît, en général juste après la page de titre ou le résumé. Chaque \chapter, \section et \subsection numéroté y figure avec son numéro, son titre et sa page, jusqu’à la profondeur fixée par le compteur tocdepth décrit dans la leçon sur les titres. \listoffigures et \listoftables font de même pour les légendes des figures et des tableaux, en reprenant le texte de chaque \caption{...}. Dans les articles, elles sont rares, mais les thèses exigent souvent les deux, placées sur leurs propres pages après la table des matières.
Pourquoi la deuxième passe compte
Compilez deux fois après des changements de structure. Ce n’est pas de la superstition, c’est le fonctionnement même du mécanisme. Pendant une compilation, LaTeX ne peut pas savoir, page 2, ce qui se retrouvera page 47 ; il écrit donc au fur et à mesure chaque titre et son numéro de page final dans un fichier auxiliaire (.toc, .lof, .lot). \tableofcontents lit le fichier laissé par l’exécution précédente. Sur un projet neuf, ce fichier n’existe pas encore, donc la première compilation produit une table des matières vide. Après avoir ajouté ou déplacé des sections, la table affiche des titres périmés ou de mauvais numéros de page jusqu’à l’exécution suivante. La deuxième compilation lit le fichier fraîchement écrit et tout s’aligne. Les éditeurs qui lancent latexmk ou un outil équivalent gèrent les compilations supplémentaires à votre place, ce qui explique que vous ne l’ayez peut-être jamais remarqué. Si votre table des matières paraît fausse, compilez une fois de plus avant de chercher ailleurs.
Sections étoilées et table des matières
Les sections étoilées ont besoin de \addcontentsline{toc}{section}{Title} si elles doivent figurer dans la table des matières. Un titre étoilé comme \section*{Acknowledgments} évite volontairement à la fois la numérotation et le fichier des matières ; si vous voulez qu’il soit listé, vous ajoutez l’entrée vous-même. Les trois arguments de la commande sont le fichier où écrire (toc), le niveau de l’entrée (section) et le texte à afficher. Placez la ligne immédiatement après le titre étoilé pour que le numéro de page enregistré soit le bon.
Une habitude à prendre : avant de partager un PDF, jetez un œil à la table des matières pour y repérer les signes d’une compilation périmée, comme des points d’interrogation, des entrées manquantes ou une dernière entrée qui s’arrête avant votre dernier chapitre. Une compilation de plus suffit presque toujours à la guérir. La repérer vous-même coûte moins cher que de la laisser repérer par un relecteur. La même danse avec les fichiers auxiliaires fait fonctionner \ref et ses semblables, présentés dans les références croisées.