25.1.4 \contentsline

Synopsis :

\contentsline{unit}{texte}{numéro-page}

Utilisé en interne par LaTeX pour composer un article dans une table des matières, table des figures, ou table des tableaux (voir Table of contents etc.). Les auteurs ne saisissent pas directement les commandes \contentsline.

En général l’ajout de matière à ces tables est fait automatiquement par les commandes \chapter, \section, etc. pour la table des matières, ou par la commande \caption au sein d’un environnement \figure ou \table (voir figure et voir table). Ainsi, en supposant que le fichier racine est these.tex, et qu’il contient la déclaration \tableofcontents, la commande \chapter{Chapitre premier} produit quelque chose de ce genre dans le fichier these.toc :

\contentsline {chapter}{\numberline {1}Chapitre premier}{3}

Si le fichier contient la déclaration \listoffigures alors un environnement figure comprenant \caption{Essai} produira quelque chose de ce genre dans these.lof.

\contentsline {figure}{\numberline {1.1}{\ignorespaces Essai}}{6}

x Pour ajouter manuellement de la matière, utilisez \addcontentsline{typefic}{unit}{\texte}, où typefic est toc, lof, ou lot (voir \addcontentsline).

Pour manipuler la façon dont la matière de la commande \contentline est composé, voir le paquetage tocloft.

Notez que le paquetage hyperref change la définition de \contentsline (et de \addcontentsline) pour ajouter plus d’arguments, fabriquer des hyperliens. C’est la source de l’erreur Argument of \contentsline has an extra } quand on ajoute/supprime l’utilisation d’hyperref et qu’une compilation a déjà été faite. Pour réparer cette erreur, détruisez les fichiers .toc, .lof ou .lot, et exécutez de nouveau LaTeX.