\chapter{Compiler avec \LaTeX{}}

\label{compilation_intro}\lettrine{P}{our} faire du \LaTeX{}, il faut déjà connaître le point suivant : \LaTeX{} est un langage et un système de composition de documents. Généralement, en informatique, un langage requiert une étape obligatoire : la compilation. Et \LaTeX{} n'échappe pas à cette règle.

\section{Principe de la compilation}

Quand tu vas rédiger un document sous \LaTeX{}, tu vas devoir procéder en 3 temps :

\begin{figure}[H]
\centering
\resizebox{0.95\linewidth}{!}{\input{./Images/compilation_schema}}
\caption{Les 3 étapes pour rédiger un document sous \LaTeX{}}
\end{figure}

Pour entrer un peu plus dans les détails, tu dois donc : \begin{enumerate}
\item écrire ton document en \LaTeX{} (respect de ses conventions et utilisation de commandes spécifiques) ;

\item demander à un moteur \LaTeX{} de transformer ton document et ses commandes en un fichier lisible et utilisable : c'est la compilation ;

\item profiter du résultat fourni (format PDF) ou l'évaluer pour ensuite apporter des modifications au document, et ainsi de suite. \\
\end{enumerate}

Quant au moteur \LaTeX{} utilisé, il en existe plusieurs. Pour débuter, je recommande d'utiliser plutôt \pdfTeX{} (intitulé apparemment \pdfLaTeX{} sous \Texmaker{}), qui permet de passer d'un coup du document \LaTeX{} au fichier PDF final.

Quant aux autres moteurs, je les aborde bien plus loin dans ce guide, en page \pageref{compilation-details}. Je recommande plutôt de t'y rendre une fois que tu as un peu d'expérience sous \LaTeX{}, pour ne pas perdre du temps et acquérir des bases solides. \\

Nous savons désormais que nous devons compiler avec le moteur \pdfTeX{}\dots{} mais nous ne savons toujours pas comment faire ! Pas de panique : les logiciels que je t'ai fait installer prennent tout en charge.

\section{Démarrer avec \Texmaker{}}

Pour gérer et éditer ses fichiers \LaTeX{}, \Texmaker{} est un excellent logiciel. Et je sais de quoi je parle car, avant de m'y mettre, j'utilisais un autre logiciel, tellement exécrable que j'ai fini par oublier son nom. Aujourd'hui, je ne fais rien sans \Texmaker{}. Voyons un aperçu de ce dernier : 

\begin{figure}[H]
\includegraphics[width = \linewidth]{Aide_LaTeX1.png}
\caption{Aperçu de \Texmaker{}}
\end{figure}

Revenons sur chaque point :

