ConTeXt/Table des matières
|
Part. II, ch. 5 • Table des matières • Sommaire |
Table des matières (ToC) dans ConTeXt
[modifier | modifier le wikicode]
Objectifs de cette section
Savoir générer une table des matières claire et flexible est indispensable pour tout document structuré : article, mémoire, thèse ou livre.Cette page présente :
- 1. les commandes essentielles :
\completecontentet\placecontent; - 2. la personnalisation de l'apparence (points de suite, indentation, numérotation) ;
- 3. l’inclusion ou l’exclusion d’éléments dans la ToC ;
- la création de tables des matières partielles ou locales ;</>
- les problèmes les plus fréquents — et leurs solutions.
ConTeXt propose un système très souple fondé sur les combined lists. Chaque niveau de titre (chapitre, section, sous-section) peut être inclus dans la ToC ou ignoré, et la présentation peut être entièrement personnalisée.
1. Les commandes fondamentales
[modifier | modifier le wikicode]1.1. \completecontent — Table des matières complète
[modifier | modifier le wikicode]C’est la commande la plus simple pour produire une ToC :
\completecontent
Elle affiche :
- les chapitres ;
- les sections ;
- les sous-sections ;
- selon les niveaux choisis par défaut (configurables).
Elle est utilisée en général dans le frontmatter.
Astuce 
|
Utilisez |
1.2. \placecontent — Table des matières locale
[modifier | modifier le wikicode]Cette commande donne une table des matières partielle, par exemple pour un chapitre :
\placecontent
On peut également cibler un niveau précis :
\placecontent[section] % seulement les sections du chapitre
\placecontent[subsection] % seulement les sous-sections
Très utile dans les livres longs avec chapitres complexes.
2. Personnaliser la table des matières
[modifier | modifier le wikicode]ConTeXt propose une mise en forme entièrement configurable grâce aux combined lists.
2.1. Ajuster les niveaux affichés
[modifier | modifier le wikicode]Pour choisir les niveaux présents :
\setupcombinedlist
[content]
[list={chapter, section, subsection}]
Pour une ToC plus compacte :
\setupcombinedlist
[content]
[list={chapter, section}]
2.2. Modifier les points de suite
[modifier | modifier le wikicode]Les pointsde suite : (.......) entre le titre et le numéro de page se règlent ainsi :
\setupcombinedlist
[content]
[alternative=c, distance=1em]
Principales valeurs pour alternative :
- **a** — aucun point
- **b** — ligne complète
- **c** — pointillés (le plus fréquent)
| Astuce
|
|
2.3. Indentation des niveaux
[modifier | modifier le wikicode]Pour ajuster les retraits :
\setupcombinedlist
[content]
[leveldistance=1.5em, width=3em]
Paramètres :
leveldistance: retrait entre niveaux (sections → sous-sections)width: largeur réservée pour la numérotation
2.4. Modifier les titres internes
[modifier | modifier le wikicode]Pour changer le titre "Table des matières" dans le PDF :
\setupheadtext[content=Sommaire]
Pour une ToC bilingue :
\setupheadtext
[fr][content=Sommaire]
[en][content=Contents]
3. Tables des matières spécialisées (sections, figures, tableaux)
[modifier | modifier le wikicode]3.1. Liste des figures
[modifier | modifier le wikicode]\placelist[figure]
3.2. Liste des tableaux
[modifier | modifier le wikicode]\placelist[table]
3.3. Liste des encadrés, listes, listings
[modifier | modifier le wikicode]Selon la structure :
\placelist[itemize]
\placelist[description]
\placelist[formula]
Pour créer une liste personnalisée :
\definelist[citeindex]
\placelist[citeindex]
4. MWE complet et annoté
[modifier | modifier le wikicode]Voici un document complet qui produit :
- une ToC complète au début,
- une ToC locale dans un chapitre,
- des figures et tableaux numérotés correctement.
\setuplanguage[fr]
\mainlanguage[fr]
% --- TOC complète
\setupcombinedlist[content][list={chapter, section, subsection}, alternative=c]
\starttext
\startfrontmatter
\completecontent
\stopfrontmatter
\startbodymatter
\chapter{Introduction}
\section{Propos préliminaires}
Texte...
\placecontent % Table des matières locale
\chapter{Exemple de figures}
\startplacefigure[location=here]
\caption{Figure de démonstration}
\stopplacefigure
\placelist[figure]
\stopbodymatter
\startbackmatter
\chapter{Fin du document}
\stopbackmatter
\stoptext
5. Problèmes fréquents et solutions
[modifier | modifier le wikicode]• Missing number and treated as zero
[modifier | modifier le wikicode]Cause : un titre utilise \section mais n’a pas de numéro.
Solution :
\setuphead[section][number=no] % empêche la création de numéros fantômes
• Table of content empty
[modifier | modifier le wikicode]Cause : absence de compilation double. Solution : compiler deux fois.
• Les figures ne s'affichent pas dans la liste
[modifier | modifier le wikicode]Cause : absence de \placefigure
→ \startplacefigure ... \stopplacefigure ou \placefigure requis.
• La ToC apparaît au mauvais endroit
[modifier | modifier le wikicode]Cause : \completecontent utilisé après \startbodymatter.
Avertissement !
Une table des matières doit toujours être placée dans le frontmatter selon la norme anglo-saxonne, mais en backmatter selon les normes de l'édition francophone.
Navigation
[modifier | modifier le wikicode]|
Part. II, ch. 5 • Table des matières • Sommaire |