ConTeXt/Le document simple : mise en page de base
|
Part. I, ch. 3 • Document simple • Sommaire |
Le document simple : mise en page de base, titres, sous-titres, paragraphes
[modifier | modifier le wikicode]
Objectifs de cette section
Cette page a pour but de :
- présenter la structure minimale d’un document ConTeXt ;
- expliquer comment régler la géométrie de la page (marges, format, corps de texte) ;
- montrer comment définir titres, sous-titres et sections ;
- clarifier la gestion des paragraphes (indentation, alignement) ;
- fournir un exemple complet de « document simple » prêt à compiler.
Un document simple en ConTeXt n’est pas seulement une lettre : c’est un fichier court mais bien structuré, avec une mise en page propre, des titres, des paragraphes bien définis et, éventuellement, quelques citations.
Cette page explique :
- la structure minimale d’un document ;
- la géométrie de la page (marges, taille de police) ;
- les titres, sous-titres et sections ;
- les paragraphes et l’indentation ;
- un exemple complet prêt à compiler.
1. Structure minimale d’un document ConTeXt
[modifier | modifier le wikicode]Tout fichier ConTeXt commence et se termine par :
\starttext
Votre texte ici.
\stoptext
Entre ces deux balises, on peut ajouter des titres, des sections, des paragraphes, des citations, etc.
2. Mise en page de base
[modifier | modifier le wikicode]La géométrie de la page se règle avec \setuplayout.
\setuplayout[
backspace=25mm, % marge intérieure (gauche sur page impaire)
cutspace=25mm, % marge extérieure (droite sur page impaire)
topspace=20mm, % marge supérieure
bottomspace=20mm % marge inférieure
]
Ces valeurs simples offrent une mise en page équilibrée.
Par défaut, ConTeXt considère que la page est au format A4. Si vous souhaitez travailler dans un autre format (A5, A3, Letter, livre, etc.), vous devez le déclarer dans le préambule :
\setuppapersize[A4] % format par défaut
% \setuppapersize[A5] % autre exemple
Taille de police
[modifier | modifier le wikicode]La taille de police principale se règle avec \setupbodyfont :
\setupbodyfont[11pt]
Valeurs fréquentes : 10pt, 11pt, 12pt.
Indentation des paragraphes
[modifier | modifier le wikicode]Pour activer l’indentation du premier alinéa de chaque paragraphe :
\setupindenting[yes, 1.5em]
Astuce
Ne combinez jamais indentation et saut vertical entre paragraphes.
Choisissez l’un ou l’autre pour conserver une mise en page propre et homogène.
3. Titres et sous-titres
[modifier | modifier le wikicode]ConTeXt distingue plusieurs niveaux de titres :
\title{…}— titre isolé (non numéroté) ;\section{…}— premier niveau structurant ;\subsection{…}— niveau de sous-section.
Exemple
[modifier | modifier le wikicode]\title{Mon premier document simple}
\section{Introduction}
Premier paragraphe du document.
\subsection{Un premier sous-titre}
Texte de la sous-section.
\title n’est pas numéroté.
Les structures logiques du document commencent à partir de \section.
4. Paragraphes
[modifier | modifier le wikicode]Créer un paragraphe
[modifier | modifier le wikicode]Une ligne vide crée un nouveau paragraphe :
Ceci est un premier paragraphe.
Ceci est un deuxième paragraphe.
Un simple saut de ligne ne crée pas de paragraphe.
Vous pouvez également utiliser la commande \par pour forcer un nouveau paragraphe sans insérer de ligne vide :
Ceci est un premier paragraphe.\par
Ceci est un deuxième paragraphe.
Alignement
[modifier | modifier le wikicode]Par défaut, ConTeXt justifie le texte sur toute la largeur.
Pour modifier l’alignement :
\setupalign[right] % aligné à droite
\setupalign[middle] % centré
\setupalign[nothyphenated] % sans césure
\setupalign[flushleft] % drapeau à gauche (non justifié)
\setupalign[flushright] % drapeau à droite (non justifié)
5. Exemple complet d’un document simple
[modifier | modifier le wikicode]Voici un exemple complet de document simple, directement compilable.
% Tout ce qui est déclaré ci-dessous, jusqu'à \starttext,
% s'appelle le "préambule" du document.
% Vous pouvez commenter les lignes de code avec le signe "%".
% Cela masque le commentaire à la compilation.
\setuplanguage[fr][patterns={fr}] % Pour les accents et les césures, déclarer la langue.
\mainlanguage[fr]
\setuppapersize[A4]
\setuplayout[
backspace=25mm,
cutspace=25mm,
topspace=20mm,
bottomspace=20mm
]
\setupbodyfont[11pt]
\setupindenting[yes, 1.5em]
\starttext
\title{Le document simple : mise en page de base}
Voici un premier paragraphe dans un document simple.
Il présente une mise en page propre et une typographie cohérente.
\section{Titres et sous-titres}
La commande \type{\section} introduit une structure lisible dans le texte.
\subsection{Paragraphe et indentation}
Chaque paragraphe commence après une ligne vide,
et la première ligne est indentée automatiquement.
\section{Citation}
\startquotation
« Un document simple bien structuré est déjà la moitié d’un document complexe. »
\stopquotation
\stoptext
5.1 Résultat de la compilation
[modifier | modifier le wikicode]Résultat de la compilation
[modifier | modifier le wikicode]
6. Conseils pour un document simple réussi
[modifier | modifier le wikicode]- Utiliser des marges sobres (par exemple 25/20 mm) ;
- choisir un corps de texte raisonnable (10 ou 11 pt) ;
- conserver une indentation régulière des paragraphes ;
- éviter les effets typographiques inutiles (trop de gras, trop d’italiques) ;
- choisir des titres courts et clairs ;
- maintenir le fichier source aussi simple et lisible que possible.
7. Bonnes pratiques pour vos premiers documents ConTeXt
[modifier | modifier le wikicode]Astuce
- Gardez votre préambule court et logique : langue → mise en page → typo → polices.
- Testez chaque nouvelle commande dans un MWE séparé avant de l’insérer dans un projet important.
- Placez toujours
\starttextet\stoptextseuls sur leur ligne. - Utilisez des commentaires
%pour documenter votre fichier. - Versionnez régulièrement vos fichiers (Git ou copies datées), par exemple :
mon-texte_02-11-2025_v01.tex
Avertissement
Tous les fichiers nécessaires à la compilation doivent impérativement se trouver dans le même répertoire que le fichier .tex, sauf configuration avancée.
Cela vaut pour :
- les fichiers
.bib(bibliographie) ; - les images (PNG, JPG, PDF) ;
- les fichiers
.mp,.mps(MetaPost / MetaFun) ; - les buffers externes ;
- les fichiers XML/HTML éventuellement importés.
Si ConTeXt ne trouve pas un fichier, vous obtiendrez une erreur du type file not found.
Pour éviter ces erreurs, placez par exemple mon_projet.tex, bibliographie.bib, figure1.pdf, schema.mp dans le même dossier.
Navigation
[modifier | modifier le wikicode]|
Part. I, ch. 3 • Document simple : mise en page de base • Sommaire |