Environnement TeX / Distribution TeX

Vue d'ensemble

TeX64 appelle des outils en ligne de commande comme latexmk, lualatex et latexindent pour compiler vos documents. Une distribution TeX doit être préinstallée sur votre système.

Pourquoi une distribution TeX est nécessaire

TeX64 n'embarque pas son propre moteur LaTeX. Il invoque les commandes système de votre Mac. Sans distribution TeX, la compilation est impossible.

  • TeX64 dépend d'outils TeX externes (latexmk, lualatex, synctex)
  • L'installation d'une distribution TeX est un prérequis
  • Sans distribution, TeX64 affichera des erreurs de compilation

Options

MacTeX (recommandé)

  • Taille : ~4 Go
  • URL : https://www.tug.org/mactex/
  • Installation : téléchargez le .pkg et lancez l'installateur
  • Inclus : tout (latexmk, lualatex, latexindent, synctex, tous les paquets)
  • Pour les utilisateurs japonais : inclut les paquets CJK par défaut
  • Idéal pour : débutants, utilisateurs souhaitant zéro configuration

BasicTeX (installation minimale)

  • Taille : ~100 Mo
  • URL : https://www.tug.org/mactex/morepackages.html
  • Après installation : ajoutez manuellement les paquets manquants avec tlmgr
  • Idéal pour : utilisateurs expérimentés souhaitant un usage minimal du disque

TeX Live (manuel)

  • Gérer TeX Live directement en dehors de MacTeX
  • Pour les utilisateurs Homebrew : brew install texlive

Vérification de l'installation

Ouvrez le Terminal et exécutez ces commandes pour vérifier que tous les outils sont trouvés :

which lualatex
which latexmk
which latexindent
which synctex

Tous doivent renvoyer des chemins. Si l'un renvoie rien, l'outil n'est pas installé ou pas dans le PATH.

Dans TeX64 : Réglages > Environnement affiche un état vert/rouge pour chaque outil.

Gestion des paquets (tlmgr)

  • Mettre à jour le gestionnaire de paquets : sudo tlmgr update --self
  • Mettre à jour tous les paquets : sudo tlmgr update --all
  • Installer un paquet : sudo tlmgr install <package>
  • Rechercher des paquets : sudo tlmgr search --global --file <filename>

Configuration du PATH

  • MacTeX ajoute automatiquement /Library/TeX/texbin
  • Homebrew utilise /opt/homebrew/bin
  • Si le PATH n'est pas défini : ajoutez export PATH="/Library/TeX/texbin:$PATH" à ~/.zshrc
  • Redémarrez le Terminal et TeX64 après une modification du PATH

Configuration LaTeX japonais

  • MacTeX : inclut les paquets CJK par défaut
  • BasicTeX : installez les paquets japonais séparément : sudo tlmgr install collection-langjapanese
  • Utilisez le paquet luatexja avec lualatex
  • Ajoutez \usepackage{luatexja} à votre fichier .tex

Problèmes courants

latexmk introuvable

Installez MacTeX ou exécutez sudo tlmgr install latexmk

Fichier .sty manquant

Exécutez sudo tlmgr install <package>

Problèmes de PATH

Ajoutez-le au profil du shell

Permission refusée

Utilisez sudo

Si vous avez des questions ou besoin d'assistance, consultez la page de support.