Remerciez-le!

Remerciez @Admin pour avoir partagé cet document gratuitement, de la manière la plus simple, en partageant sur les réseaux sociaux.

Organisation d’un gros document Inclusion de ﬁchiers et structuration du docume

Organisation d’un gros document Inclusion de ﬁchiers et structuration du document Générer un index Écrire de gros ﬁchiers avec L AT EX Rapports, mémoires, livres, manuels. . . M. Bailly-Bechet Université Claude Bernard Lyon 1 Laboratoire de Biométrie et Biologie Evolutive Bât. Mendel 1er étage, côté rouge M1 Santé-Populations – Communication Scientiﬁque marc.baillybechet@gmail.com Gros fichiers Organisation d’un gros document Inclusion de ﬁchiers et structuration du document Générer un index Plan Organisation d’un gros document Inclusion de ﬁchiers et structuration du document Générer un index marc.baillybechet@gmail.com Gros fichiers Organisation d’un gros document Inclusion de ﬁchiers et structuration du document Générer un index Les particularités des gros documents ▶Un document important peut faire plusieurs centaines, voire milliers, de pages. ▶Les exemples classiques sont des livres ou des thèses. Les manuels de cours rentrent aussi dans cette catégorie, car ils sont très structurés. ▶Ils sont caractérisés par une nécessité d’avoir des repères permettant de trouver l’information voulue dans le document, aﬁn qu’il soit utilisable. marc.baillybechet@gmail.com Gros fichiers Organisation d’un gros document Inclusion de ﬁchiers et structuration du document Générer un index Structure d’un (très) gros document ▶Page de garde ▶Dédicace et remerciements ▶Table des matières ▶Liste des ﬁgures et des tableaux ▶Préface ▶Corps du texte ▶Bibliographie ▶Appendices ▶Glossaire et index marc.baillybechet@gmail.com Gros fichiers Organisation d’un gros document Inclusion de ﬁchiers et structuration du document Générer un index Les trois sous-parties de la classe book ▶Pour de gros documents, il faut employer la classe book de L AT EX. ▶Le document peut être divisé en trois parties : \frontmatter, \mainmatter et \appendix. ▶Entre \frontmatter et \mainmatter, les pages sont numérotées à part. ▶Après \appendix, les chapitres ne sont plus numérotés. marc.baillybechet@gmail.com Gros fichiers Organisation d’un gros document Inclusion de ﬁchiers et structuration du document Générer un index Les éléments précédant le corps du texte ▶La page de garde doit comporter les informations suivantes : ▶Titre ▶Auteurs ▶Encadrant(s) éventuel(s) ▶L’intitulé du type d’ouvrage ▶Niveau et intitulé de la formation ▶L’année ▶La liste des ﬁgures s’insère avec \listoffigures, comme pour la table des matières. Elle contient une liste de tous les environnements figure du document. ▶La liste des tables s’insère avec \listoftables. marc.baillybechet@gmail.com Gros fichiers Organisation d’un gros document Inclusion de ﬁchiers et structuration du document Générer un index Les éléments postérieurs au texte ▶La bibliographie doit toujours être présente. On peut même faire une bibliographie par chapitre (voir diapositive suivante) ▶La présence du glossaire et de l’index dépend de la nature du document. ▶Les appendices doivent contenir toutes les informations utiles à une meilleure compréhension du travail, mais dont on peut se passer en première lecture. Notamment, les codes développés ou les tableaux de données brutes ne doivent pas se trouver dans le corps du texte, mais en appendice. marc.baillybechet@gmail.com Gros fichiers Organisation d’un gros document Inclusion de ﬁchiers et structuration du document Générer un index Déﬁnir ses propres commandes Vous pouvez utiliser la commande \def pour déﬁnir des raccourcis pour 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. marc.baillybechet@gmail.com Gros fichiers Organisation d’un gros document Inclusion de ﬁchiers et structuration du document Générer un index Plan Organisation d’un gros document Inclusion de ﬁchiers et structuration du document Générer un index marc.baillybechet@gmail.com Gros fichiers Organisation d’un gros document Inclusion de ﬁchiers et structuration du document Générer un index Pourquoi utiliser plusieurs ﬁchiers ? ▶Par souci de lisibilité. ▶Pour diviser le travail entre plusieurs personnes. ▶Pour diminuer le nombre de ﬁchiers à transporter avec soi. ▶Pour réemployer sans y toucher d’anciennes publications. ▶Pour organier (et donc accélérer) la recherche d’erreurs. marc.baillybechet@gmail.com Gros fichiers Organisation d’un gros document Inclusion de ﬁchiers et structuration du document Générer un index Inclusion de code L AT EX ▶Vous pouvez inclure du code L AT EX à partir d’un autre ﬁchier fichier.tex avec la commande \input{fichier} à l’emplacement souhaité. ▶Tout se passe comme si le code L AT EX écrit dans fichier.tex était copié-collé à l’emplacement de votre choix. Il n’est donc pas nécéssaire de compiler le ﬁchier fichier.tex, seule la compilation du document principal (dit document-maître) est nécessaire. ▶Vous pouvez employer les input de manière récursive, mais évitez les boucles. ▶Un usage classique est de mettre chaque chapitre, ou chaque section, dans un ﬁchier à part. marc.baillybechet@gmail.com Gros fichiers Organisation d’un gros document Inclusion de ﬁchiers et structuration du document Générer un index Inclusion de ﬁchiers PDF ▶La commande \pdfpages permet d’inclure dans votre document des pages complètes d’un autre document PDF. ▶Vous avez besoin d’un \usepackage{pdfpages} dans le préambule. ▶La commande d’inclusion est \includepdf{fichier.pdf}. ▶Il existe de nombreuses options. La plus utile est pages. Exemple : \includepdf[pages=1,{},3,8-11,17-last]{fichier.pdf} marc.baillybechet@gmail.com Gros fichiers Organisation d’un gros document Inclusion de ﬁchiers et structuration du document Générer un index Une bibliographie par chapitre Dans certains documents, il est souhaitable de mettre une bibliographie à la ﬁn de chaque chapitre ou section. Pour cela, vous pouvez employer le package chapterbib : ▶Inclure \usepackage{chapterbib} dans le document maître. ▶Inclure, dans chacun des sous-documents, les commandes standards de bibliographie, \bibliographystyle et \bibliography. ▶Compiler le document maître. ▶Lancer la commande bibtex sur chacun des sous-documents. ▶Recompiler 2 fois le document maître. marc.baillybechet@gmail.com Gros fichiers Organisation d’un gros document Inclusion de ﬁchiers et structuration du document Générer un index Exercice Reprenez un de vos anciens documents en L AT EX, et décomposez-le en un document maître et deux sous-documents. Compilez et vériﬁez que tout fonctionne bien. marc.baillybechet@gmail.com Gros fichiers Organisation d’un gros document Inclusion de ﬁchiers et structuration du document Générer un index Plan Organisation d’un gros document Inclusion de ﬁchiers et structuration du document Générer un index marc.baillybechet@gmail.com Gros fichiers Organisation d’un gros document Inclusion de ﬁchiers et structuration du document Générer un index Un index ? Pourquoi faire ? ▶Un index est un annexe, placé en général en ﬁn de document, qui contient une liste de mots et les pages du document auxquels ils sont mentionnés. ▶Si l’index contient la déﬁnition des mots en question au lieu de leur position dans le document, il s’agit d’un glossaire. ▶Un index n’est utile que s’il est cohérent – et L AT EX ne peut pas vériﬁer cela à la place de l’auteur. marc.baillybechet@gmail.com Gros fichiers Organisation d’un gros document Inclusion de ﬁchiers et structuration du document Générer un index Dans quels documents mettre un index ? ▶Un index est très utile quand votre document contient de nombreux mots porteurs de sens, employés peu de fois chacun, et donc n’apparaissant pas dans les titres de sections et sous-sections. ▶Typiquement, un index est essentiel dans un manuel ou un polycopié de cours dépassant les 50 pages. ▶C’est un complément, et pas un remplacement, à la table des matières. marc.baillybechet@gmail.com Gros fichiers Organisation d’un gros document Inclusion de ﬁchiers et structuration du document Générer un index Commandes de base ▶Dans le préambule du document, il vous faut ajouter \usepackage{makeidx} puis \makeindex. ▶À l’endroit où vous voulez placer votre index (traditionellement à la toute ﬁn du document, après la bibliographie), il vous faut inclure la commande \printindex. ▶Chaque élément que vous voulez indexer est signalé dans le corps du document par un \index{mot}. marc.baillybechet@gmail.com Gros fichiers Organisation d’un gros document Inclusion de ﬁchiers et structuration du document 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}} marc.baillybechet@gmail.com Gros fichiers Organisation d’un gros document Inclusion de ﬁchiers et structuration du document Générer un index Compilation de ﬁchiers avec index Parfois, pdflatex prend l’index en charge tout seul. Si ce n’est pas le cas, vous devez eﬀectuer les opérations de compilation dans cet ordre : 1. pdflatex 2. makeindex 3. pdflatex 4. pdflatex marc.baillybechet@gmail.com Gros fichiers Organisation d’un gros document Inclusion de ﬁchiers et structuration du document Générer un index Astuce : construction de l’index a posteriori ▶Une façon de faire un index a posteriori consiste à remplacer dans votre document le mot à indexer (mot) par mot\index{mot}. ▶Le problème avec cette méthode est celui de la reconnaissance des chaînes de caractères : par exemple pour indexer chat, vous allez indexer chateau. . . ▶Vériﬁez toujours ce que vous faîtes quand vous commencez à appliquer des méthodes automatiques sur un document ou un code. marc.baillybechet@gmail.com Gros fichiers Organisation d’un gros document Inclusion de ﬁchiers et structuration du document Générer un index Astuce et exercice ▶Une façon intéressante de faire un index est d’utiliser le package hyperref, avec un \usepackage{hyperref}. Ceci permet aux lecteurs du ﬁchier PDF numérique de naviguer directement en suivant tous les liens du document (index, référence à une ﬁgure, table des matières. . . ). ▶Prenez l’un de vos anciens documents en L AT EX et ajoutez-y un index avec les mots les plus signiﬁcatifs. marc.baillybechet@gmail.com Gros fichiers uploads/s1/ cours-de-latex.pdf