Table des matières et renvois

Dans un mémoire, tu écris sans cesse des phrases comme « voir la section 3.2 » ou « comme le montre la figure 4 ». Si tu tapes ces numéros à la main, ils deviennent faux dès que tu ajoutes une section ou que tu déplaces une figure. Dans cette leçon, tu vas laisser LaTeX gérer tous les numéros. Tu vas générer la table des matières et les listes de figures et de tableaux, poser des étiquettes et y renvoyer, puis rendre tout cela cliquable dans le PDF. C'est l'un des plus gros gains de temps de LaTeX.

La table des matières tient en une commande : tableofcontents, placée là où tu veux la voir, en général après le résumé. LaTeX la remplit avec tes titres de chapitres et de sections, et leurs numéros de page. Les commandes listoffigures et listoftables font la même chose pour les figures et les tableaux. Comme LaTeX ne connaît les numéros de page qu'après avoir composé le document, il lui faut deux compilations : la première note les titres, la deuxième les affiche. Si ta table descend trop dans le détail, le compteur tocdepth limite la profondeur, par exemple aux chapitres et aux sections.

Pour renvoyer vers un élément, tu poses d'abord une étiquette juste après lui, avec la commande label et un nom de ton choix. Ensuite, partout dans le texte, la commande ref affiche son numéro, et pageref le numéro de sa page. Pour une équation, la commande eqref de amsmath ajoute les parenthèses. Remarque le tilde entre le mot section et la commande ref : il empêche que le numéro parte seul au début de la ligne suivante. Si tu ajoutes un chapitre au début du mémoire, tous les numéros se mettent à jour à la compilation suivante, sans que tu touches à une seule phrase.

Donne à tes étiquettes des noms clairs, avec un préfixe qui dit le type d'élément : chap pour un chapitre, sec pour une section, fig pour une figure, tab pour un tableau, eq pour une équation. Après le préfixe, un mot qui décrit le contenu, comme fig, deux-points, montage. Au bout de trois mois, tu sauras encore à quoi correspond chaque étiquette. Évite les noms comme figure1 : si la figure change de place, le nom devient trompeur. Chaque étiquette doit être unique. Si tu en utilises deux fois la même, LaTeX le signale dans le journal par l'avertissement « multiply defined », et tes renvois risquent de pointer au mauvais endroit.

Pour les annexes, une seule commande suffit : appendix. Après elle, chaque chapitre est numéroté avec une lettre, et babel écrit bien le mot « Annexe ». Tu peux y renvoyer exactement comme vers un chapitre. Avec la classe book, trois commandes découpent le livre : frontmatter pour les pages préliminaires, numérotées en chiffres romains et sans numéros de chapitre, mainmatter pour le corps du texte, et backmatter pour la fin. Avec la classe report, tu obtiens un effet proche en changeant le style de numérotation des pages avec la commande pagenumbering. Hassan, à Casablanca, s'en sert pour ses remerciements et son résumé.

L'extension hyperref transforme ton PDF en document navigable. Chaque ligne de la table des matières devient un lien vers la bonne page, chaque renvoi vers la figure ou la section concernée, chaque citation vers la bibliographie. Ton jury, qui lit souvent le mémoire à l'écran, apprécie beaucoup. Charge hyperref en général parmi les dernières extensions du préambule, car elle modifie le travail de beaucoup d'autres. Elle fournit aussi la commande href, pour un lien web avec un texte, et url, pour afficher une adresse complète. Si les cadres colorés autour des liens te gênent, l'option hidelinks les retire, ce qui est plus sobre à l'impression.

Retiens que la table des matières et les listes de figures et de tableaux se fabriquent seules, en deux compilations. Pose une étiquette juste après chaque élément important, et utilise ref ou pageref à la place de tout numéro tapé à la main, avec un tilde devant. Nomme tes étiquettes avec un préfixe clair et ne les réutilise jamais. Enfin, charge hyperref pour que ton jury navigue dans le PDF d'un clic. Dans la prochaine leçon, on s'occupe de ce que le jury voit en premier : la page de titre, le résumé et la mise en page générale.