Annexes du Wikilivre ConTeXt
Cette section regroupe les erreurs les plus fréquentes rencontrées lors de l’utilisation de ConTeXt (LMTX ou MkIV), ainsi que leurs solutions rapides.
Elle sera enrichie au fur et à mesure des retours d’expérience.
Thème
Symptôme / message d’erreur
Cause probable
Solution
Erreur de frappe
unknown control sequence
Commande mal écrite : \statrtext, \stoptxt, etc.
Vérifier l’orthographe → \starttext / \stoptext
Oubli d’accolades
missing } inserted
Début de bloc sans fin de bloc
Vérifier l’équilibre { }
Fichier non compilable
nothing happens / no output PDF
Oubli du bloc \starttext … \stoptext
Encadrer TOUT le contenu dans \starttext … \stoptext
Accents incorrects
caractères bizarres
Fichier non enregistré en UTF-8
Forcer l’encodage UTF-8 dans l’éditeur
Thème
Symptôme
Cause probable
Solution
Langue française absente
pas de césure, guillemets anglais
Oubli de \mainlanguage[fr]
Ajouter \setuplanguage[fr][patterns={fr}] + \mainlanguage[fr]
Police incorrecte
Trop grasse / trop fine / sans italiques
Mauvaise famille ou absence de fallback
Utiliser \setupbodyfont[libertinus] ou une famille complète
Police introuvable
invalid font
Cache de polices corrompu
mtxrun --script fonts --reload
Configurations ignorées
marges non appliquées
\setuplayout placé après \starttext
Mettre toute la configuration AVANT \starttext
Thème
Symptôme
Cause probable
Solution
Titres non affichés
Section invisible dans la table des matières
Mauvais niveau (\subsection avant section)
Respecter la hiérarchie section → subsection → subsubsection
Sauts de page inattendus
Page blanche en trop
Rémanence d’un \page ou \chapter avec page=yes
Enlever page=yes ou \page[empty]
Table des matières vide
Sommaire non généré
\completecontent placé trop tôt
Mettre \completecontent APRÈS \starttext
Thème
Symptôme
Cause probable
Solution
Image non affichée
unknown filetype
Format non pris en charge (SVG)
Convertir en PNG/JPG/PDF
Image trop grande
déborde de la page
Pas de réglage de taille
\externalfigure[][width=\textwidth]
Page blanche avant / après figure
float mal positionné
Compréhension incorrecte du float
Utiliser \placefigure et non \externalfigure seul
=== Mise en page et géométrie===
Thème
Symptôme
Cause probable
Solution
Marges incorrectes
texte trop haut / trop bas
\setuplayout mal positionné
Déplacer \setuplayout AVANT \starttext
Zones qui se chevauchent
texte dans le header/footer
height ou topspace mal calculés
Activer \showframe pour diagnostiquer
Colonnes non affichées
texte reste sur une seule colonne
oubli du bloc \startcolumns
\startcolumns ... \stopcolumns
Thème
Symptôme
Cause
Solution
Livret désordonné
pages dans le mauvais ordre
Mauvaise imposition
\setuparranging[BOOKLET]
Feuilles A3 incorrectes
demi-pages tronquées
mauvais couple \setuppapersize[A4][A3]
Vérifier format source et format cible
Pages vides multiples
4 pages ajoutées
Livret nécessite un total de 4n pages
Ajouter pages vides pour atteindre 4, 8, 12, 16…
Thème
Symptôme
Cause probable
Solution
Grec/cyrillique absent
symboles □□□
Pas de fallback pour la famille
\definefontfallback + \setupbodyfont
RTL incorrect (arabe/hébreu)
ordre inversé
Module bidi non chargé
Charger \usemodule[bidi] (MkIV)
Lettre isolée / ligatures cassées
backend PDF obsolète
Usage d’une version trop ancienne de MkIV
Passer à ConTeXt LMTX
Thème
Symptôme
Cause probable
Solution
Index vide
aucune entrée
\index non utilisé ou mauvais emplacement
Ajouter \index{mot} dans le texte
Références non résolues
?? apparaît
compilation trop rapide
Compiler deux fois
Bibliographie absente
liste vide
dataset non déclaré
\usebtxdataset + \placelistofpublications
Thème
Symptôme
Cause probable
Solution
XML non traité
tout le texte brut s'affiche
pas d’instructions de mappage
\xmlprocessfile + \defineXMLenvironment
Lua error: attempt to index a nil value
variable non initialisée
erreur dans un module Lua
Vérifier le require() et les chemins
Script mtxrun ne répond pas
mtxrun not found
PATH incorrect
Ajouter le dossier /texmf-linux-64/bin au PATH
Erreur
“unknown control sequence” Une commande n’est pas reconnue.
→ Vérifier l’orthographe de la commande.
→ Vérifier que le module correspondant est chargé (`\usemodule[...]`).
→ Vérifier que vous utilisez bien LMTX (certaines commandes n’existent plus en MkIV). Erreur
“environment ... undefined” Un environnement n’a pas été défini.
→ Vérifier que la commande `\start...` correspond bien à un `\stop...`.
→ Pas de majuscules dans les noms d’environnements. Erreur
“missing } inserted” Une accolade est manquante.
→ Rechercher les `{` / `}` non équilibrées.
→ Utiliser un éditeur avec coloration syntaxique. Une police ne s’affiche pas ou disparaît → Lancer dans le terminal : --script fonts --reload
→ Vérifier l’existence de la police via : --script fonts --list --all | grep "nomdelapolice"
Police trop grasse / trop fine selon le backend → Essayer une autre famille (`\setupbodyfont[libertinus]`, `\setupbodyfont[modern]` etc.).
→ Vérifier les “fallback” pour le grec, cyrillique, arabe, etc. Erreur
“invalid font” → La police est corrompue ou incomplète.
→ La régénérer dans FontForge ou en télécharger une version propre. Erreur
“unknown filetype” lors de l’insertion d’une image → Vérifier que l’image est en PNG, JPG ou PDF (SVG non pris en charge par défaut).
→ Vérifier le chemin : \externalfigure [images/monimage.png]
Image trop grande / déborde de la page \externalfigure [...][width=\textwidth]
Figures non numérotées → Vérifier la structure : `\placefigure` + `\startfloatcombination`. Les marges ne changent pas → Utiliser `\setuplayout[...]` **avant** `\starttext`.
→ Vérifier qu’il n’y a pas un `\startstandardmakeup` qui écrase la mise en page. Le texte déborde ou chevauche les en-têtes → Vérifier `topspace`, `header`, `height`.
→ Essayer `\showframe` pour visualiser les zones. Les colonnes ne s'affichent pas \startcolumns ... \stopcolumns
L’imposition ne fonctionne pas \setuparranging [BOOKLET, 2SIDE]
Résultat bizarre en A3/A4 → Vérifier la combinaison : Ordre de pages incorrect → LMTX impose automatiquement pour les livrets multiples de 4 pages.
→ Vérifier que le nombre de pages = 4n (4, 8, 12, 16…). Fichier XML non reconnu \xmlprocessfile { main}{ monfichier.xml}{ xml:code}
Les éléments TEI n’apparaissent pas
→ Vérifier la correspondance dans le fichier de mappage : Lua
“attempt to index a nil value” → Une table Lua n’a pas été initialisée.
→ Vérifier le chemin du fichier Lua et les `require()`. Entrée d’index non affichée → Vérifier qu’il y a bien : Table des matières vide → Vérifier que `\completecontent` est placé après `\starttext`.
→ Vérifier les niveaux de sections. Références croisées non résolues → Il faut compiler deux fois dans certains cas.
→ Vérifier que les labels ne contiennent pas d’espaces. “mtxrun not found” → Vérifier le PATH.
→ Sur Linux : `/home/user/context/tex/texmf-linux-64/bin` doit être dans le PATH. Erreur
“unknown script” → Vérifier que l’appel est correct : Cache incohérent Accentuation incorrecte → Toujours utiliser UTF-8. Retour à la ligne non souhaité → Utiliser `\crlf` pour forcer.
→ Utiliser `\blank` pour espacer proprement. Problèmes de compilation sur TeXworks → Vérifier que ConTeXt LMTX est bien sélectionné comme moteur.
→ Éviter les chemins contenant des espaces. Ces dépannages couvrent les problèmes les plus fréquents rencontrés par les utilisateurs ConTeXt, du niveau débutant au niveau avancé.
Annexes du Wikilivre ConTeXt
