Un squelette réutilisable

Classe, préambule, maketitle, sections, bibliographie : la forme de presque tous les articles.

Un squelette réutilisable

Si l’on retire le contenu, presque tous les documents LaTeX ont le même squelette : une déclaration de classe, un préambule de configuration et un corps placé entre \begin{document} et \end{document}. Une fois cette forme connue, démarrez un nouveau projet en collant le squelette, en changeant le titre et en écrivant.

\documentclass[11pt]{article}
% preamble: packages, macros, metadata
\title{...}
\author{...}
\begin{document}
\maketitle
% body: sections, figures, bibliography
\end{document}

Lecture de haut en bas : \documentclass[11pt]{article} choisit le type de document et fixe en option la taille de police de base. Tout le reste de la mise en forme découle de ce choix. La zone entre la ligne de classe et \begin{document} est le préambule, où l’on charge les packages et où sont stockées les métadonnées comme \title et \author. \begin{document} marque le début du contenu visible, \maketitle compose le bloc de titre enregistré, et le corps suit sous forme de sections, de figures et, au final, d’une bibliographie. \end{document} ferme le document. Tout ce qui le suit est ignoré en silence, ce qui cache parfois un morceau de texte collé au mauvais endroit.

Choix de la classe

ClasseUsage
articleArticles, devoirs, notes
reportRapports plus longs avec chapitres
bookLivres et beaucoup de thèses
beamerDiapositives

La classe n’est pas cosmétique : elle change les commandes disponibles. article n’a pas de \chapter, donc y coller des chapitres de thèse échoue immédiatement. report ajoute les chapitres et donne au titre sa propre page. book suppose une impression recto verso et ouvre les chapitres sur les pages de droite. beamer restructure tout autour de frames pour les diapositives. Les revues et les conférences fournissent leurs propres classes, et quand vous écrivez pour l’une d’elles, sa classe remplace entièrement ce choix.

Deux erreurs expliquent la plupart des squelettes cassés. Du texte placé avant \begin{document} déclenche l’erreur « Missing \begin{document} », car le préambule peut seulement configurer, jamais imprimer. Et un \end{document} manquant laisse le compilateur attendre à la fin du fichier avec un message peu utile sur la fin de l’entrée. Quand l’une ou l’autre apparaît, vérifiez l’ossature du document avant de soupçonner le contenu.

Le squelette s’adapte à toutes les tailles. Une note de quatre pages garde le corps dans le même fichier ; une thèse place chaque chapitre dans son propre fichier et les importe depuis la racine, comme le montre séparer les chapitres en fichiers. L’ossature qui les entoure ne change pas.

Vérification du squelette de 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