Tout ce qui précède begin{document}

Extensions, métadonnées et ordre de chargement : ce qui relève du préambule et ce qui n'en relève pas.

Tout ce qui précède begin{document}

Tout ce qui se trouve entre \documentclass{...} et \begin{document} forme le préambule. Il ne produit aucun texte visible. Il configure la compilation. Les polices, les marges, les extensions, les commandes personnalisées et les métadonnées du document s’y trouvent, ce qui explique que le préambule d’un article abouti soit souvent plus long que son introduction. Dès que vous savez ce que fait chaque ligne, un modèle copié cesse d’être magique et devient une liste de contrôle.

Anatomie

\documentclass[11pt,a4paper]{article}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage[margin=1in]{geometry}
\usepackage{amsmath,amssymb}
\usepackage{graphicx,booktabs}
\usepackage{hyperref} % load late
\title{Title}
\author{You}
\date{\today}

Les options de \documentclass fixent les valeurs par défaut globales : 11pt est la taille de police de base à partir de laquelle tout le reste est calculé, et a4paper déclare le format du papier. Les deux lignes d’encodage sont des compagnons historiques : inputenc indique au moteur que votre fichier source est en UTF-8, et fontenc choisit l’encodage des polices pour que les caractères accentués soient de vrais glyphes plutôt que des composés. Le LaTeX actuel suppose déjà une entrée en UTF-8, vous verrez donc ces lignes omises dans les documents récents, mais elles sont sans danger et les modèles les conservent par compatibilité.

Le bloc central charge les extensions de fonctionnalités. geometry règle les marges en une seule option, amsmath et amssymb fournissent les environnements mathématiques et les symboles dont presque tout document technique a besoin, graphicx active \includegraphics pour les figures, et booktabs fournit les filets qui donnent aux tableaux un aspect professionnel. Enfin, hyperref rend les références et les citations cliquables, et il est chargé en dernier à dessein, parce qu’il redéfinit des éléments internes de nombreuses autres extensions.

Les lignes \title, \author et \date ne font que mémoriser des métadonnées. Rien ne s’imprime tant que \maketitle n’est pas exécuté dans le corps, ce qui explique qu’elles puissent se trouver dans le préambule.

Règles pratiques

Quelques habitudes gardent les préambules en bonne santé. Chargez une extension par tâche et évitez d’empiler des extensions qui se disputent le même terrain, comme deux façons de régler les marges. Gardez hyperref à la fin, à l’exception de quelques cas documentés comme cleveref, qui doit venir après lui. Mettez les choix valables pour tout le document dans les options de classe plutôt que de les disperser, afin que 11pt ou twocolumn soit déclaré une seule fois, là où chacun peut le voir. Et quand vos macros personnalisées dépassent quelques lignes, déplacez-les dans un fichier .sty pour que plusieurs documents partagent le même ensemble de définitions.

La discipline la plus utile est négative : si vous ne savez pas pourquoi une ligne du préambule est là, renseignez-vous avant que votre document n’en dépende. Les préambules copiés accumulent des lignes mortes, et c’est dans les lignes mortes que se cachent les conflits entre extensions. Voir aussi le squelette d’un document et comparaison des moteurs.

Vérification du préambuleQuiz 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