Différences

Ci-dessous, les différences entre deux révisions de la page.

--- composition:annexes:tables:generer_une_table_des_matieres [2018/12/09 09:26] – jejust
+++ 3_composition:annexes:tables:generer_une_table_des_matieres [2021/10/09 10:31] (Version actuelle) – Ajout d'exemples, de précisions et de liens. yannick.tanguy
@@ Ligne 1: / Ligne 1: @@
 ====== Comment générer une table des matières? ======
+<latex>\LaTeX</latex> fournit la commande ''\tableofcontents'', qui affiche la table des matières à l'endroit où elle est appelée. À chaque compilation, si la commande ''\tableofcontents'' est présente dans le document,
+  * <latex>\LaTeX</latex> crée un fichier ''.toc'' dans lequel il place tous les renseignements nécessaires (niveau de sectionnement (par exemple un chapitre, une section), numéro, titre, page) ;
+  * le fichier ''.toc'' est par la suite inclus à l'endroit où est appelée la commande ''\tableofcontents''.
-$\Reponse$  <latex>\LaTeX</latex> fournit la commande ''tableofcontents'', qui affiche la
+En général, il est donc nécessaire de faire trois compilations pour avoir une table des matières à jour :
-table des matières à l'endroit où elle est appelée.
+  * la première créera le fichier ''.toc'' ;
-À chaque compilation, si la commande ''tableofcontents'' est présente
+  * la seconde l'inclura, et modifiera donc probablement les numéros de page selon la taille de cette table des matières dans le document. Un nouveau fichier ''.toc'' sera généré ;
-dans le document,
+  * la troisième inclura ce nouveau fichier avec les bons numéros de page.
-\begin{itemize}
-\item <latex>\LaTeX</latex> crée un fichier ''.toc'' dans lequel il place tous les
-renseignements nécessaires (« niveau » de sectionnement, numéro, titre,
-page) ;
-\item le fichier ''.toc'' est inclus à l'endroit où est appelée la
-commande ''tableofcontents''.
-\end{itemize}
-En général, il est donc nécessaire de faire trois compilations pour avoir
+Voici un exemple simple pour un utilisateur francophone :
-une table des matières à jour :
+<WRAP column 45ex>
-\begin{itemize}
+<code latex>
-\item la première créera le fichier ''.toc'' ;
+\documentclass{article}
-\item la seconde l'inclura, et modifiera donc probablement les numéros de
+\usepackage[french]{babel}
-page ;
+\usepackage[T1]{fontenc}
-\item la troisième inclura la table des matières avec les bons numéros
+\begin{document}
-de page.
+\tableofcontents
-\end{itemize}
+\bigskip
+Voici de grandes questions !
+\section{Qui suis-je ?}
+Bonne question.
+\section{Où vais-je ?}
+Décidément, très bonne question.
+\subsection{Dans quel état j'erre ?}
+Euh...
+\end{document}
+</code>
+</WRAP>
-{{htmlmetatags>metatag-keywords=(LaTeX)
+<WRAP column 45ex>
-metatag-og:title=(Comment générer une table des matières?)
+<latexdoc>
+\documentclass{article}
+\usepackage[T1]{fontenc}
+\usepackage[body={8cm,20cm}]{geometry}
+\usepackage[french]{babel}
+\pagestyle{empty}
+\begin{document}
+\tableofcontents
+\contentsline {section}{\numberline {1}Qui suis-je ?}{1}%
+\contentsline {section}{\numberline {2}Où vais-je ?}{1}%
+\contentsline {subsection}{\numberline {2.1}Dans quel état j'erre ?}{1}%
+\bigskip
+Voici de grandes questions !
+\section{Qui suis-je ?}
+Bonne question.
+\section{Où vais-je ?}
+Décidément, très bonne question.
+\subsection{Dans quel état j'erre ?}
+Euh...
+\end{document}
+</latexdoc>
+</WRAP>
+<WRAP clear />
+Cet exemple appelle deux commentaires :
+  * la présence de l'extension [[ctanpkg>babel]] avec l'option ''french'' permettant de franciser le titre de la table des matières qui est, sinon, « Contents ». La question « [[3_composition/annexes/tables/changer_le_titre_de_la_table_des_matieres|Comment changer le titre de la table des matières ?]] » propose une autre solution plus flexible ;
+  * la présence d'une commande d'espacement, ici ''\bigskip''. Sans cela le texte qui suit la table des matières serait accolée à cette dernière. Il s'agit là d'un conseil qui n'a, bien entendu, rien d'impératif.
+Voici d'ailleurs le contenu du fichier ''.toc'' de cet exemple (hors une ligne qu'ajoute l'extension [[ctanpkg>babel]]) pour montrer ce que <latex>\LaTeX</latex> génère automatiquement :
+<code latex>
+\contentsline {section}{\numberline {1}Qui suis-je ?}{1}%
+\contentsline {section}{\numberline {2}Où vais-je ?}{1}%
+\contentsline {subsection}{\numberline {2.1}Dans quel état j'erre ?}{1}%
+</code>
+{{htmlmetatags>metatag-keywords=(LaTeX,tables des matières,table des matières)
+metatag-og:title=(Comment générer une table des matières)
 metatag-og:site_name=(FAQ LaTeX francophone)
 }}