◀ Partie I — Premiers pas · Installation ● Sommaire ● Partie I — Créer son premier document · Le document simple : mise en page de base ▶

Du document simple aux documents complexes avec ConTeXt

Objectifs de cette section
Cette page a pour but de :

définir ce qu’on entend par “document simple” ou “document complexe” dans ConTeXt ;
présenter les fonctionnalités qui permettent de passer de l’un à l’autre ;
donner une vision d’ensemble des besoins typographiques, structurels, linguistiques ou éditoriaux ;
préparer le lecteur aux parties détaillées du Wikilivre (mise en page, bibliographie, index, graphisme, etc.).

ConTeXt est un système de composition typographique extrêmement puissant, capable de produire des ouvrages allant du simple rapport aux livres les plus structurés : rapports, mémoires, thèses, éditions critiques, livres illustrés, documents multilingues, etc. :contentReference[oaicite:0]{index=0}

Avant d’aborder les aspects techniques, il est utile de distinguer deux grandes catégories :

un « document simple » — sobre, sans complexité excessive ;
un « document complexe » — nécessitant une structuration, des fonctionnalités et une rigueur accrues.

Cette page explique clairement cette distinction et montre ce que ConTeXt peut offrir au-delà du simple document.

1. Qu’appelle-t-on “document simple” dans ConTeXt ?

Un « document simple » correspond, dans l’usage courant, à un texte relativement modeste mais déjà structuré, typiquement :

quelques pages à quelques dizaines de pages ;
format normalisé (A4, A5, livre 6×9, etc.) ;
marges (empagement) définies ;
titre, un ou plusieurs sous-titres ;
paragraphes clairement identifiés ;
éventuellement quelques notes ;
parfois un tableau ou un encadré simple.

Un tel document peut servir à :

un rapport de cours ou de recherche,
un chapitre isolé,
une lettre soignée,
un article court,
un dossier ou un fascicule.

Un document simple peut comporter :

une page de titre ;
une hiérarchie de titres (chapitre, section, sous-section) ;
des notes de bas de page ou marginales ;
un petit tableau ou un encadré, une citation structurée ;
un changement ponctuel de langue.

En revanche, il ne comporte généralement pas :

de table des matières automatique,
de bibliographie complexe,
d’index des noms ou des notions,
de multiples encadrés graphiques ou figures complexes,
de code MetaPost ou d’automatisations avancées,
de publication multi-base, XML ou données structurées.

Bref : un document propre, lisible, structuré — mais aux besoins modestes.

2. Qu’est-ce qu’un “document complexe” ?

Un document est “complexe” lorsqu’il cumule plusieurs exigences : typographie avancée, structuration logique fine, indexation, bibliographie, langues multiples, graphisme, etc.

Voici les principales caractéristiques, avec les capacités de ConTeXt pour les prendre en charge :

2.1 Structuration avancée

Un document complexe peut contenir :

une page de garde et une page de titre ;
un frontmatter (préface, résumé, table des matières) ;
un bodymatter (parties, chapitres, sections) ;
un backmatter (bibliographies, index, annexes, table(s) des matières, etc.) ;
en-têtes et pieds de page différenciés selon les parties ;
numérotation distincte (romaine pour frontmatter, arabe ensuite).

ConTeXt gère ce découpage avec précision et souplesse.

2.2 Notes sous plusieurs formes

Il peut y avoir :

notes de bas de page ;
notes marginales ;
notes de fin de chapitre ou de section ;
apparat critique (numérotation indépendante, notes dans marges internes ou externes, regroupements, etc.).

ConTeXt permet de combiner ces formes selon les besoins.

2.3 Tableaux, encadrés, graphismes

Dans un document complexe, on trouve souvent :

tableaux structurés, avec titres, légendes et notes ;
encadrés informatifs, cadres colorés ou récapitulatifs ;
dessins intégrés (graphiques, schémas, diagrammes) via MetaPost ou MPgraphics ;
figures ou images placées avec légendes automatiques.

ConTeXt offre des capacités typographiques et graphiques très étendues pour ces usages.

2.4 Travail multilingue complet

Un document complexe peut mélanger plusieurs langues, y compris non latines :

alphabets latins avec diacritiques (français, allemand, polonais, turc…) ;
alphabets non latins (grec ancien, cyrillique, langues CJK…) ;
mélanges de langues, de scripts, d’encodages.

Grâce à ses mécanismes internes, ConTeXt permet de gérer ces mélanges sans rupture, avec une typographie correcte.

2.5 Bibliographie et gestion des références

Les fonctionnalités comprennent :

utilisation d’une (ou plusieurs) base(s) bibliographique(s) — fichier(s) externes ou interne(s) ;
citation dans le texte ou en note ;
tri alphabétique, styles variés (APA, Chicago…), bibliographies thématiques ;
bibliographies ventilées par catégorie (ex. Philosophie, Littérature, Histoire, etc.).

