Aller au contenu

ConTeXt/Chapitres et sections : commandes et environnements

Un livre de Wikilivres.

ConTeXt


 Page précédente : le document simple

Part. II, ch. 4  •  Chapitres et sections  •  Sommaire

Page suivante : Organisation du document 

Chapitres, sections et structure hiérarchique du document

[modifier | modifier le wikicode]

Objectifs Objectifs de cette section

Ce chapitre explique :

  • 1. La différence entre les commandes \chapter et \startchapter ... \stopchapter ;
  • 2. Comment organiser un document en sections, sous-sections et subdivisions ;
  • 3. Quand employer les environnements structurés ;
  • 4. Comment personnaliser les titres, la numérotation et l’apparence ;
  • 5. Comment gérer automatiquement la Table des matières.
  • Une bonne maîtrise de cette hiérarchie garantit un document propre, cohérent et conforme aux standards éditoriaux.


1. Deux philosophies : commandes simples et environnements

[modifier | modifier le wikicode]

ConTeXt propose deux manières de créer des chapitres et sections :

A. Les commandes simples

[modifier | modifier le wikicode]

Elles conviennent aux documents courts et rapides :

\chapter{Titre du chapitre}
\section{Titre de section}
\subsection{Titre de sous-section}

→ Lisibles, immédiates, proches de LaTeX. → Automatisent la numérotation et la table des matières.

B. Les environnements structurés

[modifier | modifier le wikicode]

Ils offrent davantage de contrôle typographique :

\startchapter[title={Le titre}, reference=chap:exemple]
  ... contenu ...
\stopchapter

Avantages :

  • possibilité d’ajouter des métadonnées (référence interne, titre alternatif, méthode de numérotation) ;
  • idéal pour les ouvrages complexes (livres, thèses, éditions critiques).
Astuce Pour les livres, thèses et projets longs, utilisez systématiquement les commandes startchapter et stopchapter. Vous obtiendrez un contrôle bien supérieur sur l'apparence.

2. La structure hiérarchique traditionnelle

[modifier | modifier le wikicode]

Voici la hiérarchie recommandée :

  • \part — Grandes divisions (facultatif)
  • \chapter — Chapitre
  • \section — Section
  • \subsection — Sous-section
  • \subsubsection — Sous-sous-section

Exemple typique :

\starttext

\startchapter[title={Introduction}]
  \section{Problématique}
  \subsection{Éléments historiques}
\stopchapter

\startchapter[title={Méthodologie}]
  \section{Sources}
  \section{Méthodes}
\stopchapter

\stoptext

3. Commandes avancées

[modifier | modifier le wikicode]

A. Titre alternatif (Table/Folio)

[modifier | modifier le wikicode]
\startchapter
  [title={Court titre},
   list={Titre complet pour la table des matières}]
\stopchapter

De même pour les sections :

\section
  [title={Titre imprimé},
   list={Titre court}]
\stopsection
Astuce Toujours fournir un titre court (list et titre court) si le titre complet dépasse une ligne. Cela améliore immédiatement la lisibilité de la Table des matières.

B. Références internes

[modifier | modifier le wikicode]
\startchapter[reference=chap:methodes, title={Méthodes}]
...

Voir le chapitre \in{chapter}[chap:methodes].

4. Personnaliser l'apparence des titres

[modifier | modifier le wikicode]

Quelques réglages utiles :

A. Style typographique

[modifier | modifier le wikicode]
\setuphead[chapter][style={\bfc}, color=darkblue]
\setuphead[section][style={\bfb}]

B. Numérotation

[modifier | modifier le wikicode]

Pour supprimer la numérotation :

\setuphead[chapter][number=no]

Pour une numérotation par section :

\setuphead[subsection][ownnumber=yes]

C. Ajouter un espace vertical

[modifier | modifier le wikicode]
\setuphead[chapter][before={\blank[medium]}, after={\blank[small]}]


Avertissement Avertissement
Évitez de multiplier des espacements manuels (\blank) dans le corps du document : préférez les règles globales définies via \setuphead. Ou bien, si vous voulez des espaces entre paragraphes, la commande \par est ce qu'il vous faut !

5. Table des matières automatique

[modifier | modifier le wikicode]

ConTeXt génère une table complète :

\completecontent

Pour n’afficher que les chapitres :

\placecontent[level=chapter]

Pour une profondeur de 2 niveaux :

\placecontent[criterium=all, level=2]

6. Exemple complet, prêt à compiler

[modifier | modifier le wikicode]
\setuppapersize[A4]% On définit la taille de la feuille de papier
\setupbodyfont[11pt] % On définit la taille de la police

\starttext

\completecontent % table des matières

\startchapter[title={Introduction}]
  \section{Contexte}
  Voici une section initiale.

  \subsection{Objectifs}
  Voici une sous-section.
\stopchapter

\startchapter[title={Méthodes et outils}]
  \section{Sources Primaires}
  \section{Sources Secondaires}
\stopchapter

\stoptext

   
   
     À retenir
   

ConTeXt permet :

  • une structure simple (\chapter)
  • ou très fine (\startchapter ...)
  • personnalisation totale des titres
  • associations de titres courts/longs
  • numérotation flexible
  • table des matières automatique
Tout document solide repose sur cette hiérarchie claire.

 Page précédente : le document simple

Part. II, ch. 4  •  Chapitres et sections  •  Sommaire

Page suivante : Organisation du document