25.1.3 \addtocontents

Synopsis :

\addtocontents{ext}{texte}

Ajoute texte, qui peut être du texte ou des commandes de formatage, directement au fichier auxiliaire dont le nom a l’extension .ext. Cela est utilisé d’ordinaire pour la table des matières, mais aussi pour la liste des figures ou celle des tableaux.

L’exemple suivant place un peu d’espace vertical dans la table des matières après l’en-tête ‘Table des matières’ :

\tableofcontents\newpage
\addtocontents{toc}{\protect\vspace*{3ex}}

L’exemple suivant place le mot ‘page’, en caractères gras, au dessus de la colonne des numéros de page après l’en-tête.

\tableofcontents
\addtocontents{toc}{~\hfill\textbf{page}\par}
\chapter{...}

L’exemple ci-dessous ajoute une ligne annonçant l’œuvre d’un nouvel auteur :

\addtocontents{toc}{%
  \protect\vspace{2ex}
  \textbf{Chapitres de N. Autre Auteur}\par}

La différence entre \addtocontents et \addcontentsline est que cette dernière commande est strictement réservée aux lignes, comme le cas d’une ligne donnant le numéro de page pour le début d’un nouveau sous-ensemble des chapitres. Comme les exemples ci-dessus le démontrent, \addtocontents permet de la matière telle que de l’espacement.

La commande \addtocontents a deux arguments, tous deux obligatoires.

ext

Typiquement l’un parmi : toc pour la table des matières, lof por la liste des figures, ou lot pour la liste des tableaux. L’extension de nom de fichier du fichier dans lequel l’information est à écrire.

texte

Le texte, et possiblement les commandes, à écrire.

Les commandes de rubricage telles que \chapter utilisent la commande \addcontentsline pour stocker l’information. Cette commande crée des lignes dans le fichier auxiliaire en .toc qui contient les commandes \contentsline (voir \addcontentsline). Contrairement à elle, la commande \addtocontents place directement la matière dans ce fichier.

La commande \addtocontents interagit avec \include (voir \include & \includeonly). Si vous les utilisez au même niveau, comme dans \addtocontents{...}{...}\include{...} alors les lignes de la table des matières risquent de sortir dans le mauvais ordre. La solution est de déplacer \addtocontents pour la mettre dans le fichier à inclure.