Le module bibliographique de ConTeXt permet tout cela de façon flexible.

2.6 Index (noms, notions, lieux)

Un index peut regrouper :

noms propres,
notions, concepts, termes techniques,
lieux, noms géographiques, toponymes,
renvois multiples pour une même entrée,
regroupements alphabétiques, index hiérarchisés.

ConTeXt autorise la création d’index complexes, souvent imprimés dans le backmatter.

2.7 Documents orientés données (XML, CSV, etc.)

Pour des ouvrages ou publications structurées (catalogues, dictionnaires, bases de données, listes, globaux), ConTeXt permet d’importer des données (XML, CSV) et de les formater :

tables, tableaux, listes, index ;
publipostage typographique propre ;
génération automatisée de documents relatifs à des données externes.

2.8 Mise en page avancée

Typographie soignée, mise en page sophistiquée :

pages recto-verso avec marges asymétriques ;
chapitres ouvrant toujours sur page impaire ;
pages de garde, intercalaires, pages blanches contrôlées ;
pagination distincte (notes, annexes, index…), styles variés d’en-tête / pied de page ;
gestion fine des espacements, des césures, des polices, des titres, des couleurs, etc.

ConTeXt est conçu pour gérer tout cela, même dans les ouvrages volumineux et complexes.

3. Pourquoi cette distinction — et pourquoi l’adopter ?

Cette distinction est utile pour plusieurs raisons :

pour savoir ce que l’on attend d’un document — simplicité, rapidité, ou robustesse structurelle ;
pour choisir les bons outils au bon moment (mise en page simple, ou dès le début structuration avancée) ;
pour éviter la confusion entre ce qui relève de la mise en page, de la structure logique, de la typographie, des modules spécialisés ;
pour progresser de manière ordonnée : d’abord les bases, puis les fonctions avancées.

Ainsi on évite des erreurs fréquentes (mélange d’implémentations, surcharge inutile, erreurs de structure), et on garantit la cohérence éditoriale.

4. Ce que ConTeXt permet réellement

ConTeXt est idéal pour :

dissertations, articles, dossiers argumentés ;
thèses, mémoires universitaires ;
éditions critiques multilingues ;
livres scientifiques — tableaux, notes, bibliographies ;
ouvrages littéraires ou philosophiques ;
documents techniques, rapports, catalogues ;
composition nécessitant une typographie soignée et fiable.

ConTeXt excelle dans :

la précision typographique ;
la gestion multilingue avancée ;
l’intégration de graphisme via MetaPost / MPgraphics ;
la structuration complexe (frontmatter / bodymatter / backmatter) ;
la gestion de bibliographies professionnelles ;
la création d’index sophistiqués ;
la génération automatisée de documents à partir de données (XML, CSV, bases) ;
la production de documents structurés, longs et cohérents.

4bis. Exemples concrets

Pour illustrer la différence entre un document simple et un document complexe, voici deux exemples complets et commentés.

Exemple 1 : Document simple (une lettre structurée)

Cet exemple montre un document court, sans section complexe, uniquement structuré par quelques commandes de base.

\setuppapersize[A4]
\setuplanguage[fr][patterns={fr}]
\mainlanguage[fr]
\setcharacterspacing[frenchpunctuation]
\setuplayout
  [backspace=25mm,
   topspace=20mm,
   width=fit,
   height=fit]

\setuppagenumbering[location=]

\defineparagraphs[Adresse][n=1]
\setupparagraphs[Adresse][1][width=8cm,align=right]

\starttext

\startAdresse
Nom Prénom \crlf
12 rue du Centre \crlf
75000 Paris
\stopAdresse

\blank[3*big]

\rightaligned{Paris, le \currentdate}

\blank[medium]

\subject{Objet : Demande de rendez-vous}

Madame, Monsieur,

Je vous contacte afin de convenir d'un rendez-vous concernant le projet en cours.  
Je reste disponible aux dates suivantes : lundi, mardi et vendredi après-midi.

Dans l’attente de votre réponse, je vous prie d’agréer, Madame, Monsieur, l’expression de mes salutations distinguées.

\blank[3*medium]

\startnarrower[2*left]
\it Nom et signature
\stopnarrower

\stoptext

Cet exemple illustre :

une mise en page simple ;
aucune structure avancée ;
pas de bibliographie, index, graphismes, ni sections multiples.

Résultat de la compilation

Exemple 2 : Document complexe (deux pages, notes, section, bibliographie)

Ce document montre plusieurs fonctionnalités clés des documents structurés : frontmatter minimal, structure du texte, notes, citation, bibliographie automatique. Cet exemple laisse de côté pour l'instant l'explication concernant la mise en œuvre d'une bibliographie. Ce point sera expliqué dans les chapitres suivants.

