Centre d’aide
Des guides clairs et pratiques pour rédiger, compiler et partager des projets LaTeX et Typst.
Résoudre les problèmes
Régler les soucis courants de compilation, d'accès et d'espace de travail.
Ce guide est rédigé pour
Commencer par les détails
Les messages d'erreur désignent en général le fichier source ou l'action à traiter.
Étapes
- Lisez le message, le fichier qu'il cite et la dernière modification.
- Reproduisez-le volontairement une fois, pour savoir si c'est le document ou seulement l'instant.
- Réessayez le guide concerné ; si le problème persiste, écrivez au support avec le nom du projet et le détail de l'erreur.
Quand la compilation échoue ou patine
Une compilation en échec et une compilation occupée se ressemblent dans la barre d'état, mais appellent des réponses opposées.
Étapes
- En cas d'échec, ouvrez le panneau Problèmes et partez de la première erreur : les suivantes en découlent souvent.
- Utilisez Expliquer ou Corriger de l'IA sur un diagnostic quand le message reste obscur.
- Les compilations s'exécutent une à la fois par personne : une compilation automatique plus récente remplace celle qui attendait, et une compilation explicite peut vous demander de réessayer dans un instant.
- Un message indiquant que le service de compilation n'a pas pu traiter la demande vise le service, pas votre document : réessayez, puis contactez le support si cela dure.
- Une compilation arrêtée pour avoir dépassé la limite de temps, ou épuisé son espace ou sa mémoire, ne passera pas à un nouvel essai : cherchez une boucle, un paquet coûteux ou des images très volumineuses, ou scindez le document.
- Si une compilation échoue sans cesse sur des fichiers auxiliaires périmés, ou si les sauts entre la source et le PDF ne fonctionnent plus, ouvrez le menu de compilation et choisissez Vider le cache et recompiler.
Quand la cause est le projet lui-même
Certains échecs tiennent à l'emplacement des fichiers ou au volume du projet, pas à la source de la ligne que l'erreur désigne.
Étapes
- Une erreur de fichier manquant juste après le déplacement ou le renommage d'un fichier signifie en général qu'un chemin désigne encore l'ancien emplacement : choisissez Mettre à jour sur l'avis qui suit un déplacement, ou corrigez vous-même le chemin (\input ou \includegraphics en LaTeX, #include ou #image en Typst).
- Un avertissement indiquant que le projet approche de sa limite de taille signifie que les nouveaux fichiers et les modifications ne pourront plus être enregistrés une fois le projet plein ; supprimez les fichiers devenus inutiles ou scindez le projet.
- Quand le service de compilation est occupé ou indisponible, l'avis renvoie vers l'application de bureau, qui peut compiler avec le LaTeX de votre propre ordinateur ; dans l'application, un projet réglé pour compiler sur le serveur se voit proposer Compiler plutôt sur cet ordinateur.
Problèmes d'accès et de connexion
Ne pas pouvoir ouvrir quelque chose relève presque toujours de l'état du compte ou de la connexion, pas d'un projet perdu.
Étapes
- Si le survol du point d'enregistrement dans la barre d'état indique que vous travaillez hors ligne, continuez d'écrire : les modifications restent dans le navigateur et se synchronisent au retour de la connexion.
- Évitez de vous déconnecter hors ligne : la déconnexion efface ces copies locales.
- Un projet que vous n'ouvrez plus signale qu'il est introuvable ; demandez au propriétaire si l'accès a changé ou si le projet est à la corbeille.
- Une adresse e-mail non vérifiée ou un compte suspendu bloquent toute l'application, pas un seul projet.
Quand un projet Typst se comporte différemment
Un projet Typst est compilé dans la page au fil de l'écriture et, dans un navigateur, sur le serveur pour les téléchargements : la plupart des surprises tiennent donc à celui des deux qui a produit l'aperçu.
Étapes
- Le PDF ne suit pas votre frappe, ou les sauts entre la source et le PDF ne fonctionnent pas : c'est le serveur qui compile l'aperçu, pas la page. Vérifiez Compiler automatiquement dans le menu de compilation, mettez le navigateur à jour et rechargez la page. Un document dont le texte n'est pas couvert par les polices de la page est lui aussi compilé sur le serveur.
- Une erreur de paquet introuvable pour un import @local est normale : seuls les paquets @preview sont disponibles.
- Un ZIP ou un dépôt importé qui contient plusieurs fichiers .typ sans main.typ à son premier niveau reçoit comme fichier racine le fichier .typ qu'aucun autre n'importe ni n'inclut. Si ce n'est pas votre document, ouvrez les paramètres du projet et choisissez le fichier racine .typ.
- Un message indiquant que le service de compilation ne sait pas encore compiler les documents Typst vient du service, pas de votre document : réessayez plus tard.