Créer des documents multifichiers

Exploiter le fichier maître et le préambule

Le fichier maître, maitre.tex, comporte une structure très classique, avec la déclaration de la classe de document commune à tous les fichiers inclus. Dans cet exemple, nous utilisons un livre, book, bien adapté à notre projet.

Pour décomposer au mieux notre projet, nous créons un fichier spécifique pour le préambule, nommé preambule.tex. Ce fichier contient tous les packages communs à tous les fichiers du projet.

Voici son contenu :

% Les packages communs 
\usepackage[utf8]{inputenc} 
\usepackage[french]{babel} 
\usepackage[T1]{fontenc} 
\usepackage{lmodern} 

Dans le fichier maître, pour inclure le fichier du préambule, utilisez la commande \input{Nom du fichier}. Cela permet d’inclure des petits fichiers, comme ce préambule ou des fichiers de commandes LaTeX personnalisées.

Dans le fichier maître, nous avons, en début de fichier :

\documentclass[11pt,a4paper]{book} 
\input{preambule} 

Vous remarquerez qu’il n’est pas nécessaire d’indiquer l’extension des fichiers inclus, .tex, qui est l’extension implicite.

Toujours dans le fichier maître, vous pouvez ajouter les commandes pour avoir une page de garde avec l’auteur (\author), le titre...

Connaître la structure des fichiers inclus

Les trois fichiers inclus, partie01.tex, partie02.tex et partie03.tex, possèdent une structure particulière. En effet, ils n’ont pas de préambule, puisque celui-ci est dans le fichier maître et il est ainsi automatiquement utilisé par les fichiers inclus. De plus, les fichiers inclus ne possèdent pas de corps de document non plus (\begin{document} et \end{document}). C’est tout à fait logique puisqu’il n’y a qu’un seul corps dans un document et que celui-ci est indiqué dans le document maître. Donc dans les fichiers inclus, il n’y a que du contenu rédactionnel.

Voici l’exemple du fichier partie01.tex :

\chapter{Janvier} 
\section{Lundi de janvier} 
Fusce dapibus, tellus ac cursus commodo... 
 
\section{Mardi de janvier} 
Fusce dapibus, tellus ac cursus commodo... 
 
\chapter{Février} 
\section{Mercredi de février} 
Fusce dapibus, tellus ac cursus commodo... 
 
\chapter{Mars} 
\section{Jeudi de mars} 
Fusce dapibus, tellus ac cursus commodo... 

Utiliser une variante de structure

Voici une variante pour inclure des fichiers dans un document maître. Dans l’exemple précédent, le fichier maître contient les commandes de niveau hiérarchique des parties : \part{Introduction}, \part{Résultats} et \part{conclusion}.

Mais vous pouvez parfaitement placer ces commandes dans chaque fichier inclus. 

Le fichier partie01.tex :

\part{Introduction} 
\chapter{Janvier} 
\section{Lundi de janvier} 
Fusce dapibus, tellus ac cursus commodo... 
... 

Le fichier partie02.tex :

