Compilez votre premier PDF

Un petit article, une compilation et les trois idées qui vous donnent l'essentiel de LaTeX.

Compilez votre premier PDF

Si vous n’avez jamais écrit que dans Word ou Google Docs, LaTeX vous demande de changer une habitude. Au lieu de mettre le texte en forme au fil de la frappe, vous décrivez votre document en texte brut et vous laissez un programme le composer pour vous. Ce texte brut vit dans un fichier .tex : un fichier texte ordinaire que vous pourriez ouvrir dans n’importe quel éditeur, contenant vos mots et des commandes comme \section{...} qui disent ce que chaque morceau est. La compilation transforme ce code source en un PDF fini. Un moteur LaTeX lit votre fichier de haut en bas, interprète chaque commande, met les pages en forme et écrit le PDF. Vous ne mettez jamais en forme le résultat directement. Vous modifiez le code source et vous recompilez.

Le plus petit vrai document

\documentclass{article}
\title{My First Document}
\author{Your Name}
\date{\today}
\begin{document}
\maketitle
\section{Introduction}
Hello, \LaTeX! Math works inline like $E = mc^2$ or on its own line:
\[
x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}
\]
\end{document}

Lisez-le de haut en bas. \documentclass{article} dit au moteur de quel type de document il s’agit, ce qui fixe des valeurs par défaut raisonnables pour les polices, les marges et les styles de titres. Les lignes \title, \author et \date ne font que mémoriser des métadonnées ; rien n’est encore imprimé, et \today désigne simplement la date du jour où vous compilez. \begin{document} marque l’endroit où le contenu proprement dit commence. \maketitle est le moment où le bloc de titre mémorisé apparaît sur la page. \section{Introduction} imprime un titre numéroté et l’enregistre discrètement pour qu’une table des matières puisse le retrouver plus tard. Les dernières lignes montrent les deux visages des mathématiques : $...$ compose une formule à l’intérieur d’une phrase, tandis que \[ ... \] lui donne sa propre ligne centrée.

Trois idées qui portent le langage

  1. Les commandes commencent par une barre oblique inverse (antislash) et prennent généralement un argument entre accolades, donc \textbf{hello} signifie « composer hello en gras ».
  2. Les environnements encadrent une région entre \begin{...} et \end{...}, et le corps de votre fichier est lui-même un grand environnement document.
  3. Le préambule est tout ce qui précède \begin{document} ; il configure le document mais ne produit jamais de texte visible.

Presque tout le reste de LaTeX est une variation sur ces trois idées.

Compilez-le

Dans Oleafly, créez un projet, collez le code source ci-dessus et compilez. Le PDF apparaît à côté de votre code source, et SyncTeX relie les deux côtés : Cmd-clic sur macOS ou Ctrl-clic sous Windows et Linux dans le PDF pour sauter à la ligne de code correspondante, ou l’inverse. La toute première compilation d’un projet peut prendre un peu plus de temps, le temps que le moteur récupère ce dont il a besoin ; les suivantes sont plus rapides.

Une chose à prévoir : tôt ou tard, une compilation échouera avec un message d’erreur et un numéro de ligne. C’est tout à fait normal, et cela signifie généralement une faute de frappe dans le nom d’une commande ou une accolade fermante manquante. Corrigez la ligne indiquée et recompilez.

La suite

Continuez avec le préambule expliqué pour voir ce que font vraiment les lignes de configuration, puis avec le mode mathématique pour les formules. Gardez l’aide-mémoire ouvert pendant que vous écrivez votre première vraie page.

Vérification : premier documentQuiz d’entraînement facultatif5 questions

Une courte vérification de ce que couvre cette leçon. Les mauvaises réponses affichent la bonne. Les choix sont mélangés à chaque tentative. Vous pouvez recommencer autant de fois que vous le souhaitez.

Retour à Ouvrir la boucle