Comment découper un document en plusieurs fichiers ?#

Pour travailler sur un gros document, il est plus pratique de le découper en plusieurs fichiers plus petits. La démarche consiste à faire un fichier principal, depuis lequel sont appellés d’autres fichiers, eux-mêmes pouvant appeler encore d’autres fichiers, et ainsi de suite…

1.  Avec la commande \input#

La commande \input{⟨fichier⟩} permet d’inclure le fichier fichier dans le fichier principal. Cette commande réalise une importation pure et simple. Elle est plutôt réservée à l’importation de fichiers de commandes ou de tableaux. \input revient à faire un copier-coller du contenu du fichier fichier à l’endroit où cette commande est utilisée.

En voici un exemple fictif faisant appel à deux autres fichiers :

\documentclass[french]{article}
  \usepackage[T1]{fontenc}    % Encodage T1 (adapté au français)
  \usepackage{lmodern}        % Caractères plus lisibles
  \usepackage{babel}          % Réglages linguistiques (avec french)

\begin{document}
  \input{partie1.tex}
  \input{partie2.tex}
  \tableofcontents
\end{document}

2.  Avec les commandes \include et \includeonly#

La commande \include{⟨chapitre⟩} permet d’intégrer le fichier chapitre.tex dans le document principal en commençant une nouvelle page. Cette commande réinitialise la numérotation des titres.

La commande \includeonly{⟨chapitre1⟩,⟨chapitre3⟩} permet de n’intégrer que les fichiers qu’elle cite, dès lors qu’ils sont appelés dans le document maître grâce à \include. L’exemple suivant n’affichera donc que deux des quatre chapitres :

\documentclass[french]{report}
  \usepackage[T1]{fontenc}    % Encodage T1 (adapté au français)
  \usepackage{lmodern}        % Caractères plus lisibles
  \usepackage{babel}          % Réglages linguistiques (avec french)

  \includeonly{chapitre1,chapitre3}

\begin{document}
  \tableofcontents
  \include{chapitre1}
  \include{chapitre2}
  \include{chapitre3}
  \include{chapitre4}
\end{document}

Il faut noter que la commande \include ne permet pas d’intégrer un fichier contenant lui-même une commande \include.

La question « Que fait la commande \include ? » donne quelques éléments complémentaires sur cette commande.

Voir aussi

La question « Comment créer un fichier à la volée ? » propose une autre façon de gérer des fichiers externes : en les créant avec votre fichier