% NOTE : Pour les besoins de l'exemple et pour limiter la place dans le Wikilivre, cette mise en page ne respecte pas les contraintes typographiques d'une édition réelle (marges, blancs, proportions). Il s'agit d'un MWE compact, destiné uniquement à l'illustration.


\setuplanguage[fr][patterns={fr}]
\mainlanguage[fr]

\setupbodyfont[11pt]

% --- Bibliographie d'exemple ---
\usebtxdataset[exemple][biblio-exemple.bib]
\definebtxrendering[exemple][apa][dataset=exemple]
\setupbtxrendering[continue=yes]

\setuppapersize[A4]
\setuppagenumbering[location={footer,right}]

% --- Mise en page avec marges élargies pour un bloc de texte plus court ---
\setuplayout[
  location=middle,
  topspace=12mm,
  backspace=20mm,
  cutspace=20mm,
  bottomspace=12mm,
  height=235mm,     % contrôle strict de la hauteur pour que tout tienne sur 1 page A4
  width=170mm,
  header=0mm,
  footer=5mm,
]

% --- Titres ---
\setuphead[chapter][
  page=no,
  before={\blank[big]},
  after={\blank[medium]},
]

\setuphead[section][
  before={\blank[medium]},
  after={\blank[small]},
]

\setupwhitespace[medium]

% --- Ne pas forcer de page entre les "parts" ---
\setupsectionblock[frontpart][page=no]
\setupsectionblock[bodypart][page=no]
\setupsectionblock[backpart][page=no]

\starttext

\startfrontmatter

\title{Exemple de document complexe}
\blank[medium]

Ce document illustre les éléments fondamentaux d’une édition simple en \ConTeXt{},
construite sur une seule page A4, avec un frontmatter, un corps de texte et une bibliographie.
Il s’agit d’un exemple volontairement compact destiné au Wikilivre.

\blank[big]

% --- Table des matières avec son titre explicite ---
{\bf \ss Table des matières}
\blank[small]
\placecontent

\blank[big]

\stopfrontmatter

\startbodymatter

\chapter{Introduction}

Le corps du document présente les éléments essentiels d’une mise en page \ConTeXt :
titres hiérarchisés, notes\footnote{Exemple de note de bas de page.}, citations,
et renvois bibliographiques\cite[alternative=entry][exemple::dupond2020].

\section{Une section typique}

Un paragraphe peut contenir une référence bibliographique intégrée\cite[alternative=entry][exemple::typography2018].
Dans ce format compact, la typographie est simplifiée pour assurer la tenue sur une seule page.

\startblockquote
« La typographie n’est pas seulement l’art de disposer les lettres, mais la science
des rapports entre structure, forme, sens et lisibilité. »
\stopblockquote

Ce bloc de citation illustre la mise en forme automatique des références textuelles
à l’intérieur d’un exemple court.

\stopbodymatter
% --- Laisser un espace pour amener la bibliographie dans le dernier quart ---
\blank[2*big]

\startbackmatter

\chapter{Bibliographie}

\placelistofpublications[exemple][method=local]

\stopbackmatter

\stoptext

Ce document complexe mobilise :

un découpage frontmatter / bodymatter / backmatter ;
un chapitre, une section, une citation longue ;
des notes de bas de page ;
une bibliographie basée sur un fichier `biblio-exemple.bib` ;
une pagination cohérente ;
une mise en page complète.

Vous pouvez créer un fichier d’exemple `biblio-exemple.bib` contenant :

@Book{dupond2020,
  author    = {Dupond, Robert},
  editor    = {Durand, Gilles},
  publisher = {Presses Académiques},
  title     = {Introduction à la typographie numérique},
  year      = {2020},
  address   = {Paris},
  edition   = {1st},
  number    = {6},
  series    = {Éditions numériques},
  volume    = {IV},
  subtitle  = {Travailler avec {{ConTeXt}}},
}


@article{typography2018,
  author = {Smith, Laura},
  title = {Typography and Meaning},
  journaltitle = {Journal of Design},
  year = {2018},
  volume = {12},
  number = {3},
  pages = {45-60},
}

Ces deux exemples permettent de visualiser clairement le passage du document simple au document élaboré.

Exemple 2 : Résultat après compilation

Résultat de la compilation d'un document ConTeXt complexe.

5. Pour la suite du Wikilivre

Ce chapitre introductif sera suivi de pages détaillées, chacune consacrée à un aspect spécifique :

Mise en page de base, structure, empagement, titres, paragraphes.
Bibliographie, gestion des références (module btx, biblio, .bib, rendus).
Index des noms, index des notions, index des lieux.
Encadrés, tableaux, cadres colorés, graphismes, MetaPost.
Langues multiples, polices, fallback, encodages, CJK.
Documents structurés via XML, CSV, publipostage, génération automatisée.

Ces pages fourniront des exemples concrets et des “minimal working examples” (MWE), afin d’illustrer clairement tout le potentiel de ConTeXt.