\part{Résultats} 
\chapter{Avril} 
\section{Lundi d'avril} 
Fusce dapibus, tellus ac cursus commodo... 
... 

Le fichier partie03.tex :

\part{Conclusion} 
\chapter{Juillet} 
\section{Lundi de juillet} 
Fusce dapibus, tellus ac cursus commodo... 
...  

Dans le fichier maître, nous avons alors :

\documentclass[11pt,a4paper]{book} 
\input{preambule} 
 
\author{Christophe AUBRY} 
\title{Rapport annuel d'activité} 
\date{25 octobre 2020} 
 
\begin{document} 
\maketitle 
 
% Table des matières 
\tableofcontents 
 
% Inclure la partie 1 
\include{partie01} 
 ...

Exploiter l’inclusion conditionnelle

Une autre solution existe pour créer des documents multifichiers. Avec l’exemple précédent, nous avons explicitement inclus les fichiers désirés dans le corps du document maître. Mais il se peut que, pour une raison bien précise, un fichier ne doive pas être inclus dans le fichier maître.

Dans le corps du fichier maître, utilisez la commande include{Nom du fichier} pour inclure tous les documents qui doivent être « normalement » inclus.

Toujours dans le préambule du fichier maître, avec la commande \includeonly{fichier1, fichier2,...}, vous indiquez uniquement les fichiers qui doivent être inclus à l’instant T de votre travail.

Voici le code du fichier maître :

\documentclass[11pt,a4paper]{book} 
\input{preambule} 
 
\author{Christophe AUBRY} 
\title{Rapport annuel d'activité} 
\date{25 octobre 2020} 
 
% Fichiers à inclure 
\includeonly{partie01,partie03} 
 
\begin{document} 
\maketitle 
 
% Table des matières 
\tableofcontents 
 
% Inclure la partie 1 
\include{partie01} 
 
% Inclure la partie 2 
\include{partie02} 
 
% Inclure la partie 3 
\include{partie03} ...

Inclure un index multiple

Dans les documents multifichiers, il est courant d’avoir des entrées d’index dans les documents constitutifs. Il est donc nécessaire de pouvoir afficher l’index dans le fichier maître. Pour cet exemple, nous allons repartir de la structure précédente, non conditionnelle.

% Les packages communs 
\usepackage[utf8]{inputenc} 
\usepackage[french]{babel} 
\usepackage[T1]{fontenc} 
\usepackage{lmodern} 
% Ajouter le package makeidx 
\usepackage{makeidx} 
%Création de l'index 
\makeindex 

% Afficher l'index 
\printindex 
\end{document} 

Afficher un glossaire multiple

Comme pour les index, nous pouvons insérer des entrées de glossaire dans les fichiers constitutifs et afficher le glossaire dans le document maître.

% Les packages communs 
\usepackage[utf8]{inputenc} 
\usepackage[french]{babel} 
\usepackage[T1]{fontenc} 
\usepackage{lmodern} 
% Ajouter le package makeidx 
\usepackage{makeidx} 
%Création de l'index 
\makeindex 
% Ajout du package glossaries 
\usepackage{glossaries} 
% Création du glossaire 
\makeglossaries 

% Afficher l'index 
\printindex 
% Afficher le glossaire 
\printglossaries 
\end{document} 

Lister les tableaux par leur légende

Sur exactement le même principe, vous pouvez afficher la liste des tableaux flottants en utilisant leur légende. Reportez-vous au chapitre dédié aux tableaux pour insérer des tableaux et des légendes dans les fichiers constitutifs de votre document multifichiers.

Voici un exemple d’un tableau :

\begin{table}[h] 
\centering 
   \begin{tabular}{| l | l | l |} 
         \hline 
         Lundi & Mardi & Mercredi \\ 
         \hline 
         10 & 12 & 25 \\ 
         123 & 147 & 159 \\ 
         1478 & 1631 & 1863 \\ 
         \hline 
   \end{tabular} 
   \caption{Donec id elit non mi porta} 
   \label{legTab:Donec} 
\end{table} 

Toujours dans le fichier maître, maitre.tex, insérez la commande \listoftables là où vous souhaitez afficher la liste des tableaux :

% Afficher la liste des tableaux 
\listoftables 

Effectuez...

Insérer une bibliographie

Dans une thèse ou un mémoire structuré en plusieurs parties avec plusieurs fichiers constitutifs, vous devez pouvoir gérer une bibliographie. Nous allons procéder de manière similaire par rapport à ce que nous avons vu dans le chapitre précédent dédié à la gestion des bibliographies.

Dans le dossier de votre projet, vous devez créer un fichier .bib contenant votre bibliographie. Pour cet exemple, vous pouvez reprendre le fichier mabiblio.bib créé précédemment.

Dans le fichier du préambule commun, preambule.tex, ajoutez le package cite :

% Ajout du package cite pour les citations bibliographiques 
\usepackage{cite} 

Dans chaque fichier constitutif (partie01.tex, partie02.tex et partie03.tex), insérez les citations vers les références bibliographiques :

... 
Voir le livre de François MOCQ et Sarah LACAZE \cite{MOLASRP}... 
... 
Reportez-vous au livre de Damien BRUYNDONCKX \cite{BRUDCAM}... 
... 

Dans le fichier maître, maitre.tex, ajoutez les commandes pour styler la bibliographie et pour l’insérer :

% Utiliser et afficher la bibliographie 
\bibliographystyle{plain} 
\bibliography{mabiblio} 

Enfin, effectuez les compilations nécessaires comme nous l’avons vu précédemment....

Appréhender la syntaxe de l’exemple

% Les packages communs 
\usepackage[utf8]{inputenc} 
\usepackage[french]{babel} 
\usepackage[T1]{fontenc} 
\usepackage{lmodern} 
% Ajouter le package makeidx 
\usepackage{makeidx} 
% Création de l'index 
\makeindex 
% Ajout du package glossaries 
\usepackage{glossaries} 
% Création du glossaire 
\makeglossaries 
% Définition des entrées du glossaire 
\newglossaryentry{loip}{ 
   name={Lorem Ipsum}, 
   description={Ceci est la définition de lorem ipsum. Cras 
mattis consectetur purus sit amet fermentum. Donec sed odio 
dui. Curabitur blandit tempus porttitor.} 
} 
\newglossaryentry{doul}{ 
   name={Donec ullamcorper}, 
   description={Ceci est la définition de Donec ullamcorper. 
Donec ullamcorper nulla non metus auctor fringilla. Lorem 
ipsum dolor sit amet, consectetur adipiscing elit.} 
} 
\newglossaryentry{etpo}{ 
   name={Etiam porta}, 
   description={Ceci est la définition de Etiam porta. Cum 
sociis natoque penatibus et magnis dis parturient montes, 
nascetur ridiculus mus. Donec sed odio dui.} 
} 
% Ajout du package graphicx pour les illustrations flottantes ...