<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>