Écrivez en LaTeX et prévisualisez le PDF

Exportez le projet sous forme d'archive ZIP après les sessions d'édition importantes et avant de modifier le fichier racine, le moteur, les paquets ou l'arborescence des dossiers. L'archive doit contenir les fichiers sources et les ressources ajoutées nécessaires pour poursuivre le projet ailleurs. Un PDF téléchargé n'est que le résultat compilé et ne peut remplacer la source modifiable. Ouvrez le ZIP et vérifiez que les chapitres, les fichiers de bibliographie, les images, les classes personnalisées et les fichiers de style sont présents avant de l'utiliser comme copie de référence du projet.

Utilisez dans la mesure du possible le moteur déjà spécifié par un projet existant. pdfLaTeX est un choix pratique pour de nombreux documents et paquets établis. XeLaTeX est souvent préférable lorsque la source nécessite une prise en charge étendue d'Unicode, des polices système ou des fonctionnalités de police OpenType. Changer de moteur peut modifier les métriques des polices, les sauts de ligne, le comportement des paquets et la pagination finale. En cas de doute, consultez la documentation du projet et comparez une compilation propre de pages représentatives, d'équations, de références et de textes non latins.

Commencez par examiner le premier message de diagnostic utile, car les messages ultérieurs découlent souvent de cette même erreur initiale. Les causes fréquentes incluent une commande inconnue, des accolades non fermées, un fichier manquant, un chemin incorrect, un paquet incompatible avec le moteur sélectionné ou un document racine sans environnement document. Corrigez une cause à la fois et relancez la compilation. Lorsqu'une erreur renvoie à un fichier généré, inspectez la commande source qui a créé la table des matières, la citation, l'étiquette ou l'entrée auxiliaire concernée.

Les renvois et les bibliographies peuvent nécessiter plusieurs compilations successives, car LaTeX écrit d'abord les informations auxiliaires avant de les lire lors d'une passe ultérieure. Vérifiez que chaque étiquette est unique, que chaque référence utilise le nom exact de l'étiquette, que les clés de citation correspondent aux entrées bibliographiques et que le fichier de bibliographie est inclus selon la méthode appropriée. Corrigez les erreurs de compilation avant d'évaluer les références. Si des points d'interrogation subsistent, inspectez le tout premier diagnostic lié aux citations ou aux fichiers auxiliaires et vérifiez que le moteur sélectionné ainsi que les commandes de bibliographie correspondent au projet.

Une compilation réussie indique qu'un PDF a été produit, mais pas que le document est exempt d'erreurs. Contrôlez la page de titre, l'ordre des pages, les titres, les tableaux, les figures, les équations, les notes de bas de page, les liens, les citations, la bibliographie, les en-têtes, les pieds de page, les marges et les sauts de page. Repérez les lignes trop longues qui dépassent, les graphiques rognés, les glyphes manquants, les points d'interrogation non résolus, les pages blanches inattendues et les substitutions de polices. Pour un document important, comparez des pages représentatives au zoom normal et à l'échelle d'impression, puis assurez-vous que les liens et la sélection de texte fonctionnent correctement.

Identifiez le fichier .tex racine prévu et conservez des chemins relatifs cohérents pour les chapitres, images, bibliographies, classes et fichiers de style. Les projets qui dépendent de commandes shell, de programmes externes, de polices système inhabituelles, de paquets indisponibles ou d'une distribution TeX différente peuvent nécessiter des ajustements avant de compiler. Les noms de fichiers sont plus sûrs lorsque leur casse respecte rigoureusement chaque référence du code source. Après l'importation, compilez d'abord une section courte connue, examinez les diagnostics, puis vérifiez l'ensemble du document pour repérer d'éventuels écarts propres aux paquets ou des ressources manquantes.