Environnement TeX / Distribution TeX

Vue d'ensemble

TeX64 appelle des outils en ligne de commande comme latexmk, lualatex et latexindent. Utilisez une distribution TeX existante ou confirmez le téléchargement et l’installation d’un environnement TeX Live géré.

Pourquoi une distribution TeX est nécessaire

Le paquet de l’application TeX64 n’intègre pas de moteur LaTeX. Il invoque les commandes d’une distribution TeX existante ou gérée par l’application sur votre appareil. 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.

Configuration Windows 10/11

Sous Windows x64, utilisez TeX Live géré, une installation TeX Live normale ou MiKTeX.

TeX Live géré

  • Ouvrez TeX64 > Réglages > Environnement et choisissez l’installation TeX Live gérée.
  • Vérifiez et acceptez le téléchargement. Une installation complète demande plusieurs Go libres et peut prendre du temps.
  • Gardez TeX64 ouvert jusqu’à la fin ; l’installation est placée dans un dossier géré par l’app et détectée automatiquement.

TeX Live (manuel)

  • Téléchargez et exécutez l’installateur Windows officiel de TeX Users Group.
  • Avec plusieurs Go disponibles, choisissez le schéma complet pour limiter les paquets manquants.
  • Ajoutez C:\texlive\<year>\bin\windows au PATH, puis quittez complètement et relancez TeX64.
  • https://www.tug.org/texlive/acquire-netinstall.html

MiKTeX

  • Installez MiKTeX, puis utilisez MiKTeX Console pour les mises à jour et paquets manquants.
  • Activez l’installation des paquets à la demande pour résoudre les fichiers .sty manquants pendant le build.
  • Vérifiez que le dossier bin de MiKTeX est dans le PATH et que lualatex, latexmk et synctex sont disponibles.
  • https://miktex.org/download

Vérifier dans PowerShell

Exécutez ces commandes dans une nouvelle fenêtre PowerShell, puis vérifiez Réglages > Environnement dans TeX64 :

Get-Command lualatex
Get-Command latexmk
Get-Command latexindent
Get-Command synctex

Si une commande est introuvable, corrigez le PATH dans Paramètres Windows > Système > Informations > Paramètres système avancés > Variables d’environnement, puis relancez complètement PowerShell et TeX64.

Dépannage Windows

  • TeX Live : l’année du PATH doit correspondre au dossier installé et se terminer par \bin\windows.
  • MiKTeX : mettez à jour dans MiKTeX Console et installez latexmk ou le paquet signalé dans le journal.
  • Installation gérée : vérifiez la connexion et plusieurs Go libres, réessayez depuis Réglages > Environnement et joignez le journal au support.

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.