Un fichier racine, plusieurs chapitres

include contre input, includeonly, et rédiger un chapitre à la fois.

Un fichier racine, plusieurs chapitres

Une thèse dans un seul fichier .tex devient pénible à travailler vers le deuxième chapitre : le défilement remplace la réflexion, et chaque compilation traite tout. Le remède classique est un fichier racine qui contient la classe et le préambule, avec chaque chapitre dans son propre fichier. Le fichier racine les assemble.

Le fichier racine

% main.tex
\documentclass{report}
\begin{document}
\include{chapters/intro}
\include{chapters/methods}
\include{chapters/results}
\end{document}

main.tex est le seul fichier que vous compilez jamais. Chaque \include désigne un autre fichier sans son extension .tex, avec des barres obliques (/) sur toutes les plateformes, et en insère le contenu à cet endroit. Les fichiers de chapitre ne contiennent eux-mêmes que du contenu, généralement à partir de \chapter{...}. Ils n’ont ni \documentclass ni environnement document à eux, car ce sont des fragments de ce document, pas des documents.

include contre input

Les deux commandes d’inclusion se comportent différemment, et ces différences décident laquelle utiliser et où. \include commence une nouvelle page avant le contenu, ce qui convient aux chapitres, et écrit un fichier .aux distinct pour chaque fichier inclus, ce qui rend possible la compilation sélective. \input est un simple collage de texte : pas de saut de page, pas de .aux séparé, et il peut être imbriqué dans un autre \input. C’est donc le bon outil pour les fragments plus petits qu’un chapitre, comme un grand tableau conservé dans son propre fichier ou un fichier de macros partagé. Une règle de structure à retenir : \include ne peut pas être imbriqué dans un fichier lui-même inclus, alors que \input peut s’utiliser n’importe où.

Rédiger un chapitre à la fois

\includeonly{chapters/methods}

Placé dans le préambule, \includeonly indique à LaTeX de ne traiter que les fichiers listés tout en continuant à lire les données .aux enregistrées de tous les autres. La compilation devient bien plus rapide, et comme les étiquettes et les nombres de pages des autres chapitres sont rejoués à partir de leurs fichiers .aux, les références croisées et la numérotation du chapitre que vous rédigez restent justes. Cette seconde moitié est la raison de préférer cette méthode à la mise en commentaire de lignes \include, qui oublie complètement les autres chapitres et transforme chaque \ref vers eux en ??.

Mettez la ligne \includeonly en commentaire pour les compilations complètes, et lancez toujours une compilation complète avant de partager un PDF, car des données .aux périmées peuvent être en retard sur les modifications faites dans les chapitres exclus. Pour savoir quels fichiers du dossier obtenu sont les vôtres et lesquels sont générés, voir les fichiers d’un vrai projet.

Retour à Forme longue