Projets en plusieurs fichiers

Gardez le préambule et \begin{document} dans main.tex et intégrez les autres fichiers avec \input{chapters/intro} ou \include{chapters/intro} ; Scissor LaTeX les réunit en un seul document avant de le composer.

Pourquoi diviser un document

Une thèse ou un long rapport se travaille plus facilement en morceaux : un fichier par chapitre, un pour le préambule, un pour l’annexe. LaTeX a deux commandes pour cela, et les deux fonctionnent dans Scissor LaTeX.

Un petit projet

Un projet typique comporte un fichier principal et un dossier de chapitres :

main.tex
preamble.tex
chapters/intro.tex
chapters/method.tex
refs.bib

Le fichier principal contient la classe, le préambule et le corps du document, et intègre le reste :

\documentclass{report}
\input{preamble}

\title{Rainfall at Two Sites}
\author{Erika Mustermann}

\begin{document}
\maketitle
\input{chapters/intro}
\input{chapters/method}
\bibliographystyle{plain}
\bibliography{refs}
\end{document}

Chaque fichier de chapitre ne contient que sa partie du texte, sans préambule ni \begin{document} :

\chapter{Introduction}
\label{chap:intro}
Rain gauges were read every morning for 44 days.
The method is described in Chapter~\ref{chap:method}.

Scissor LaTeX remplace chaque \input et \include par le texte du fichier et compose le résultat comme un seul document. Les étiquettes, les renvois et les citations fonctionnent d’un fichier à l’autre, car pour le compositeur tout ne forme qu’un seul texte.

À quoi ressemble le document réuni

Voici ce que l’éditeur compose quand main.tex intègre deux fichiers de chapitre avec \input : le texte des deux fichiers, dans l’ordre. (L’exemple est écrit en un seul fichier pour pouvoir être affiché ici.) Dans un report ou un book, \chapter fait commencer de lui-même chaque chapitre sur une nouvelle page.

Deux fichiers de chapitre réunis en un seul document

LaTeXCopierOuvrir dans l'éditeur (s’ouvre dans un nouvel onglet)

\documentclass{report}
\begin{document}
\chapter{Introduction}
\label{chap:intro}
Rain gauges were read every morning for 44 days.
The method is described in Chapter~\ref{chap:method}.
\chapter{Method}
\label{chap:method}
Each gauge was emptied after reading, as noted in
Chapter~\ref{chap:intro}.
\end{document}

Comment les noms de fichiers sont trouvés

• Les chemins sont relatifs au dossier racine du projet, comme ils sont relatifs au dossier du fichier principal en LaTeX, y compris dans les fichiers imbriqués.
• L’extension .tex peut être omise : \input{chapters/intro} trouve chapters/intro.tex.
• Les guillemets autour d’un nom, comme dans \input{"my file"}, sont retirés.
• Un fichier manquant est signalé comme une erreur dans l’onglet Problèmes, avec la ligne de l’\input. Le reste du document est quand même composé.
• Un fichier qui s’inclut lui-même, directement ou par l’intermédiaire d’autres, est omis avec un message, et l’imbrication s’arrête après 24 niveaux.

subfiles et \includeonly

Le package subfiles permet de compiler chaque chapitre séparément. Scissor LaTeX ne suit pas \subfile : la commande est ignorée et l’onglet Problèmes indique qu’un fichier n’a pas été inclus.

\documentclass{article}
\usepackage{subfiles}
\begin{document}
The chapter below is not included:
\subfile{chapters/intro}
Replace it with an \verb|\input| line.
\end{document}

Pour travailler sur un chapitre à la fois, mettez en commentaire les autres lignes \include avec %. \includeonly est accepté mais n’a aucun effet : chaque fichier inclus est composé. Il en va de même pour \lstinputlisting et \inputminted, ignorés avec le même message (voir Listings de code).

Autres fichiers du projet

Les images, les fichiers .bib et les fichiers de données peuvent se trouver dans n’importe quel dossier ; désignez-les par leur chemin depuis le dossier racine, comme \includegraphics{figures/plot.png}. Tous les fichiers .bib du projet servent aux citations, quel que soit le nom donné à \bibliography (voir Bibliographies). Pour importer un projet entier depuis une installation TeX, voir Projets et fichiers.

Différences avec une installation TeX

Les manuels des packages concernés sont sur CTAN : subfiles et import.

Chaque exemple de cette page est composé par Scissor LaTeX lors de la génération du site. Dernière mise à jour : 2026-11-07.