Les fichiers d’un vrai projet
.tex, .bib, .cls, .sty et les fichiers générés qu’il ne faut pas ajouter aux commits.
Les fichiers d’un vrai projet
Ouvrez le dossier de n’importe quel vrai projet LaTeX après une compilation et vous y trouverez bien plus de fichiers que ceux que vous avez écrits. Cela surprend la plupart des débutants, et la peur de supprimer le mauvais fichier laisse les dossiers encombrés à jamais. La distinction qui lève le doute : certains fichiers sont des sources que vous modifiez, d’autres sont des styles fournis par un modèle ou un paquet, et le reste est un espace de travail temporaire généré que le compilateur recrée à chaque exécution.
Les fichiers que vous écrivez
Vos fichiers .tex contiennent le document proprement dit : le texte, les sections, les figures et les formules. Un fichier .bib est votre base de données bibliographique, avec une entrée par article ou livre que vous pourriez citer ; vous pouvez la tenir à la main ou l’exporter depuis un gestionnaire de références comme Zotero. Ce sont les fichiers qui valent la peine d’être sauvegardés et placés sous gestion de versions, car tout le reste peut être reconstruit à partir d’eux.
Les fichiers fournis par un modèle
Un fichier .cls définit une classe de document, ce que vous nommez dans \documentclass{...}. Les revues et les conférences fournissent la leur pour que toutes les soumissions se ressemblent, et vous n’en modifiez presque jamais. Un fichier .sty est un paquet : des macros et des réglages réutilisables chargés avec \usepackage. Vous n’en écrirez un vous-même que lorsque vous voudrez partager des commandes personnalisées entre plusieurs documents. Un fichier .bst décrit un style de citation BibTeX et est lui aussi généralement simplement fourni par la revue ou la conférence.
Les fichiers que le compilateur produit
Le fichier .aux stocke les données de références croisées et de citations entre les passes de compilation ; ne le modifiez jamais, et n’hésitez pas à le supprimer, puisque la compilation suivante le réécrit. Le fichier .log consigne tout ce que le compilateur a fait et ne mérite d’être ouvert que lorsque quelque chose tourne mal. Le .pdf est le résultat que vous vouliez vraiment.
| Extension | Rôle | À modifier à la main ? |
|---|---|---|
.tex | Documents sources et chapitres | Oui |
.bib | Base de données bibliographique | Oui (ou export depuis Zotero) |
.cls | Classe de document | Rarement, modèles des éditeurs |
.sty | Paquets / fichiers de style | Quand vous écrivez vos propres macros |
.bst | Style BibTeX | Rarement |
.aux | Données de références croisées | Non : généré |
.log | Journal du compilateur | À lire pour déboguer |
.pdf | Résultat | À consulter / soumettre |
Une organisation de projet qui passe à l’échelle
paper/ main.tex chapters/ figures/ refs.bibUn seul main.tex à la racine sert de point d’entrée, les chapitres vivent dans leur propre dossier et sont inclus avec \input ou \include, les images se trouvent dans figures/, et la bibliographie reste dans un seul refs.bib. Cette organisation reste gérable que le projet soit un article de quatre pages ou une thèse. Répartir les chapitres en fichiers montre comment les pièces s’articulent.
Si vous utilisez Git, ajoutez *.aux, *.log et les autres fichiers générés à .gitignore pour que votre historique ne suive que de vraies sources. Les projets Oleafly sont de simples dossiers sur le disque, ce conseil s’y applique donc tel quel. L’erreur la plus courante est l’inverse : quand on traque une étrange erreur de compilation, supprimer les fichiers .aux est souvent la solution, car un fichier périmé issu d’une exécution défaillante peut empoisonner toutes les compilations suivantes.