<html><head><meta name="color-scheme" content="light dark"></head><body><pre style="word-wrap: break-word; white-space: pre-wrap;">\chapter{Compiler avec \LaTeX{}}

\label{compilation_intro}\lettrine{P}{our} faire du \LaTeX{}, il faut dĂ©jĂ&nbsp; 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 Ă&nbsp; 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 Ă&nbsp; 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Ă© Ă&nbsp; la fenĂŞtre?. Valider.

\item Un bouton \verb?Pdf Viewer? est alors disponible en bas Ă&nbsp; 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 Ă&nbsp; beaucoup de questions assez facilement (\textit{i.e.} avec un code simple).
\end{conseil}

\section{Compiler avec \Texmaker{}}

Maintenant que l'environnement propre Ă&nbsp; \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 Ă&nbsp; 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 Ă&nbsp; mon sens).
\end{itemize}

Revenons sur les 2 derniers points plus dans le dĂ©tail, pour que tu comprennes bien les actions Ă&nbsp; 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 Ă&nbsp; gauche du choix du moteur de compilation. Attendre que la compilation soit terminĂ©e.

\item Juste Ă&nbsp; 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 Ă&nbsp; l'utilisation de l'invite de commandes. GrĂ˘ce Ă&nbsp; \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 Ă&nbsp; la compilation et Ă&nbsp; l'obtention du PDF final.
\end{attention}

\vspace{\baselineskip}

Attaquons dĂ©sormais la raison premiĂ¨re de ce guide : faire du \LaTeX{}.</pre></body></html>