TM_latex/chapitres/chapter4.tex

58 lines
8.2 KiB
TeX
Raw Normal View History

\chapter{Structure\index{structure} et compilation\index{compilation}}\label{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\index{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|\index{main.tex}. À l'intérieur de celui-ci se trouvent quatre répertoires particuliers : \verb|pagesspeciales|\index{répertoire!pagesspeciales}, \verb|chapitres|\index{répertoire!chapitres}, \verb|images|\index{répertoire!images} et \verb|code_source|\index{répertoire!code\_source} et plusieurs fichiers : toute une série de ceux-ci portent le nom \verb|main.xxx|\index{fichiers!main}, une autre le nom \verb|config.xxx|\index{fichiers!config}, une autre encore \verb|web.xxx|\index{fichiers!web}, certains portent le nom \verb|TM.sty|\index{fichiers!TM} et \verb|fancyheadings.sty|\index{fichiers!fancyheadings}, \verb|multibib.sty|\index{fichiers!multibib} et \verb|licence.txt|\index{fichiers!licence}.
Les \verb|main.xxx|\index{fichiers!main} sont issus de la compilation. À part \verb|main.tex|, il ne faut pas les toucher. Même \verb|main.tex|\index{main.tex} ne devrait pas être modifié, sauf rare exception comme celle permettant d'imposer des citations\index{citation} de références\index{référence} 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\index{compiler}.
Parmi les fichiers \verb|config.xxx|\index{fichiers!config}, seul le fichier \verb|config.tex|\index{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\index{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 qui servent à la bibliographie, le fichier permettant de répertorier vos différentes est le fichier \verb|main.bib|\index{main.bib}. Il faut le remplir des références papier ou internet de votre travail pour la bibliographie\index{bibliographie} (voir la section \ref{bibliographie}, page \pageref{bibliographie}).
L'élément central du modèle de travail de maturité est \verb|TM.sty|\index{fichiers!TM}\index{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|\index{fichiers!fancyheadings} et \verb|multibib.sty|\index{fichiers!multibib} 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.tex|\index{fichiers!licence}\index{licence.tex} spécifie quant à lui le texte de la licence du modèle et/ou du travail de maturité.
\bigskip
Dans le répertoire \verb|pagesspeciales|\index{répertoire!pagesspeciales}, se trouvent les fichiers nécessaires à la définition des pages spéciales comme la page de titre (\verb|pagetitre.tex|)\index{pagetitre.tex} dont le fichier ne devrait pas être modifié autrement qu'à partir du fichier de configuration ou remplacé par \verb|page_titre.pdf| (voir l'item page de titre du paragraphe \ref{sec:configtex}, \pageref{sec:configtex}), la page de citation et dédicaces (\verb|citations.tex|)\index{citations.tex}, la page de remerciements (\verb|remerciements.tex|)\index{remerciements.tex}, la page du résumé (\verb|resume.tex|)\index{resume.tex}, la page des acronymes (\verb|acronymes.tex|)\index{acronymes.tex} et la page décrivant le site web éventuellement associé au travail de maturité (\verb|website.tex|)\index{website.tex}.
Dans le répertoire \verb|chapitres|\index{répertoire!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|\index{répertoire!images} se trouvent les images du travail de maturité. Elles doivent figurer chacune sous deux types : .eps\index{extension!eps} et .jpg\index{extention!jpg} ou .png\index{extension!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|\index{répertoire!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|\index{fichier!Lisez-moi.txt} ou \verb|readme.md|\index{fichier!readme.md} qui va vous diriger vers le présent texte qu'il faut lire.
Puis, il faut tenter une première compilation\index{compilation} du fichier \verb|main.tex|\index{main.tex} pour détecter des erreurs dues à l'éventuelle absence de certains modules\index{module} (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.
En particulier, les modules suivants sont indispensables :
\begin{description}
\item[texlive-lang-french] qui permet l'utilisation de la langue française de manière adéquate,
\item[texlive-lang-german] qui permet l'utilisation de la langue allemande de manière adéquate,
\item[texlive-science] qui permet l'utilisation du module \verb|siunitx| pour la gestion des unités et
\item[biber] pour la gestion de la bibliographie.
\end{description}
Sous linux, l'installation de ces modules se fait simplement par l'intermédiaire de la commande du listing \ref{listing:installmodules}.
\begin{lstlisting}[float,caption={Installation des modules},label={listing:installmodules}]
sudo apt install texlive-lang-french texlive-lang-german texlive-science biber
\end{lstlisting}
Alors seulement, le travail à proprement parlé peut commencer.
\section{Compilation}\label{sec:compilation}
Pour compiler\index{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\index{Texmaker}.
Comme déjà dit, le document à compiler est \verb|main.tex|\index{main.tex}. Le modèle permet la compilation en postscript, via la chaîne de compilation : latex + dvips + ps2pdf\index{dvips}\index{ps2pdf} et ses dérivées introduisant la bibliographie via biber, et la compilation latex2pdf\index{latex2pdf} et ses dérivées pour la bibliographie. Vous pouvez donc choisir simplement celle que vous voulez. Le modèle la détectera.
Sachez cependant que la chaîne de compilation postscript nécessite des images au format eps uniquement, alors que la chaîne directe latex2pdf permet l'utilisation de jpg et png, à l'exception des eps. Il faut donc choisir dès le départ l'une ou l'autre des possibilités ou mettre systématiquement les deux types de fichiers dans le répertoire des images.
Compiler en postscript permet l'utilisation du grapheur Gnuplot\index{Gnuplot} directement et l'ajout de texte superposé à celui de la page. Cela permet aussi l'utilisation de Tikz\index{Tikz} ou autres langages utilisant postscript pour des sorties vectorielles très haute qualité, ce que ne permet pas latex2pdf.
Notez enfin que si vous voulez remplacer la page de titre du modèle par une page faite par vous-même en pdf, il faudra choisir la chaîne latex2pdf.