◀ Partie I — Premiers pas · Préalables ● Sommaire ● Installation · Windows ▶

Installation de ConTeXt

Objectifs de cette section

Cette page présente les différentes méthodes d’installation de ConTeXt et oriente vers les procédures adaptées à chaque système d’exploitation.

Comprendre les deux formes de ConTeXt : Standalone et version TeXLive.
Savoir quand utiliser ConTeXt Standalone (recommandé).
Identifier la procédure correcte selon Windows, macOS ou Linux.
Connaître les bonnes pratiques avant installation.
Disposer d’une vue d’ensemble des commandes essentielles d’installation.

Cette page est la page d’entrée pour installer ConTeXt. Elle résume les modes d’installation possibles et donne accès aux guides spécifiques :

1. Deux manières d’installer ConTeXt

Il existe deux méthodes principales :

A. ConTeXt Standalone (recommandé)

Version indépendante, à jour, simple à installer, identique sur toutes les plateformes.

mise à jour fréquente (tous les 8–10 jours) ;
moteur LuaMetaTeX intégré ;
aucun conflit avec TeXLive ou LaTeX ;
installation dans un seul dossier ;
fonctionne sur Windows, macOS, Linux.

Conseil

Si vous utilisez ConTeXt pour un travail sérieux, technique ou universitaire, utilisez ConTeXt Standalone.

B. ConTeXt via TeXLive (non recommandé)

La distribution TeXLive contient une version de ConTeXt, mais :

mise à jour annuelle uniquement ;
pas de moteur LuaMetaTeX récent ;
modules incomplets ;
plusieurs fonctionnalités manquent ;
performances inférieures.

Avertissement
La version ConTeXt incluse dans TeXLive est obsolète pour la plupart des usages modernes. Évitez-la sauf besoin de compatibilité ou contrainte institutionnelle.

2. Vue d’ensemble par système d’exploitation

Les instructions détaillées se trouvent dans les pages suivantes :

Principales différences (résumé)

Système	Script d’installation	Chemin recommandé	Particularités
Windows	`first-setup.bat`	`C:\context` ou `C:\Users\Nom\Documents\context`	Variables PATH, configuration TeXworks
macOS	`first-setup.sh`	`~/Documents/context`	Shell zsh, exécution `. setuptex`
Linux	`first-setup.sh`	`~/context`	Dépendance rsync, configuration polices

3. Bonnes pratiques avant l'installation

Choisir un répertoire simple, sans espaces.
Éviter les dossiers protégés (/usr/bin, /Library, etc.).
Garder les .tex dans un dossier séparé de l’installation.
Installer plusieurs versions si nécessaire (stable / beta).
Tester la ligne de commande avant toute configuration complexe.

Astuce : Un dossier context-beta et un dossier context-stable permettent de tester un projet avec deux versions différentes.

4. Principes généraux d'installation Standalone

Quelle que soit la plateforme :

Créer un répertoire dédié (context/).
Télécharger le script first-setup.
Lancer :

./first-setup.sh

ou sous Windows :

first-setup.bat

Initialiser l’environnement :

. tex/setuptex

Tester :

context --version

Ces étapes sont ensuite détaillées dans les pages dédiées à chaque système.

5. Mise à jour de ConTeXt

La mise à jour Standalone s’effectue toujours par :

first-setup.sh

ou sous Windows :

first-setup.bat

Pour tout mettre à jour (modules, polices, goodies) :

first-setup.sh --modules=all --fonts=all --goodies=all

6. Désinstallation

La désinstallation de ConTeXt Standalone est simple :

Supprimer le répertoire d’installation (context/).
Retirer la ligne setuptex du fichier ~/.bashrc, ~/.zshrc ou équivalent.

Vos fichiers de travail (.tex, .pdf) ne sont jamais supprimés.

7. Pages d’installation détaillées

Pour les prérequis généraux : → Préalables