TM_latex/chapitres/chapter4.tex

\chapter{Structure et compilation}\label{suite}\index{suite}
Sans revenir sur le fonctionnement de \LaTeX, rappelons qu'il est nécessaire de passer par une étape de compilation pour obtenir le document final. Cette compilation nécessite l'utilisation d'un grand nombre de fichiers qui sont organisés selon une structure bien précise.

\section{Structure de fichiers}

\subsection{Description}
Pour s'y retrouver dans la multitude des fichiers qui peuplent le répertoire dans lequel se trouve le modèle de travail de maturité, il faut partir de la racine du projet, c'est à dire le répertoire dans lequel se trouve le fichier principal nommé : \verb|main.tex|. À l'intérieur de celui-ci se trouvent quatre répertoires particuliers : \verb|pagesspeciales|, \verb|chapitres|, \verb|images| et \verb|code_source| et plusieurs fichiers : toute une série de ceux-ci portent le nom \verb|main.xxx|, une autre le nom \verb|config.xxx|, une autre encore \verb|web.xxx|, certains portent le nom \verb|TM.sty| et \verb|fancyheadings.sty|, \verb|multibib.sty| et \verb|licence.txt|.

Les \verb|main.xxx| sont issus de la compilation. À part \verb|main.tex|, il ne faut pas les toucher. Même \verb|main.tex| ne devrait pas être modifié, sauf rare exception comme celle permettant d'imposer des citations de références qui ne sont pas dans le texte (voir les paragraphe \ref{nocite} et \ref{nociteweb}, respectivement pages \pageref{nocite} et \pageref{nociteweb}). On ne doit que le compiler.

Parmi les fichiers \verb|config.xxx|, seul le fichier \verb|config.tex| doit impérativement être lu et correctement remplis pour définir les réglages à faire pour son propre travail de maturité. Les réglages par défaut ne sont pas suffisant. Les principaux éléments de la page de titre, par exemple, doivent être spécifiés. Comme par défaut, l'ensemble des pages particulières est activé, il est probable qu'il faille en désactiver certaines. Ce fichier est donc particulièrement expliqué dans cette documentation elle-même, mais aussi à travers les commentaires présents dans le fichier.

Parmi les fichiers \verb|web.xxx| qui servent à la bibliographie des pages web, le fichier permettant de répertorier les différents sites web est \verb|webbib.bib|. C'est celui-ci qu'il faut remplir des références web de votre travail. De la même manière, c'est le fichier \verb|mainbib.bib| qu'il faut remplir des références de votre travail pour la bibliographie classique.

L'élément central du modèle de travail de maturité est \verb|TM.sty|. C'est le fichier de macros qui permet son bon fonctionnement. \emph{Il ne faut donc surtout pas y toucher}.

Finalement, les fichiers \verb|fancyheadings.sty| et \verb|multibib.sty| sont nécessaires pour les entêtes et les deux bibliographies. Ce sont des modules chargés par \LaTeX{} et il ne faut pas les toucher.

Le fichier \verb|licence.txt| spécifie quant à lui le texte de la licence du modèle et/ou du travail de maturité.

\bigskip
Dans le répertoire \verb|pagesspéciales|, se trouvent les fichiers nécessaires à la définition des pages spéciales comme la page de titre (\verb|pagetitre.tex|) dont le fichier ne devrait pas être modifié autrement qu'à partir du fichier de configuration, la page de citation et dédicaces (\verb|citations.tex|), la page de remerciements (\verb|remerciements.tex|), la page du résumé (\verb|resume.tex|), la page des acronymes (\verb|acronymes.tex|) et la page décrivant le site web éventuellement associé au travail de maturité (\verb|website.tex|).

Dans le répertoire \verb|chapitres| se trouvent les différents chapitres du travail de maturité, ainsi que sa conclusion. C'est principalement dans ceux-ci qu'il faut travailler.

Dans le répertoire \verb|images| se trouvent les images du travail de maturité. Elles doivent figurer chacune sous deux types : .eps et .jpg ou .png. Généralement, on y met une version de type .eps et une autre de type .jpg de chaque image.

Finalement, dans le répertoire \verb|code_source| se trouvent éventuellement des codes sources informatiques qui vont figurer dans le travail de maturité sous la forme de fichiers à inclure.\todo[line]{Préciser le mode d'inclusion.}

\subsection{Pratiquement}
Le modèle de travail de maturité se présente sous le forme d'un répertoire zippé. Il faut donc tout d'abord le décompresser et lire le fichier \verb|Lisez-moi.txt| ou \verb|readme.md| qui va vous diriger vers le présent texte qu'il faut lire.

Puis, il faut tenter une première compilation du fichier \verb|main.tex| pour détecter des erreurs dues à l'éventuelle absence de certains packages nécessaires et le cas échéant, il faut les installer et refaire la compilation jusqu'à ce qu'il n'y ait plus d'erreurs.

Alors seulement, le travail à proprement parlé peut commencer.

\section{Compilation}
Pour compiler le document, il n'est théoriquement pas nécessaire de faire appel à un éditeur latex dédié. On peut tout faire à l'aide d'une bonne vieille console ou d'un simple éditeur de texte. Mais, il est évidemment plus pratique d'avoir recours à un éditeur dédié à \LaTeX{} comme Texmaker.

Comme déjà dit, le document à compiler est \verb|main.tex|. À la fin, il est aussi nécessaire de préparer cette compilation pour permettre aux bibliographies d'être correctement intégrées dans le document. Pour cela, il faut réaliser une première compilation, puis dans la console associée à Texmaker, exécuter successivement \lstinline|bibtex main| et \lstinline|bibtex web|. Cela permettra de créer les fichiers nécessaires pour les bibliographies. Enfin, il faut recompiler une ou deux fois le document principal\endnote{Test de note de fin : \dots{} et tout finira bien !}.