Centre d’aide
Des guides clairs et pratiques pour rédiger, compiler et partager des projets LaTeX et Typst.
Compilation et aperçu PDF
Générez un document LaTeX ou Typst, lisez le journal et choisissez comment il est compilé.
Compiler et lire le résultat
Une compilation renvoie le PDF et le journal complet, sans quitter l'éditeur.
Étapes
- Compilez depuis le clavier, la barre d'état ou le bouton de compilation du volet PDF.
- Les erreurs et avertissements sont regroupés dans l'onglet Problèmes ; filtrez par gravité et utilisez Aller au code source.
- Ouvrez l'onglet Sortie pour le journal brut (celui de latexmk pour LaTeX, les messages de Typst lui-même pour Typst) quand un message demande plus de contexte.
- Demandez à l'assistant d'expliquer ou de corriger un problème précis — ou tous — directement depuis la liste.
- Pendant une compilation, cliquez sur Compilation… dans la barre d'état ou sur le bouton de compilation du volet PDF pour l'arrêter.
- Ouvrez le menu de compilation à côté du bouton Compiler et choisissez Vider le cache et recompiler lorsqu'une compilation semble réutiliser des fichiers auxiliaires périmés.
CtrlS ou CtrlEnter compile le projet ; CtrlAltS arrête une compilation en cours ; F8 et ShiftF8 vont au problème suivant et au précédent.
Vérifier le PDF avant de le soumettre
Vérifications du projet comporte quatre onglets : Vérifications source lit le source sans compiler, Références vérifie la bibliographie, PDF lit le PDF compilé lui-même et les avertissements de la dernière compilation, et signale ce que le vérificateur d’un éditeur ou un lecteur remarquerait, et Dernière compilation liste les erreurs et avertissements de la compilation elle-même.
Étapes
- Dans l’onglet Vérifications source, appuyez sur Lancer les vérifications pour analyser le document racine et ses dépendances : les étiquettes et clés de bibliographie en double, les citations et références non définies, les fichiers, images et bibliographies qui manquent peut-être, et les paquets qui exigent XeLaTeX ou LuaLaTeX sont listés.
- Compilez, puis ouvrez Vérifications du projet et choisissez l’onglet PDF.
- Les polices non incorporées et les polices Type 3 (bitmap) sont signalées ; elles proviennent le plus souvent d’une figure exportée par un autre programme.
- Les références et citations non définies, les caractères absents d’une police, les lignes qui dépassent la marge et les pages d’un autre format sont signalés une fois chacun, avec le premier endroit à regarder.
- Une figure ou un tableau plus haut que la page, une compilation qui réclame encore une passe, et un PDF resté d’une compilation antérieure après un échec sont également signalés.
- Activez « Soumission anonyme » dans l’onglet Vérifications source pour être aussi averti lorsque les métadonnées du PDF nomment un auteur.
Choisir le moteur et le fichier racine
Définissez le fichier racine et le moteur LaTeX pour que toute l'équipe compile avec les mêmes réglages.
Étapes
- Ouvrez les paramètres du projet et désignez le fichier .tex racine : celui qui contient \documentclass et qui est passé au compilateur.
- Choisissez le moteur : pdflatex, latex, xelatex ou lualatex. Les polices chargées avec fontspec exigent XeLaTeX ou LuaLaTeX.
- Sélectionnez la version de TeX Live ; en conserver une ancienne est le moyen le plus sûr de reproduire une compilation passée.
- Réglez le mode de compilation : Normal pour le document réel, Rapide (brouillon) pour une vérification structurelle.
Choisissez quand compiler
Compilez manuellement ou activez la compilation automatique après une pause dans la saisie.
Étapes
- Activez Compiler automatiquement pour reconstruire après une pause de frappe, ou laissez-le désactivé et compilez volontairement.
- Activez Arrêter à la première erreur lorsqu'un journal trop long masque la vraie cause.
- Sautez du curseur vers l'endroit correspondant du PDF, et double-cliquez n'importe où dans le PDF, ou faites Cmd/Ctrl-clic, pour revenir à la ligne source.
- Téléchargez le PDF depuis le menu du projet, ou ouvrez-le dans un onglet dédié pour l'imprimer.
CtrlJ va de la source vers le PDF. Quand le focus est dans le PDF, les flèches, Page préc., Page suiv., Début, Fin et Espace font défiler, + et - règlent le zoom, 0 ajuste à la largeur, et CtrlJ revient à la source depuis le texte sélectionné ou le milieu de la vue ; CtrlF ouvre Rechercher dans le PDF.
