Commit ac09c6e9 authored by Aurelien Pascal's avatar Aurelien Pascal
Browse files

déroulement de la compilation

parent 49e14176
......@@ -315,7 +315,7 @@ Les options les plus utiles sont résumées dans le tableau suivant. Et pour plu
& qui est vu dans l'éditeur & le font sans problème, les éditeurs\\
& au document \texttt{.pdf} & comme \textit{vim} ont besoin d'un \textit{plugin} \\
\hline
\verb|-verbose| & sortie verbale, pour plus de détails & $\emptyset$ \\
\verb|-verbose| & pour plus de détails dans la sortie & $\emptyset$ \\
\hline
\verb|-output-directory=dossier| & place le résultat de la & pour plus de propreté\\
& compilation dans ce dossier & dans vos dossiers\\
......@@ -324,11 +324,38 @@ Les options les plus utiles sont résumées dans le tableau suivant. Et pour plu
\verb|-shell-escape|& des commandes au terminal & des graphes Ti$k$Z \\
& (écriture sur la sortie $18$) & \\
\hline
\verb|-draftmode| & compile sans inclure les images & accélère la compilation \\
& et sans créer de \texttt{.pdf} & \\
\hline
\end{tabular}
\subsection{Le déroulement de la compilation}
\subsection{Le déroulement de la compilation : incidents et fichiers auxiliaires}
\label{subsec:erreurs}
Lors de la compilation, des erreurs peuvent survenir si vous avez fait une erreur (syntaxique ou logique)\footnote{une bonne syntaxe \LaTeX{} est assez exigeante, ne vous étonnez pas si vous avez beaucoup d'erreurs, une grande partie d'entre elles sont surement innofensives}.
Si vous n'êtes pas en \verb|nonstopmode| la compilation se mettre en pause et on vous proposera de résoudre cette erreur avant de continuer.\\
Si vous êtes en \verb|nonstopmode|, regardez attentivement votre document de sortie car une erreur a pu avoir lieu sans que vous ne l'ayez vue.
Les erreurs se classent en deux catégories :
\begin{itemize}
\item les \textit{avertissements} sont pour la plupart innofensifs, et vous pouvez les ignorer dans un premier temps et y revenir s'ils vous posent problème
\item les \textit{erreurs fatales} vont causer un arrêt soudain de la compilation et ne pas produire de document
\end{itemize}
\startaurel .aux, .log, .toc, .bbl, .synctex, etc... \closeaurel
Dans tous les cas les erreurs sont écrites dans un fichier texte portant l'extension \texttt{.log}, que vous pouvez consulter en cas de problème. Un \textit{IDE} est en général capable de lire automatiquement les \texttt{.log} et de vous signaler un problème.
L'annexe \ref{app:errors} présente des erreurs courantes et la façon d'y remédier, n'hésitez pas à la consulter en cas de problèmes.
Un avertissement mérite néanmoins d'être présenté dans cette section : \\\og \texttt{LaTeX Warning: There were undefined references} \fg{}\\
Cet avertissement apparaît si vous avez utilisé un \verb|\ref{}| auquel ne correspond aucune étiquette (voir au \ref{subsec:label}), mais la petite subtilité est qu'il apparaîtra également si c'est la première fois que vous compilez depuis que vous avez créé l'étiquette...
En effet le compilateur lit le fichier source linéairement et est donc parfaitement incapable de gérer des références croisées ! Pour contourner ce problème il écrit les étiquette dans un fichier texte portent l'extension \texttt{.aux} (pour auxiliaire), et lorsqu'il rencontre une référence il cherche si une étiquette correspondante existe dans le \texttt{.aux}.
Pour cette raison une référence croisée n'apparaît jamais lors de sa première compilation, et deux compilations sont donc nécéssaires !
Pour finir, notez que le compilateur va créer des fichiers secondaires (le \texttt{.log}, le \texttt{.aux}, et d'autres) lors de la compilation. Vous les trouverez peut-être inutiles et aurez envie de vous en débarasser, mais ils ont de l'importance pour \verb|pdflatex| et les supprimer revient à tout devoir recompiler.
\subsection{Compiler la bibliographie}
......@@ -1047,7 +1074,7 @@ En plus de \textit{label}, \verb=enumitem= prend encore quelques options permett
L'une des puissances de \LaTeX{} est de permettre d'appeler automatiquement les numéros ou lettres de tout ce qui peut être repéré de la sorte (sections, figures, tableaux, \ldots). Ainsi, nous nous trouvons actuellement dans la sous-sous-section~\ref{subsec:label}, sur la page~\pageref{subsec:label}, et l'annexe~\ref{sec:template} page~\pageref{sec:template} contient un modèle pour commencer à rédiger un article.
Les commandes \verb=\label=, \verb=\ref= et \verb=\pageref= sont très simples à utiliser. L'avantage est que si vous changez la disposition de votre document (insertion d'une nouvelle partie, ajout de sauts de pages, etc.), il vous suffit de compiler à nouveau pour que les références prennent les bonnes valeurs.\\
\emph{Comme pour certaines autres fonctionnalités, il est nécessaire de compiler deux fois afin que les références s'affichent correctement. Une seule compilation mène à l'affichage de deux points d'interrogation ou de la précédente valeur en lieu de la bonne référence.}
\emph{Comme pour certaines autres fonctionnalités, nous vous rappelons qu'il est nécessaire de compiler deux fois afin que les références s'affichent correctement. Une seule compilation mène à l'affichage de deux points d'interrogation ou de la précédente valeur en lieu de la bonne référence. Pour plus de détails référez-vous au \ref{subsec:erreurs}}
Voici comment ces commandes viennent d'être utilisées :
\begin{lstlisting}
......@@ -2345,7 +2372,9 @@ Mon beau résumé
\pagebreak
\section{Lire les erreurs de compilation dans le \texttt{.log}}
\section{Les erreurs de compilation courantes}
\label{app:errors}
\end{appendices}
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment