Classe de document et préambule

Tout document LaTeX commence par une seule ligne : \documentclass. La classe de document choisie ici fixe l’ossature et l’apparence de tout le document, qu’il s’agisse d’un article, d’un livre ou d’un jeu de diapositives. Ensuite, dans le préambule, entre \documentclass et \begin{document}, vous déclarez les packages utilisés et les réglages qui s’appliquent à tout le document. L’objectif de ce chapitre est de savoir décider, avant de rédiger le corps du texte, quelle classe choisir et ce qui doit aller dans le préambule.

\documentclass — la première ligne

Chaque document commence par la déclaration \documentclass[options]{class}. Cette commande est obligatoire et doit venir en premier : rien, sauf des commentaires, ne peut la précéder. Le nom de classe entre accolades {} choisit le type de document, et les options entre crochets [] ajustent des détails comme la taille de police et le papier ; elles sont facultatives.

Une classe gouverne l’apparence générale : police et taille des titres, numérotation des chapitres et sections, marges, en-têtes et pieds de page. Ces règles vivent dans un fichier de classe, d’extension .cls. Dans le corps, vous écrivez seulement le sens, par exemple \section{Introduction}, et la classe le transforme en mise en forme concrète. En changeant seulement de classe, le même manuscrit peut donc être recomposé dans un autre style. Choisir la classe au départ, ce n’est pas seulement choisir des polices ; c’est choisir la structure du document.

Les classes standard

LaTeX fournit ces classes dès le départ. article est la classe généraliste la plus utilisée, pour les articles scientifiques et les documents courts. Elle n’a pas de chapitres (\chapter) ; le niveau supérieur est la section (\section). report se situe entre l’article et le livre, pour des documents plus longs avec chapitres, comme les rapports techniques et les thèses. book sert aux véritables livres : chapitres, impression recto verso supposée, et séparation entre avant-propos, corps principal et parties finales. letter sert aux lettres, et slides aux diapositives, mais cette dernière est aujourd’hui rarement utilisée.

Dans book en particulier, le document se divise avec \frontmatter / \mainmatter / \backmatter. La zone \frontmatter (préface, table des matières, etc.) est numérotée en chiffres romains minuscules (i, ii, iii…) et ses chapitres ne sont pas numérotés. \mainmatter réinitialise la pagination, passe aux chiffres arabes (1, 2, 3…), et la numérotation des chapitres commence. \backmatter (annexes, index) garde la pagination arabe mais supprime les numéros de chapitre.

Au-delà des classes standard (beamer, KOMA-Script, japonais)

Au-delà des classes standard, CTAN propose de nombreuses classes pour des usages précis. Pour des diapositives de présentation, beamer est le choix standard : chaque environnement frame devient une diapositive, avec affichage progressif (overlays) et thèmes. Pour remplacer les classes standard par une typographie par défaut plus soignée, les classes KOMA-Script scrartcl / scrreprt / scrbook (correspondant à article / report / book) sont très utilisées et nettement plus configurables.

Pour la composition japonaise, il faut choisir une classe dédiée adaptée au moteur. Avec pLaTeX / upLaTeX, les jsarticle / jsbook de Haruhiko Okumura (jsclasses) sont la référence. Avec LuaLaTeX, on utilise leurs équivalents LuaLaTeX, ltjsarticle / ltjsbook (ltjsclasses). La classe plus récente jlreq repose sur les “Requirements for Japanese Text Layout (JLReq)” ; elle fonctionne avec pLaTeX, upLaTeX ou LuaLaTeX et détecte automatiquement le moteur (les options report / book la font se comporter comme report ou book). Si une université ou une revue fournit un modèle, privilégiez d’abord sa classe et n’ajoutez ensuite que les ajustements visuels strictement nécessaires.

Options courantes

Les options se placent entre crochets, séparées par des virgules, par exemple \documentclass[11pt,a4paper,twoside]{article}. Les plus courantes sont listées ci-dessous ; la plupart sont des interrupteurs à l’échelle du document.

