Ton premier document

Dans cette leçon, tu écris ton premier document. Imagine que Moussa, étudiant à Bamako, doit rendre un devoir maison d'analyse. Il veut une page propre avec un titre, son nom, deux exercices et quelques formules. On va construire ce fichier ensemble, ligne par ligne. Tu vas voir les trois parties de tout document LaTeX, la façon dont LaTeX traite les espaces et les paragraphes, et les quelques caractères qui ont un sens spécial. À la fin, tu sauras compiler et repérer les fichiers que la compilation laisse dans ton dossier.

Tout document LaTeX suit le même squelette. La première ligne choisit la classe, avec la commande documentclass. Pour un devoir ou un article court, on prend la classe article. Entre crochets, tu donnes des options : le format A4 et une taille de caractères de douze points, par exemple. Ensuite vient le préambule, où tu charges des extensions avec la commande usepackage, comme amsmath pour les mathématiques. Le texte lui-même se place entre begin document et end document. Tout ce que tu écris après end document est ignoré. Garde ce squelette dans un fichier à part : tu le recopieras au début de chaque nouveau travail.

Pour le titre, tu remplis trois informations dans le préambule : le titre, l'auteur et la date. La commande today écrit la date du jour de la compilation ; pour une date fixe, écris-la entre les accolades. Ces commandes ne s'affichent pas seules : c'est maketitle, placée juste après le début du document, qui fabrique le bloc de titre. Dans le titre de Moussa, la commande no de babel-french écrit l'abréviation de numéro avec un o en exposant, plus juste que le signe degré. Pour un devoir, ce bloc suffit. Pour un mémoire, tu feras une vraie page de titre au module 2.

Dans le corps du document, une ligne vide marque un nouveau paragraphe. Un simple retour à la ligne ne suffit pas : LaTeX le traite comme une espace. De même, si tu tapes cinq espaces entre deux mots, il n'en garde qu'une. Ne cherche donc pas à aligner ton texte avec la barre d'espace. Pour un titre, utilise la commande section avec le titre entre accolades : LaTeX le numérote et choisit sa taille. Pour insister sur un mot, la commande emph le met en italique, ou le remet en romain s'il est déjà dans une phrase en italique. C'est plus souple que de forcer l'italique partout.

Un devoir contient souvent une liste d'hypothèses ou d'étapes. L'environnement itemize fait une liste à puces, et enumerate une liste numérotée ; chaque élément commence par la commande item. Tu peux placer une liste dans une autre, mais ne descends pas au-delà de deux niveaux, sinon le lecteur se perd. Avec babel en français, les puces deviennent des tirets, tu le verras à la leçon suivante. Pour une note de bas de page, écris la commande footnote juste après le mot concerné, avec le texte de la note entre accolades : LaTeX la numérote et la place en bas de la page. Garde tes notes courtes.

Dix caractères ont un rôle particulier. L'antislash commence une commande. Les accolades regroupent. Le dollar ouvre et ferme une formule. L'esperluette sépare les colonnes d'un tableau. Le croisillon sert aux paramètres des commandes. L'accent circonflexe et le tiret bas font les exposants et les indices. Le tilde fait une espace insécable. Et le signe pour cent commence un commentaire. Voici le piège classique : tu écris « le taux de réussite est de 50 % » et la fin de ta ligne disparaît du PDF, parce que LaTeX la prend pour un commentaire. Il faut un antislash devant le signe pour cent, et de même devant le dollar ou l'esperluette.

Quand tu compiles, tu obtiens ton PDF, mais aussi d'autres fichiers à côté de ton fichier source. Le fichier point log est le journal : il raconte tout ce que le compilateur a fait et signale les erreurs. Le fichier point aux garde les numéros de sections, de figures et d'équations, et le fichier point toc garde la table des matières. Ils servent de mémoire d'une compilation à l'autre. C'est pour cela qu'une table des matières ou un renvoi n'apparaît correctement qu'à la deuxième compilation. Sur un éditeur en ligne, ces fichiers sont cachés, mais ils existent. En local, tu peux les effacer sans risque : ils se recréent.

Retiens le squelette : la classe, le préambule où tu charges tes extensions, puis le corps entre begin document et end document. Une ligne vide fait un nouveau paragraphe, et les espaces multiples ne servent à rien. Les listes s'écrivent avec itemize ou enumerate, et une note avec footnote. Devant le signe pour cent, le dollar, l'esperluette, le croisillon et le tiret bas, tu ajoutes un antislash si tu veux les afficher. Et pense à compiler deux fois quand tu ajoutes une table des matières ou un renvoi. Avant la prochaine leçon, essaie le squelette du devoir de Moussa dans ton éditeur. Ensuite, on règle LaTeX pour écrire correctement en français.