Écrire de gros fichiers avec latex - rapports, mémoires...

Organisation d’un gros documentInclusion de fichiers et structuration du document

Générer un index

Écrire de gros fichiers avec LATEXRapports, mémoires, livres, manuels. . .

M. Bailly-Bechet

Université Claude Bernard Lyon 1Laboratoire de Biométrie et Biologie Evolutive

Bât. Mendel 1er étage, côté rouge

M1 Santé-Populations – Communication Scientifique

[email protected] Gros fichiers

[email protected]


Générer un index

Plan

Organisation d’un gros document

Inclusion de fichiers et structuration du document

Générer un index


[email protected]


Générer un index

Les particularités des gros documents

I Un document important peut faire plusieurs centaines, voiremilliers, de pages.

I Les exemples classiques sont des livres ou des thèses. Lesmanuels de cours rentrent aussi dans cette catégorie, car ilssont très structurés.

I Ils sont caractérisés par une nécessité d’avoir des repèrespermettant de trouver l’information voulue dans le document,afin qu’il soit utilisable.


[email protected]


Générer un index

Structure d’un (très) gros document

I Page de gardeI Dédicace et remerciementsI Table des matièresI Liste des figures et des tableauxI PréfaceI Corps du texteI BibliographieI AppendicesI Glossaire et index


[email protected]


Générer un index

Les trois sous-parties de la classe book

I Pour de gros documents, il faut employer la classe book deLATEX.

I Le document peut être divisé en trois parties : \frontmatter,\mainmatter et \appendix.

I Entre \frontmatter et \mainmatter, les pages sontnumérotées à part.

I Après \appendix, les chapitres ne sont plus numérotés.


[email protected]


Générer un index

Les éléments précédant le corps du texte

I La page de garde doit comporter les informations suivantes :I TitreI AuteursI Encadrant(s) éventuel(s)I L’intitulé du type d’ouvrageI Niveau et intitulé de la formationI L’année

I La liste des figures s’insère avec \listoffigures, commepour la table des matières. Elle contient une liste de tous lesenvironnements figure du document.

I La liste des tables s’insère avec \listoftables.


[email protected]


Générer un index

Les éléments postérieurs au texte

I La bibliographie doit toujours être présente. On peut mêmefaire une bibliographie par chapitre (voir diapositive suivante)

I La présence du glossaire et de l’index dépend de la nature dudocument.

I Les appendices doivent contenir toutes les informations utilesà une meilleure compréhension du travail, mais dont on peutse passer en première lecture. Notamment, les codesdéveloppés ou les tableaux de données brutes ne doivent passe trouver dans le corps du texte, mais en appendice.


[email protected]


Générer un index

Définir ses propres commandes

Vous pouvez utiliser la commande \def pour définir des raccourcispour vos commandes :

\def\be{\begin{equation}}\def\ee{\end{equation}}

\def\P{\mathcal{P}_{\alpha\beta,\bar{x}}}\def\T{tRNA}\def\Ts{tRNAs}

Pour information, $\P$ donne Pαβ,x̄ et \T donne tRNA.


[email protected]


Générer un index

Plan



Générer un index


[email protected]


Générer un index

Pourquoi utiliser plusieurs fichiers ?

I Par souci de lisibilité.I Pour diviser le travail entre plusieurs personnes.I Pour diminuer le nombre de fichiers à transporter avec soi.I Pour réemployer sans y toucher d’anciennes publications.I Pour organier (et donc accélérer) la recherche d’erreurs.


[email protected]


Générer un index

Inclusion de code LATEX

I Vous pouvez inclure du code LATEX à partir d’un autre fichierfichier.tex avec la commande \input{fichier} àl’emplacement souhaité.

I Tout se passe comme si le code LATEX écrit dansfichier.tex était copié-collé à l’emplacement de votrechoix. Il n’est donc pas nécéssaire de compiler le fichierfichier.tex, seule la compilation du document principal (ditdocument-maître) est nécessaire.

I Vous pouvez employer les input de manière récursive, maisévitez les boucles.

I Un usage classique est de mettre chaque chapitre, ou chaquesection, dans un fichier à part.


[email protected]


Générer un index