Dans book, le fait que les chapitres commencent sur une page de droite (impaire) est contrôlé par openright (défaut de book) ou openany (défaut de report). Les options données ici sont transmises non seulement à la classe, mais aussi aux packages chargés ensuite : ce sont des options globales.

Le préambule — \usepackage et réglages globaux

Les lignes qui suivent \documentclass jusqu’à juste avant \begin{document} forment le préambule. Ce n’est pas encore le corps : c’est l’endroit où l’on prépare tout le document. Le corps, c’est-à-dire le contenu imprimé, commence à \begin{document} et se termine à \end{document}.

L’outil central du préambule est \usepackage[options]{package}. Là où la classe fixe l’apparence de base, un package, d’extension .sty, ajoute des fonctions utilisables quel que soit le type de document : par exemple amsmath pour enrichir les mathématiques, graphicx pour insérer des figures, ou hyperref pour ajouter des liens. Une seule commande peut charger plusieurs packages à la fois (\usepackage{amsmath,amssymb}). Règle pratique : si cela façonne l’apparence d’un type de document, c’est une classe ; si cela ajoute une fonction indépendante du type, c’est un package.

Outre le chargement de packages, le préambule contient les réglages et définitions applicables à tout le document : les métadonnées de titre \title{...}, \author{...}, \date{...}, vos commandes avec \newcommand, les longueurs avec \setlength, le style de page avec \pagestyle, etc. Ils doivent être déclarés avant le corps ; les placer dans le corps peut n’avoir aucun effet ou provoquer une erreur.

Voici un exemple complet avec un préambule typique. Il choisit une classe, charge des packages pour l’encodage et la langue, définit une commande, règle les marges et les métadonnées de titre, puis entre dans le corps.

\documentclass[11pt,a4paper]{article}

% --- preamble: packages ---
\usepackage[T1]{fontenc}
\usepackage{amsmath}      % better mathematics
\usepackage{graphicx}     % \includegraphics
\usepackage[margin=25mm]{geometry}
\usepackage{hyperref}     % load last

% --- preamble: settings & definitions ---
\newcommand{\R}{\mathbb{R}}
\setlength{\parindent}{0pt}
\title{A Short Note}
\author{Ada Lovelace}
\date{\today}

\begin{document}
\maketitle
Hello, \LaTeX! For all $x \in \R$ we have $x^2 \ge 0$.
\end{document}

L’ordre de chargement compte aussi. Des packages susceptibles d’interférer peuvent changer de comportement selon la séquence, et certains, comme hyperref, sont généralement chargés vers la fin ; il existe des exceptions, à vérifier dans les manuels concernés. Pour un document japonais, la première étape consiste à changer la classe elle-même, par exemple vers jsarticle ou ltjsarticle : choisir une classe adaptée au moteur est primordial. Si le réglage du préambule vous empêche d’écrire le corps, revenir à une configuration minimale et avancer le texte est une bonne décision d’ingénierie.

Ne laissez pas le préambule dépasser le document

Le préambule est le socle du document, pas un fourre-tout. Les retouches visuelles ponctuelles, les packages seulement essayés et les abréviations sans signification rendent les erreurs difficiles à retrouver plus tard. Commencez avec les seuls réglages globaux : classe, langue et polices, mathématiques, figures et tableaux, liens. N’ajoutez \newcommand que pour les constructions qui se répètent vraiment pendant la rédaction. Avec un modèle de soumission, respectez le préambule fourni et évitez de remplacer des packages qui peuvent être liés à la classe.

• Nouveau rapport : commencez avec article ou jsarticle ; n’ajoutez pas de mise en page complexe avant d’en avoir besoin.
• Thèse : privilégiez la classe du modèle universitaire et gardez les ajustements de marges ou de titres pour la fin.
• Japonais + polices OpenType : choisissez une classe adaptée au moteur, par exemple ltjsarticle/jlreq avec LuaLaTeX ou jsarticle avec upLaTeX.
• En cas d’erreur : suspectez le dernier \usepackage ou \newcommand ajouté, puis réduisez à un exemple minimal.