\begin{itemize}[label = \ding{213}]
\item \textcolor{red}{barre de menus et d'outils :} plein de commandes \LaTeX{} préremplies. Personnellement, je l'utilise très rarement (y compris le bouton de sauvegarde). Je préfère utiliser les raccourcis clavier (en l'occurrence, \keys{\ctrl + S}) ;
	
\item \textcolor{Horange}{structure du document :} très pratique pour naviguer dans le code du document ouvert ;
	
\item \textcolor{Hgreen}{raccourcis de commandes :} encore des commandes. Il peut être intéressant d'y jeter un coup d'{\oe}il une fois ce guide bien avancé. Il y a principalement des commandes pour les formules mathématiques et quelques unes pour la mise en forme du texte ;
	
\item \textcolor{Gold}{code \LaTeX{} :} c'est ici que tu tapes le texte de ton document et les commandes \LaTeX{} nécessaires pour le mettre en forme ;
	
\item \textcolor{Hpurple}{informations du compilateur :} le résultat lors de la génération du PDF. Très utile, s'il y a des erreurs, pour pouvoir se corriger ;
	
\item \textcolor{Hblue}{aperçu du PDF :} une fenêtre avec l'aperçu du fichier PDF généré. \\
\end{itemize}

Si jamais cet aperçu n'est pas disponible (fenêtre d'affichage inexistante comme sur mon image), il faut procéder de la manière suivante : \begin{enumerate}
\item Aller dans \verb?Options? puis dans \verb?Configurer Texmaker?.

\item Dans l'onglet \verb?Afficheur Pdf?, choisir les options \verb?Afficheur Pdf interne? et \verb?Intégré à la fenêtre?. Valider.

\item Un bouton \verb?Pdf Viewer? est alors disponible en bas à gauche et te permet d'activer ou non cette fenêtre d'aperçu.
\end{enumerate}

Si jamais ce n'est pas clair, j'espère que cette capture d'écran permettra de lever le moindre doute :

\begin{figure}[H]
\includegraphics[width = \linewidth]{apercu_pdf.png}
\caption{Procédure pour obtenir l'aperçu du PDF}
\end{figure}

\begin{conseil}{L'aide en ligne}
Si jamais tu as d'autres questions sur \Texmaker{}, son site officiel (\url{http://www.xm1math.net/texmaker/index_fr.html}) est le meilleur endroit pour avoir des réponses et fournit aussi un tutoriel pour débuter avec \LaTeX{}. 

Si certains points de ce guide te semblent obscures, tu peux donc t'y rendre, ainsi que sur \url{http://fr.wikibooks.org/wiki/LaTeX}. \\

N'hésite pas quand tu débutes. Les deux sites sont en français et répondent à beaucoup de questions assez facilement (\textit{i.e.} avec un code simple).
\end{conseil}

\section{Compiler avec \Texmaker{}}

Maintenant que l'environnement propre à \Texmaker{} a été présenté, voyons un peu plus dans le détail un dernier point : la compilation. Pour commencer, reprenons le code \og Bonjour monde ! \fg{} utilisé en page \pageref{hello-world} :

\begin{code}{Bonjour monde !}
\documentclass[]{report}


\begin{document}

Bonjour monde !

\end{document}
\end{code}

Je suppose que tu as suivi les premières indications fournies, soit ouvrir \Texmaker{}, recopier le code \og Bonjour monde ! \fg{} donné et enregistrer ton document. 

Si tu n'as pas précisé d'extension, tu remarqueras au passage que ton fichier a été sauvegardé avec l'extension \verb?.tex?, qui correspond à l'extension pour des fichiers \LaTeX{}. \\

Il existe ensuite 3 façons de lancer la compilation de ton document \LaTeX{} : \begin{itemize}[label = \ding{213}]
\item via l'invite de commandes de ton système d'exploitation (le CMD pour les utilisateurs de \Windows{})\dots{} mais je n'en parlerai pas pendant ce guide.

Sache cependant que c'est possible mais ne présente aucun intérêt comme \Texmaker{} propose des solutions plus pratiques ;

\item via \Texmaker{} avec des clics souris ;

\item via \Texmaker{} avec des raccourcis clavier (le plus rapide à mon sens).
\end{itemize}

Revenons sur les 2 derniers points plus dans le détail, pour que tu comprennes bien les actions à effectuer. \\

Pour une compilation via \Texmaker{} avec des clics souris, il faut procéder en 3 temps (cf. \figurename{} \ref{compilation_clics} si besoin) : \begin{enumerate}
\item Choisir le moteur de compilation, \pdfLaTeX{} dans notre cas, en haut dans la barre d'outils.

\item Lancer la compilation en cliquant sur la flèche à gauche du choix du moteur de compilation. Attendre que la compilation soit terminée.

\item Juste à droite du choix du moteur de compilation, bien choisir l'option \verb?Voir PDF? et cliquer sur la flèche associée pour afficher le résultat.
\end{enumerate}

\begin{figure}[H]
\centering
\includegraphics[width = 0.85\linewidth]{compilation_clics.png}
\caption{Lancer la compilation avec des clics souris (\Texmaker{})}
\label{compilation_clics}
\end{figure}

Pour une compilation via \Texmaker{} avec des raccourcis clavier, il faut procéder en 2 temps (cf. \figurename{} \ref{compilation_clavier} si besoin) : \begin{enumerate}
\item Lancer la compilation avec le moteur \pdfLaTeX{} avec la touche \keys{F6}.

\item Afficher le résultat avec la touche \keys{F7}.
\end{enumerate}

Ces raccourcis sont personnalisables dans les options de \Texmaker{}, comme décrit ci-après (\figurename{} \ref{compilation_clavier}).

\begin{figure}[H]
\centering
\includegraphics[width = 0.85\linewidth]{compilation_clavier.png}
\caption{Configuration des raccourcis clavier pour lancer la compilation (\Texmaker{})}
\label{compilation_clavier}
\end{figure}

Mais il y a encore plus rapide : lancer la compilation ET avoir l'aperçu du PDF actualisé en un seul raccourci clavier. C'est ce que \Texmaker{} appelle la \og compilation rapide \fg{}\footnote{Il s'agit du nom attribué par le concepteur de \Texmaker{}. Le temps nécessaire pour compiler le document n'est en rien diminué.}. 

Tout d'abord, il faut s'assurer que la compilation rapide est bien programmée. Pour ce faire, il faut configurer \Texmaker{} de la manière suivante :

\begin{figure}[H]
\centering
\includegraphics[width = 0.85\linewidth]{compilation_rapide.png}
\caption{Configuration de la compilation rapide (\Texmaker{})}
\end{figure}

Ensuite, il suffit d'appuyer sur la touche \keys{F1} pour lancer la compilation rapide. Il s'agit de la touche par défaut, paramétrable dans les options \Texmaker{} comme indiqué en \figurename{} \ref{compilation_clavier}. \\

Enfin, pour terminer les explications, il faut savoir que les compilations réalisées sous \Texmaker{} sont équivalentes à l'utilisation de l'invite de commandes. Grâce à \Texmaker{}, cette utilisation est transparente et grandement simplifiée\dots{} pour les non-initiés nous dirons !

\begin{attention}{La compilation : le conseil personnel}
Peu importe le moteur utilisé pour la compilation, tu peux remarquer qu'un fichier \verb?.tex? entraîne toujours la génération d'autres fichiers. \textbf{\color{orange}C'est pourquoi je recommande toujours de travailler avec le fichier \verb?.tex? placé dans un dossier,} pour éviter de submerger tes autres dossiers et de te perdre parmi les fichiers. \\

Enfin, ces fichiers secondaires n'ont besoin d'être conservés que le temps de travailler sur un document \LaTeX{}. \textbf{\color{Green}Le seul fichier qui compte est celui avec l'extension \verb?.tex?.} C'est lui qui contient tout le code nécessaire à la compilation et à l'obtention du PDF final.
\end{attention}

\vspace{\baselineskip}

Attaquons désormais la raison première de ce guide : faire du \LaTeX{}.