Comment changer le style de la table des matières ?#

La mise en forme des entrées de la table des matières est contrôlée par un certain nombre de commandes internes (présentées à la section 2.3 du Companion), notamment les commandes :

  • \@pnumwidth qui contrôle l’espace laissé pour les numéros de page ;

  • \@tocrmarg qui contrôle l’indentation de la marge de droite ;

  • \@dotsep qui contrôle la séparation des points dans les pointillés ;

  • et la série des commandes nommées \l@xxx, où xxx est le nom d’un niveau de sectionnement (comme chapter, section…), qui contrôlent la mise en forme du titre correspondant, y compris l’espace pour les numéros de section.

L’extension layouts permet de visualiser ces définitions :

\documentclass[french]{article}
  \usepackage[T1]{fontenc}    % Encodage T1 (adapté au français)
  \usepackage{lmodern}        % Caractères plus lisibles
  \usepackage{babel}          % Réglages linguistiques (avec french)
  \pagestyle{empty}           % N'affiche pas de numéro de page
  \usepackage[a5paper]{geometry}
  \usepackage{layouts}

\begin{document}
\begin{figure}[h]
\setlayoutscale{0.6}
\tocdiagram
\caption{Paramètres d'une table des matières}
\end{figure}
\end{document}

Toutes ces commandes internes peuvent être redéfinies individuellement pour obtenir l’effet souhaité, en suivant les consignes de la question « Que font \makeatletter et \makeatother ? ».

Néanmoins, ce travail sur des commandes internes peut être évité en utilisant différentes extensions.

1.  Avec l’extension tocloft#

L’extension tocloft fournit un ensemble de commandes pouvant modifier facilement la mise en forme de la table des matières, autant pour les différentes dimensions utilisées que pour le style du texte.

L’exemple ci-dessous montre comment cette extension permet d’enlever les points de suspension des sous-sections et de décaler le numéro des sections et sous-sections. Il passe par la redéfinition de certaines variables proposées par l’extension :

\documentclass[french]{article}
  \usepackage[T1]{fontenc}    % Encodage T1 (adapté au français)
  \usepackage{lmodern}        % Caractères plus lisibles
  \usepackage{babel}          % Réglages linguistiques (avec french)
  \pagestyle{empty}           % N'affiche pas de numéro de page
  % Un correctif pour ne pas numéroter une page de table des matières
  \addtocontents{toc}{\protect\thispagestyle{empty}}
  \usepackage{tocloft}

  \renewcommand{\cftsecafterpnum}{\cftparfillskip}
  \renewcommand{\cftsubsecleader}{\hfill}
  \renewcommand{\cftsubsecafterpnum}{\cftparfillskip}

\begin{document}
\part{Vocabulaire}
\section{Ga}
\subsection{Bu}
\subsection{Zo}

\section{Meu}

\tableofcontents
\end{document}

Comme les mêmes mécanismes sont utilisés pour la liste des figures et la liste des tableaux, la mise en forme de ces tables peut être contrôlée de la même façon.

2.  Avec l’extension titletoc#

L’extension titletoc permet également de modifier la mise en page de la table des matières. Elle est peut-être un peu moins conviviale que tocloft, mais offre plus de possibilités. Elle est distribuée avec l’extension titlesec qui permet de redéfinir le style des commandes de sectionnement. Ceci explique pourquoi la documentation de titletoc se trouve à la fin de celle de titlesec.

L’exemple ci-dessous montre comment titletoc permet d’afficher toutes les sous-sous-sections de la table des matières sans retour à la ligne.

\documentclass[french]{article}
  \usepackage[T1]{fontenc}    % Encodage T1 (adapté au français)
  \usepackage{lmodern}        % Caractères plus lisibles
  \usepackage{babel}          % Réglages linguistiques (avec french)
  \pagestyle{empty}           % N'affiche pas de numéro de page
  \usepackage{titletoc}

  \titlecontents*{subsubsection}[2cm]
    {$\bullet$\space \itshape\small}
    {}{}{,~\thecontentspage}[ --- ][]

\begin{document}
\tableofcontents

\section{Ga}
\subsection{Bu}
\subsubsection{Bu long}
\subsubsection{Bu court}

\subsection{Zo}
\subsubsection{Zo rare}

\section{Meu}
\end{document}

À faire

Détailler \titlecontents*

3.  Avec l’extension etoc#

À faire

Ajouter des exemples sur toute la suite

L’extension etoc offre une flexibilité similaire, ainsi que la possibilité d’avoir des tables des matières multicolonnes et des encadrés autour des tables (et autres).

4.  Avec les classes KOMA-Script#

Les classes KOMA-Script fournissent si besoin une structure variable pour la table des matières et calculent automatiquement l’espace nécessaire pour les numéros.

5.  Avec la classe memoir#

La classe memoir inclut toutes les fonctionnalités de tocloft (elles sont toutes deux du même auteur).