Compilez votre premier PDF

Si vous n’avez jamais écrit qu’avec Word ou Google Docs, LaTeX vous demande d’inverser une habitude. Au lieu de formater le texte au fur et à mesure que vous tapez, vous décrivez votre document en texte brut et laissez un programme le composer pour vous. Ce texte brut se trouve dans un fichier .tex : un fichier texte ordinaire que vous pouvez ouvrir dans n’importe quel éditeur, avec vos mots plus des commandes comme \section{...} qui disent ce que est chaque morceau. La compilation transforme cette source en un PDF fini. Un moteur LaTeX lit votre fichier de haut en bas, interprète chaque commande, dispose les pages et écrit le PDF. Vous ne formatez jamais directement la sortie. Vous modifiez la source et compilez à nouveau.

Le plus petit document réel

\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} indique au moteur de quel type de document il s’agit, qui définit des valeurs par défaut raisonnables pour les polices, les marges et les styles de titre. Les lignes \title, \author et \date stockent uniquement les métadonnées ; rien n’est encore imprimé, et \today signifie simplement la date du jour où vous compilez. \begin{document} marque l’endroit où commence le contenu réel. \maketitle est le moment où le cartouche stocké apparaît sur la page. \section{Introduction} imprime un en-tête numéroté et l’enregistre discrètement afin qu’une table des matières puisse le retrouver plus tard. Les dernières lignes montrent les deux faces des mathématiques : $...$ compose une formule à l’intérieur d’une phrase, tandis que \[ ... \] lui donne sa propre ligne d’affichage centrée.

Trois idées qui portent le langage

1. Les commandes commencent par une barre oblique inverse et prennent généralement un argument entre accolades, donc \textbf{hello} signifie « composer bonjour en gras ».
2. Les environnements enveloppent 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 dans LaTeX est une variation de ces trois éléments.

Compilez-le

Dans Oleafly, créez un projet, collez la source ci-dessus et compilez. Le PDF apparaît à côté de votre source et SyncTeX relie les deux côtés : cliquez à un endroit du PDF pour accéder à la ligne source correspondante, ou inversement. 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 courses ultérieures sont plus rapides.

Une chose à laquelle il faut s’attendre : tôt ou tard, une compilation échouera avec un message d’erreur et un numéro de ligne. Ceci est tout à fait normal et signifie généralement une faute de frappe dans le nom d’une commande ou une accolade fermante manquante. Corrigez la ligne sur laquelle il pointe et compilez à nouveau.

Suivant

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