ConTeXt/Organisation du document

◀ Page précédente : Chapitres et sections

Part. II, ch. 4  •  Organisation du document  •  Sommaire

Page suivante : Table des matières ▶

Objectifs de cette page

• Comprendre comment organiser un document ConTeXt en parties, chapitres et sections.
• Distinguer les différentes zones d’un document long (frontmatter, bodymatter, backmatter).
• Apprendre à structurer un projet en plusieurs fichiers (environnement, produit, composants).
• Préparer une organisation claire qui facilite la maintenance, la réutilisation et l’extension du document.

Organisation d’un document long, voire très long ...

Lorsqu’il s’agit d’un document de taille modérée — une vingtaine ou une cinquantaine de pages — comprenant un avant-propos, quelques chapitres, quelques illustrations et un petit nombre de notes, il n’est pas indispensable d’adopter une structure de projet complexe. Un ou deux fichiers ConTeXt suffisent : vous rédigez votre texte de manière linéaire, et vous insérez simplement les balises \chapter, \section et les environnements standard dans le frontmatter, le bodymatter et le backmatter. Cette méthode reste souple, rapide et adaptée à la plupart des documents courants.

En revanche, dès que vous produisez régulièrement des documents plus ambitieux — ouvrages complets, rapports volumineux, manuels, catalogues, bulletins illustrés ou publications comprenant plusieurs niveaux hiérarchiques, figures nombreuses, colonnes, tableaux, bibliographie et index — le travail devient vite difficile à maintenir dans un seul fichier. C’est ici que ConTeXt montre tout son intérêt : il permet de séparer clairement le style et le contenu, d’organiser un projet en plusieurs composants et de définir une maquette réutilisable, stable et professionnelle. Cette approche, très utilisée en édition, garantit une qualité constante et un travail beaucoup plus efficace sur la durée.

Note : Dès que vous produisez régulièrement des documents complexes — livres, rapports, bulletins sur plusieurs cahiers, documents multicolonnes ou publications illustrées — il devient indispensable d’adopter une structure de projet : un fichier d’environnement pour la mise en page, des composants pour les chapitres et un fichier maître pour l’assemblage. Cette organisation, inspirée des pratiques professionnelles de l’édition, rend la production plus stable, plus claire et beaucoup plus facile à maintenir dans le temps.

---

1. Document simple : un fichier unique

Pour un document simple, la structure minimale suffit :

\starttext
\chapter{Introduction}
Votre texte ici...

\section{Un paragraphe}
Ici quelques lignes.

\stoptext

Cette approche convient :

• aux documents courts ;
• aux rapports non illustrés ;
• aux petits exercices pédagogiques ;
• aux travaux dont la structure change peu.

Aucune organisation complexe n’est nécessaire.

---

2. Document évolué : pourquoi structurer ?

Lorsque les documents deviennent longs, plusieurs problèmes apparaissent :

• impossible de naviguer rapidement dans un fichier de 200 pages ;
• difficile de changer la mise en page sans casser le contenu ;
• difficile de réutiliser une mise en forme déjà testée ;
• impossible de travailler à plusieurs ;
• correction lourde et risquée.

ConTeXt propose pour cela une organisation professionnelle :

• product : fichier maître (structure générale) ;
• environment : style, mise en page, marges, colonnes… ;
• component : fichiers de contenu (chapitres, pages, sections).

C’est l’équivalent d’une maquette éditoriale complète.

---

3. Le triptyque “product” – “environment” – “component”

3.1. Le fichier maître : product

Il assemble tous les composants et applique l’environnement :

\environment env/env_livre.mkiv

\startproduct MonLivre

\startfrontmatter
  \component frontmatter/00-titre.mkiv
  \component frontmatter/01-preface.mkiv
\stopfrontmatter

\startbodymatter
  \component bodymatter/10-chapitre1.mkiv
  \component bodymatter/11-chapitre2.mkiv
\stopbodymatter

\startbackmatter
  \component backmatter/90-bibliographie.mkiv
  \component backmatter/91-index.mkiv
\stopbackmatter

\stopproduct

3.2. Le fichier d’environnement : environment

Il regroupe tout ce qui relève de la mise en page :

• structuration de la page (marges, géométrie) ;
• polices et interlignage ;
• notes et références ;
• colonnes ;
• flottants ;
• bandeaux, éléments graphiques ;
• imposition éventuelle (livrets).

Exemple minimal :

\mainlanguage[fr]
\setupbodyfont[pagella, 11pt]

\setuplayout[
  backspace=25mm,
  cutspace=20mm,
  topspace=15mm,
  bottomspace=15mm,
]

\setuphead[chapter][style=\bf\ss, page=yes]

3.3. Les composants : component

Ce sont les fichiers de contenu, un par chapitre :

\startcomponent 10-chapitre1

\chapter{Premiers principes}
Ici votre texte…

\section{Un développement}
Suite du texte.

\stopcomponent

Avantages :

• le contenu est propre ;
• la mise en page peut évoluer sans modifier le texte ;
• on peut compiler un chapitre seul ;
• maintenance très facile.

---

4. Structure recommandée d’un projet ConTeXt

Arborescence des dossiers et des fichiers :

