Dépannage

La plupart des échecs de build sont liés à l'environnement TeX ou à des paquets manquants. Ce guide présente les problèmes courants et leurs solutions, symptôme par symptôme.

Commandes de diagnostic

Ouvrez le Terminal et exécutez :

which lualatex which latexmk which latexindent which synctex

Vérifiez aussi dans TeX64 : Réglages > Environnement pour valider l'état de l'environnement

Problèmes d'environnement TeX

« latexmk not found »

Cause : Distribution TeX non installée ou absente du PATH

Correctif :

  • Installez MacTeX depuis https://www.tug.org/mactex/
  • Ou : sudo tlmgr install latexmk
  • Vérifier : which latexmk
  • Redémarrez TeX64 après installation

« lualatex not found »

Cause : Distribution TeX non installée

Correctif : Installez MacTeX (inclut lualatex)

« latexindent not found »

Correctif :

sudo tlmgr install latexindent

Remarque : latexindent est facultatif (pour le formatage du code), le build fonctionne sans lui

« synctex not found »

Correctif : inclus dans MacTeX par défaut, ou : sudo tlmgr install synctex

Sans synctex, la navigation SyncTeX ne fonctionnera pas

Paquet .sty manquant

Erreur : « File xxx.sty not found »

Correctif :

sudo tlmgr install <package-name>

Pour rechercher :

tlmgr search --global --file <filename>

Problèmes de PATH

Vérifier : echo $PATH

Doit inclure /Library/TeX/texbin pour MacTeX ou /opt/homebrew/bin pour Homebrew

Correctif : Ajoutez à ~/.zshrc : export PATH="/Library/TeX/texbin:$PATH"

Redémarrez le Terminal et TeX64

Problèmes de build

Le build échoue avec des erreurs

Consultez le panneau de sortie de build pour les messages d'erreur. Cliquez sur une erreur pour sauter à la ligne source.

Causes courantes : fautes de frappe dans les commandes LaTeX, accolades non appariées, paquets manquants

Astuce : utilisez l'IA (Axiom) pour diagnostiquer – collez l'erreur ou demandez dans le chat

Le PDF ne se met pas à jour

Le PDF n'est mis à jour que pour les builds RÉUSSIS. Vérifiez la sortie de build pour des erreurs.

Reconstruisez avec le bouton de build de la barre d’outils.

Le build est lent

Les gros projets avec beaucoup d'images prennent plus de temps.

latexmk utilise une compilation incrémentale – les builds suivants sont plus rapides.

Le premier build peut être lent à cause des téléchargements de paquets

Problèmes SyncTeX

SyncTeX ne fonctionne pas

Vérifier que synctex est installé : which synctex

Reconstruisez le projet avec le bouton de build de la barre d’outils pour générer le fichier .synctex.gz

Vérifiez la coche verte dans Réglages > Environnement

SyncTeX saute au mauvais endroit

Certains paquets LaTeX interfèrent avec le mappage source

Projets multi-fichiers : assurez-vous que les chemins \input/\include sont corrects

Problèmes macOS

Gatekeeper

Contrôle+clic (clic droit) → Ouvrir Ou : Réglages Système > Confidentialité et sécurité > Autoriser

Autorisation Enregistrement d'écran (pour l'OCR)

Réglages Système > Confidentialité et sécurité > Enregistrement d'écran > activer TeX64

Il faut peut-être redémarrer TeX64 après l'octroi de l'autorisation

« App is Damaged »

Téléchargez à nouveau le DMG. Vérifiez la bonne architecture (Apple Silicon vs Intel)

Problèmes IA/Axiom

Fonctionnalités IA indisponibles

Assurez-vous d'être connecté, puis vérifiez votre compte : Compte > Facturation

L'IA (chat et complétion) est incluse dans tous les plans, y compris un petit quota d'essai mensuel sur le plan gratuit. La raison la plus fréquente d'un arrêt est l'épuisement de votre quota de jetons mensuel (ou un paiement en retard) – rechargez ou attendez le prochain cycle.

Vérifiez le quota de jetons : Compte > Utilisation

Vérifiez la connexion Internet

Réponses IA lentes ou expiration

Vérifiez la connexion Internet

Le serveur peut être surchargé – réessayez dans un instant

Limite de débit : 30 requêtes/minute

Compte et connexion

Échec de la connexion Google

Vérifiez la connexion Internet. Essayez d'effacer les cookies/cache du navigateur. Reconnectez-vous.

Abonnement non pris en compte

Les changements de facturation peuvent prendre quelques minutes

Si le paiement a échoué, mettez à jour le moyen de paiement via le portail de facturation Stripe

Période de grâce : 3 jours après l'échec du paiement avant désactivation des fonctionnalités

Problèmes de Galerie

Limites de publications : Free=10, Basic=100, Pro=500

Limite quotidienne : 10 publications par jour

Taille d'image : 20 Mo max. Source TeX : 500 000 caractères max. Tags : 8 max par publication.

Obtenir de l'aide

Utilisez le chat IA pour décrire les problèmes (il peut lire les logs de compilation)

Contactez le support à /feedback

À inclure : version de macOS, version de TeX64, message d'erreur, étapes pour reproduire

Le diagnostic d'erreurs optionnel peut être activé dans Réglages > Confidentialité

Astuce : Pour diagnostiquer les problèmes de build, commencez par exécuter les commandes de diagnostic afin de vérifier la configuration de votre environnement TeX. La plupart des problèmes proviennent de l'environnement.