ConTeXt/Installation/macOS

Partie 1 : Premiers pas

Chapitre 2 : Installation

← Page précédente : Installation de ConTeXt sous Windows |Sommaire du Wikilivre ConTeXt | Page suivante : Installation de ConTeXt sous Linux →

Installation de ConTeXt sous macOS

Objectifs de cette section

• Installer ConTeXt Standalone sur macOS ;
• Configurer l’environnement (setuptex) pour compiler depuis n’importe quel répertoire ;
• Installer les modules, polices et "goodies" complets ;
• Configurer les polices système via OSFONTDIR ;
• Effectuer un premier test et mettre à jour ConTeXt ;
• Désinstaller proprement ConTeXt Standalone.

• Cette page décrit l'installation de ConTeXt Standalone sous macOS.
• Elle suppose que vous avez lu le chapitre Préalables.

---

---

Choix du répertoire d'installation

Sous macOS, il est conseillé d’installer ConTeXt dans votre dossier utilisateur, par exemple :

• ~/Documents/context

La suite de cette page suppose l’utilisation de ce répertoire.

---

---

Préparation du répertoire

Ouvrez Terminal, puis saisissez :

mkdir -p ~/Documents/context
cd ~/Documents/context

---

---

Téléchargement du script first-setup

La méthode recommandée utilise rsync :

rsync -av rsync://contextgarden.net/minimals/setup/first-setup.sh .

Cela télécharge le fichier first-setup.sh dans le répertoire courant.

Rendez-le exécutable :

chmod +x first-setup.sh

---

---

Installation de ConTeXt

Toujours dans ~/Documents/context :

sh ./first-setup.sh

Cette commande :

• télécharge ConTeXt Standalone ;
• crée l’arborescence interne dans tex/.

La première installation peut prendre quelques minutes.

Note
L’installation initiale est complète : aucun autre programme n’est requis.

---

Initialisation de l'environnement ConTeXt

Après l'installation, activez l’environnement ConTeXt :

. ~/Documents/context/tex/setuptex

(Remarquez le point débutant la commande.)

Vérifiez :

context --version

---

Génération des fichiers internes

Il est conseillé d’exécuter :

context --generate
context --make
mtxrun --script fonts --reload

Ces commandes :

• génèrent les structures internes ;
• compilent les formats nécessaires ;
• rechargent la base de données des polices.

---

---

Installation complète (polices, modules, goodies)

Pour installer :

• toutes les polices ;
• tous les modules ;
• les goodies supplémentaires :

sh ./first-setup.sh --context=beta --fonts=all --modules=all --goodies=all --engine=luatex

---

---

Utilisation de ConTeXt

Après avoir activé l’environnement :

. ~/Documents/context/tex/setuptex

vous pouvez compiler un fichier .tex :

cd /chemin/vers/mon/projet
context monfichier.tex

Activation automatique à chaque session

Ajoutez à votre fichier ~/.zshrc (ou ~/.bashrc) :

. ~/Documents/context/tex/setuptex

Astuce : Sous macOS (depuis Catalina), le shell par défaut est zsh. Assurez-vous d’éditer le bon fichier (~/.zshrc).

---

---

Gestion des polices sous macOS

ConTeXt peut utiliser :

• ses polices internes ;
• les polices système de macOS :

 * ~/Library/Fonts  
 * /Library/Fonts  
 * /System/Library/Fonts

Déclarez la variable OSFONTDIR :

export OSFONTDIR=~/Library/Fonts:/Library/Fonts:/System/Library/Fonts

Ajoutez-la à votre ~/.zshrc si nécessaire.

Rechargez les polices :

mtxrun --script fonts --reload

---

---

Premier test

Créez un dossier de test :

mkdir -p ~/Documents/ConTeXtTests
cd ~/Documents/ConTeXtTests

Créez test-context.tex :

\starttext
Mon premier test de ConTeXt sous macOS !
\stoptext

Compilez :

context test-context.tex

Un PDF nommé test-context.pdf doit apparaître.

---

---

Mise à jour de ConTeXt sous macOS

Pour mettre à jour :

1. Ouvrez Terminal.
2. Placez-vous dans le répertoire d’installation :

cd ~/Documents/context

1. Lancez :

sh ./first-setup.sh

Mise à jour complète :

sh ./first-setup.sh --modules=all

---

---

Désinstallation

Pour désinstaller ConTeXt Standalone :

1. Supprimez le répertoire :

rm -rf ~/Documents/context

1. Facultatif : supprimez la ligne setuptex dans ~/.zshrc.

Vos fichiers de travail (dans d’autres répertoires) ne sont pas affectés.

---

Navigation

← Page précédente : Installation de ConTeXt sous Windows |Sommaire du Wikilivre ConTeXt | Page suivante : Installation de ConTeXt sous Linux →