# Racine du projet ConTeXt
monlivre/
  # Fichiers d'environnement (mise en page, polices, marges)
  env/
    env_livre.mkiv        # Environnement principal du livre

  # Pages liminaires
  frontmatter/
    00-titre.mkiv         # Page de titre
    01-preface.mkiv       # Préface

  # Corps du texte
  bodymatter/
    10-chap1.mkiv         # Chapitre 1
    11-chap2.mkiv         # Chapitre 2

  # Parties finales
  backmatter/
    90-bibliographie.mkiv # Bibliographie
    91-index.mkiv         # Index

  livre.mkiv              # Fichier maître (product)

Cette organisation est robuste et déjà adoptée dans de nombreux projets éditoriaux.

---

5. Exemple complet : un livre structuré

5.1. Le fichier maître

\environment env/env_livre.mkiv
\startproduct MonLivre
\startfrontmatter
  \component frontmatter/00-titre.mkiv
  \component frontmatter/01-preface.mkiv
\stopfrontmatter
\startbodymatter
  \component bodymatter/10-chapitre1.mkiv
  \component bodymatter/11-chapitre2.mkiv
\stopbodymatter
\startbackmatter
  \component backmatter/90-bibliographie.mkiv
\stopbackmatter
\stopproduct

5.2. L’environnement (extrait)

\setupbodyfont[pagella,11pt]
\mainlanguage[fr]

\setuplayout[
  backspace=25mm,
  cutspace=20mm,
  header=10mm,
  footer=12mm,
  topspace=15mm,
  bottomspace=15mm,
  width=middle,
  height=middle,
]

\setuphead[chapter][style=\bfb, page=yes]
\setuphead[section][style=\bf]

5.3. Un chapitre (composant)

\startcomponent 10-chapitre1
\chapter{Introduction générale}

Voici le premier chapitre de l’ouvrage.
Vous pouvez y inclure texte, citations et figures.

\stopcomponent

---

6. Exemple avancé : bulletin / magazine (A3 → A4, colonnes, bandeau, flottants)

Lorsqu’un document devient un « magazine » ou un bulletin illustré, il faut gérer :

• une couverture avec bandeau graphique ;
• des pages en colonnes ;
• des images flottantes ;
• parfois une imposition livret (A4 sur A3 plié).

ConTeXt excelle dans ce genre de production.

6.1. Structure

bulletin/
  env/
    env_bulletin.mkiv
  pages/
    p01_couverture.mkiv
    p02_edito.mkiv
    p03_infos.mkiv
    p04_annonces.mkiv
  bulletin.mkiv

6.2. Le fichier maître

\environment env/env_bulletin.mkiv
\startproduct Bulletin
\component pages/p01_couverture.mkiv
\component pages/p02_edito.mkiv
\component pages/p03_infos.mkiv
\component pages/p04_annonces.mkiv
\stopproduct

6.3. L’environnement avec colonnes et bandeau

\mainlanguage[fr]
\setupbodyfont[pagella,11pt]

\setuppapersize[A4][A3]
\setuparranging[BOOKLET,2SIDE]

\setuplayout[
  backspace=30mm,
  cutspace=10mm,
  header=20mm,
  footer=20mm,
  topspace=20mm,
  bottomspace=20mm,
]

\setupcolumns[n=3,distance=3mm,balance=yes]

\defineoverlay[banner][{\externalfigure[banner.png][width=\overlaywidth,height=\overlayheight]}]

\def\BandeauTitre#1{%
  \framed[width=\textwidth,height=30mm,frame=off,
          background=banner,foregroundcolor=white,align=middle]
  {\ss\bfb #1}}

6.4. Page de couverture

\startcomponent p01_couverture
\chapter{Couverture}

\BandeauTitre{Bulletin d'information}
\blank[big]

\startcolumns
Ici le reste du contenu en trois colonnes.
\stopcolumns

\stopcomponent

---

7. Bonnes pratiques pour les documents longs

• Ne jamais mélanger style et contenu.
• Documentez votre environnement (date, version…).
• Testez la mise en page **avant** d’écrire tout le texte.
• Utilisez un dépôt Git si vous travaillez à plusieurs.
• Utilisez des noms de fichiers numérotés.

💡 Astuce : pour tester un chapitre isolé, compilez directement son fichier .mkiv : ConTeXt chargera automatiquement l’environnement lié.

---

8. Fournir un “BAT” à un imprimeur

De nombreux imprimeurs demandent aujourd’hui :

• un fichier PDF conforme au gabarit fourni ;
• bords perdus (bleed) ;
• traits de coupe ;
• couverture en double page ;
• éventuellement PDF/X.

ConTeXt permet d’atteindre ces exigences :

\setuppapersize[A4][A4]
\setuppaper[
  topoffset=3mm,
  leftoffset=3mm,
  bottomoffset=3mm,
  rightoffset=3mm,
]
\settrimmedsize[\paperwidth][\paperheight]

Il est possible de reproduire exactement les marges techniques exigées.

Note : pour des exigences professionnelles (PDF/X, profils couleur, repères), il est recommandé de consulter la documentation ConTeXt sur les exportations PDF et les réglages avancés.

---

9. Voir aussi

• Marges, géométrie et cadres simples
• Colonnes et agencements multi-colonnes
• Environnements : encadrés, cadres, notes en marge
• Images et figures
• Créer et imprimer la sortie PDF

Navigation

◀ Page précédente : Chapitres et sections

Part. II, ch. 4  •  Organisation du document  •  Sommaire

Page suivante : Table des matières ▶