Inclusion de fichiers PDF

I La commande \pdfpages permet d’inclure dans votredocument des pages complètes d’un autre document PDF.

I Vous avez besoin d’un \usepackage{pdfpages} dans lepréambule.

I La commande d’inclusion est \includepdf{fichier.pdf}.I Il existe de nombreuses options. La plus utile est pages.

Exemple :

\includepdf[pages=1,{},3,8-11,17-last]{fichier.pdf}


[email protected]


Générer un index

Une bibliographie par chapitre

Dans certains documents, il est souhaitable de mettre unebibliographie à la fin de chaque chapitre ou section. Pour cela,vous pouvez employer le package chapterbib :

I Inclure \usepackage{chapterbib} dans le document maître.I Inclure, dans chacun des sous-documents, les commandes

standards de bibliographie, \bibliographystyle et\bibliography.

I Compiler le document maître.I Lancer la commande bibtex sur chacun des sous-documents.I Recompiler 2 fois le document maître.


[email protected]


Générer un index

Exercice

Reprenez un de vos anciens documents en LATEX, et décomposez-leen un document maître et deux sous-documents. Compilez etvérifiez que tout fonctionne bien.


[email protected]


Générer un index

Plan



Générer un index


[email protected]


Générer un index

Un index ? Pourquoi faire ?

I Un index est un annexe, placé en général en fin de document,qui contient une liste de mots et les pages du documentauxquels ils sont mentionnés.

I Si l’index contient la définition des mots en question au lieude leur position dans le document, il s’agit d’un glossaire.

I Un index n’est utile que s’il est cohérent – et LATEX ne peutpas vérifier cela à la place de l’auteur.


[email protected]


Générer un index

Dans quels documents mettre un index ?

I Un index est très utile quand votre document contient denombreux mots porteurs de sens, employés peu de foischacun, et donc n’apparaissant pas dans les titres de sectionset sous-sections.

I Typiquement, un index est essentiel dans un manuel ou unpolycopié de cours dépassant les 50 pages.

I C’est un complément, et pas un remplacement, à la table desmatières.


[email protected]


Générer un index

Commandes de base

I Dans le préambule du document, il vous faut ajouter\usepackage{makeidx} puis \makeindex.

I À l’endroit où vous voulez placer votre index(traditionellement à la toute fin du document, après labibliographie), il vous faut inclure la commande \printindex.

I Chaque élément que vous voulez indexer est signalé dans lecorps du document par un \index{mot}.


[email protected]


Générer un index

Syntaxe des entrées de l’index

Entrée simple : \index{chou}.Sous-entrée : \index{l\’egume!chou}.Entrée formatée : \index{chou@\emph{chou}}.Numéro de page formaté : \index{chou|textit}.

Accents : \index{ecureuil@\’ecureuil}.Symboles : \index{delta@$\delta$}.

Référence croisée : \index{chou de Bruxelles|see{chou}}


[email protected]


Générer un index

Compilation de fichiers avec index

Parfois, pdflatex prend l’index en charge tout seul. Si ce n’estpas le cas, vous devez effectuer les opérations de compilation danscet ordre :1. pdflatex

2. makeindex

3. pdflatex

4. pdflatex


[email protected]


Générer un index

Astuce : construction de l’index a posteriori

I Une façon de faire un index a posteriori consiste à remplacerdans votre document le mot à indexer (mot) parmot\index{mot}.

I Le problème avec cette méthode est celui de la reconnaissancedes chaînes de caractères : par exemple pour indexer chat,vous allez indexer chateau. . .

I Vérifiez toujours ce que vous faîtes quand vous commencez àappliquer des méthodes automatiques sur un document ou uncode.


[email protected]


Générer un index

Astuce et exercice

I Une façon intéressante de faire un index est d’utiliser lepackage hyperref, avec un \usepackage{hyperref}. Cecipermet aux lecteurs du fichier PDF numérique de naviguerdirectement en suivant tous les liens du document (index,référence à une figure, table des matières. . . ).

I Prenez l’un de vos anciens documents en LATEX et ajoutez-yun index avec les mots les plus significatifs.


[email protected]

Écrire de gros fichiers avec latex - rapports, mémoires...

Documents