ConTeXt/Préalables/Lignes de commande
Partie I : Premiers pas
Chapitre 1 : Préalables/Ligne de commande
Lignes de commande dans ConTeXt
[modifier | modifier le wikicode]Objectifs de cette section
Cette page présente tout ce qu’il faut savoir avant l’installation de ConTeXt :
- Comprendre comment utiliser la ligne de commande, même avec Windows ;
- savoir naviguer dans les répertoire et trouver des fichiers ;
- connaître les principes de la ligne de commande ;
- passer des commandes en mode 'console' ;
ConTeXt est conçu pour fonctionner avant tout en ligne de commande.
Même si vous utilisez le logiciel TeXworks ou tout autre type d'éditeur (graphique ou non), la plupart des des opérations reposent sur les commandes décrites ici.
Cette page explique :
- comment lancer ConTeXt ;
- comment compiler un document ;
- comment résoudreles erreurs ;
- où trouver les fichiers générés ;
- comment lire les fichiers `.log` ;
- quelles sont les commandes utiles pour diagnostiquer un problème.
1. Préparer l’environnement
[modifier | modifier le wikicode]Sous Windows
[modifier | modifier le wikicode]Ouvrez l’invite de commandes (CMD), puis exécutez :
C:\context\tex\setuptex.bat
ou, si ConTeXt est installé dans un autre dossier :
C:\Users\Nom\Documents\context\tex\setuptex.bat
Cela prépare les variables d’environnement et rend la commande `context` disponible.
Sous macOS / Linux
[modifier | modifier le wikicode]Dans un terminal :
source ~/context/tex/setuptex
ou :
. ~/context/tex/setuptex
Astuce 
|
Vous pouvez ajouter cette ligne dans votre ~/.bashrc ou ~/.zshrc afin que ConTeXt soit disponible automatiquement à chaque session.
|
2. Commandes essentielles
[modifier | modifier le wikicode]Compiler un fichier
[modifier | modifier le wikicode]context fichier.tex
La sortie PDF est générée dans le même dossier. Avec TexWork, l'affichage de la sortie PDF est parallèle (sur votre écran) à l'affichage du texte source.
Compilation automatique → PDF
[modifier | modifier le wikicode]context --autopdf fichier.tex
Compilation sans interruption
[modifier | modifier le wikicode](utile si vous souhaitez que le processus continue malgré les erreurs)
context --nonstopmode fichier.tex
Compiler une seule fois
[modifier | modifier le wikicode](ne relance pas les passes de compilation automatiques)
context --once fichier.tex
Purger les fichiers auxiliaires
[modifier | modifier le wikicode]context --purgeall fichier.tex
Vérifier la version installée
[modifier | modifier le wikicode]context --version
Mettre à jour ConTeXt (LMTX)
[modifier | modifier le wikicode]context --update
Rafraîchir les polices
[modifier | modifier le wikicode]mtxrun --script fonts --reload
3. Où se trouvent les fichiers générés ?
[modifier | modifier le wikicode]Dans le même dossier que le fichier `.tex`, vous trouverez :
fichier.pdf— le résultat finalfichier.log— journal de compilationfichier.tuc— données auxiliaires internesfichier-mpgraph.mp— fichiers MetaPost éventuelsfichier.mkiv— fichiers internes générés
| Astuce
|
Si un document ne compile plus, commencez par supprimer *.tuc et *.log.
|
4. Lire le fichier .log : outil indispensable
[modifier | modifier le wikicode]Le fichier .log contient toutes les informations utiles pour comprendre une erreur.
Cherchez en priorité :
- **
!** (erreur critique) - **
error** - **
undefined** - **
missing**
Erreur fréquente : "undefined control sequence"
[modifier | modifier le wikicode]Cause :
- faute de frappe dans une commande
- module non chargé
- commande LaTeX utilisée par erreur
Erreur : problème de police
[modifier | modifier le wikicode]Exemple dans le `.log` : "font fallback failed for unicode slot ..."
Solutions :
- vérifier `OSFONTDIR`
- relancer :
mtxrun --script fonts --reload
- vérifier la syntaxe de `definefontfamily`
- vérifier la présence réelle de la police sur le système
Erreur : “missing }”
[modifier | modifier le wikicode]Quasi toujours due à :
- un oubli de `}`
- une accolade ouverte dans une note de bas de page
Astuce : vérifiez dans le fichier source les lignes juste avant celle indiquée dans le log.
5. Tableaux pratiques
[modifier | modifier le wikicode]Tableau : commandes essentielles
[modifier | modifier le wikicode]| Action | Commande |
|---|---|
| Compiler | context fichier.tex
|
| Ouvrir PDF automatiquement | context --autopdf fichier.tex
|
| Ignorer les erreurs | context --nonstopmode fichier.tex
|
| Purger les sorties | context --purgeall fichier.tex
|
| Mettre à jour | context --update
|
| Lister les polices | mtxrun --script fonts --list
|
Tableau : préparation de l’environnement
[modifier | modifier le wikicode]| Système | Commande |
|---|---|
| Windows | setuptex.bat
|
| macOS/Linux | source setuptex
|
6. Problèmes courants et solutions
[modifier | modifier le wikicode]Le PDF ne s’ouvre pas
[modifier | modifier le wikicode]Utilisez :
context --autopdf fichier.tex
"Unknown file format"
[modifier | modifier le wikicode]Vous avez tenté :
context fichier.pdf
Solution : ne compiler que des `.tex`.
Les accents s’affichent mal
[modifier | modifier le wikicode]Le fichier doit être en **UTF-8 sans BOM**.
Une police ne s’affiche pas
[modifier | modifier le wikicode]Choses à vérifier :
- emplacement correct des fichiers `.otf`
- variable `OSFONTDIR`
- rechargement :
mtxrun --script fonts --reload
Le document compile mais MetaPost échoue
[modifier | modifier le wikicode]Relancer MetaPost seul pour voir l’erreur :
mtxrun --script meta fichier.mp
7. Aller plus loin
[modifier | modifier le wikicode]Pour aller plus loin :
- page « Tester les polices »
- page « Polices et familles de polices »
- page « MetaPost et MetaFun »
- page « Bibliographie et index »
- page « Projets, environnements et modules »
Ces pages prolongent l’apprentissage en montrant comment utiliser les commandes en situation réelle.