Un document complet

Informatique — LaTeX, chapitre 4

Les trois premiers chapitres n’ont produit que des formules isolées. Il est temps de fabriquer un document : un fichier .tex que l’on compile et qui donne un PDF.

Des fichiers à compiler

L’éditeur des chapitres précédents ne rend que des formules : il ne peut pas compiler un document entier. Les blocs qui suivent sont donc à recopier dans Overleaf — rien à installer — ou dans votre distribution locale.

Ouvrez Overleaf dans un onglet et suivez le chapitre en parallèle : chaque bloc y compile tel quel.

4.1 Le plus petit document possible

\documentclass{article}

\begin{document}

Bonjour. Voici mon premier document.

\end{document}

Trois éléments, et un seul est facultatif :

\documentclass{...} déclare le type de document — obligatoire, toujours en première ligne ;
tout ce qui suit jusqu’à \begin{document} est le préambule : réglages, paquets, définitions ;
entre \begin{document} et \end{document} vient le contenu.

Rien n’existe hors du corps

Un texte écrit dans le préambule ne s’affichera pas — LaTeX l’ignore, ou proteste. Et tout ce qui suit \end{document} est ignoré silencieusement.

C’est le premier réflexe à vérifier quand une partie de votre texte disparaît sans message d’erreur.

4.2 Le préambule

4.2.1 Un préambule de travail

\documentclass[11pt,a4paper]{article}

% --- Langue et encodage ---
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage[french]{babel}

% --- Mathematiques ---
\usepackage{amsmath, amssymb, amsthm}

% --- Mise en page ---
\usepackage[margin=2.5cm]{geometry}
\usepackage{graphicx}
\usepackage{booktabs}
\usepackage[hidelinks]{hyperref}

\title{Un titre de travail}
\author{Jaouad Madkour}
\date{\today}

\begin{document}
\maketitle

Le texte commence ici.

\end{document}

Ce préambule couvre 90 % des besoins d’un mémoire. Conservez-le : vous le réutiliserez à chaque nouveau document.

4.2.2 Ce que fait chaque ligne

Paquet	Rôle
`inputenc`	lire les accents tapés au clavier
`fontenc`	les composer correctement, et permettre la césure
`babel`	langue du document : titres, dates, règles typographiques
`amsmath`, `amssymb`	les constructions et symboles des chapitres 2 et 3
`geometry`	marges
`graphicx`	insérer des images
`booktabs`	tableaux de qualité professionnelle
`hyperref`	liens cliquables — toujours en dernier

hyperref se charge en dernier

Ce paquet redéfinit un grand nombre de commandes internes. Chargé avant les autres, il produit des conflits difficiles à diagnostiquer.

Règle simple : hyperref est la dernière ligne de vos \usepackage. L’option hidelinks évite les cadres colorés autour des liens, laids à l’impression.

babel et la typographie française

\usepackage[french]{babel} ne traduit pas seulement « Chapitre » et « Table des matières ». Il applique les règles françaises : espace fine insécable avant ; : ! ?, guillemets « à la française », tirets de liste conformes.

Sans lui, un document en français est immédiatement reconnaissable — et pas à son avantage.

Avec les moteurs modernes XeLaTeX ou LuaLaTeX, inputenc et fontenc deviennent inutiles ; on écrit à la place :

\usepackage{fontspec}
\setmainfont{Latin Modern Roman}

Si vous débutez, restez sur pdfLaTeX et le préambule ci-dessus.

4.3 Les classes de document

Classe	Usage
`article`	article, rapport court, devoir — pas de chapitres
`report`	mémoire, rapport long — chapitres, page de titre séparée
`book`	thèse, ouvrage — chapitres, recto-verso
`beamer`	diapositives — chapitre 8

\documentclass[12pt, a4paper, twoside]{report}

Les options usuelles : 10pt/11pt/12pt pour le corps, a4paper, twoside pour un recto-verso, draft pour signaler les débordements de marge par un trait noir.

4.4 Structurer le texte

\section{Le cadre théorique}
\subsection{Les hypothèses}
\subsubsection{Hypothèse d'exogénéité}

\paragraph{Un point de détail}
Le texte du paragraphe suit sur la même ligne.

Avec report et book, un niveau supérieur s’ajoute : \chapter{...}.

\tableofcontents        % table des matieres
\listoffigures          % liste des figures
\listoftables           % liste des tableaux

La numérotation est automatique — n’y touchez jamais

Vous n’écrivez jamais « 2.3.1 ». LaTeX numérote, et renumérote si vous insérez une section au milieu. C’est le premier bénéfice tangible du langage.

L’étoile supprime le numéro et l’entrée dans la table des matières : \section*{Remerciements}.

Et pour changer la profondeur affichée dans la table :

\setcounter{tocdepth}{2}      % jusqu'aux sous-sections
\setcounter{secnumdepth}{3}   % numeroter jusqu'aux sous-sous-sections

4.5 La mise en forme du texte

Du texte \textbf{en gras}, \textit{en italique}, \texttt{en machine à écrire},
\textsc{en petites capitales}, \underline{souligné}.

N’utilisez pas \underline

Le soulignement vient de la machine à écrire, qui ne savait pas faire d’italique. En typographie imprimée, il n’a aucune place : il coupe les jambages des lettres et alourdit la page.

Pour insister, l’italique — \emph{...} de préférence à \textit{...}, car \emph s’inverse automatiquement à l’intérieur d’un passage déjà en italique.

\begin{itemize}
  \item Premier point
  \item Deuxième point
\end{itemize}

\begin{enumerate}
  \item Premier
  \item Deuxième
\end{enumerate}

\begin{quote}
Une citation détachée du texte.
\end{quote}

4.6 Les espaces et les paragraphes

LaTeX ignore vos espaces

Deux espaces, dix espaces, un retour à la ligne unique : LaTeX ne voit qu’une seule espace.

Un nouveau paragraphe se marque par une ligne vide. Rien d’autre — surtout pas \\, qui force un retour à la ligne sans créer de paragraphe, et produit une mise en page irrégulière.

Premier paragraphe.

Deuxième paragraphe.

C’est déroutant au début, et c’est ce qui permet à LaTeX de justifier et de césurer correctement. Vous décrivez la structure ; lui s’occupe de l’apparence.

Quelques espaces utiles :

Le~\ref{fig:pib} montre...     % ~ : espace insecable
\vspace{1cm}                    % espace vertical
\newpage                        % nouvelle page
\noindent                       % supprimer l'alinea

L’espace insécable ~ empêche une coupure malvenue : entre « figure » et son numéro, entre « M. » et un nom, entre un nombre et son unité.

4.7 Compiler

4.7.1 Le principe

Un fichier .tex produit un .pdf et plusieurs fichiers auxiliaires :

Extension	Contenu
`.aux`	numéros de sections, étiquettes, renvois
`.log`	le journal complet — c’est lui qu’on lit en cas d’erreur
`.toc`	table des matières
`.bbl`, `.blg`	bibliographie (chapitre 6)

Pourquoi compiler deux fois

À la première passe, LaTeX découvre les numéros de sections et les stocke dans le .aux. À la seconde, il les emploie pour résoudre les renvois.

Un document compilé une seule fois affiche donc ?? à la place des références, et une table des matières vide ou périmée.

Overleaf compile autant de fois que nécessaire. En local, prenez l’habitude de compiler deux fois — ou employez latexmk, qui s’en charge :

latexmk -pdf memoire.tex

4.7.2 Lire une erreur

! Undefined control sequence.
l.42 \mathbb
            {R}

Trois informations dans ce message : le type d’erreur, la ligne — ici 42 —, et le point exact où LaTeX a buté. Ici, \mathbb sans le paquet amssymb.

Message	Cause habituelle
`Undefined control sequence`	commande inconnue : faute de frappe, ou `\usepackage` manquant
`Missing $ inserted`	une commande mathématique employée hors mode mathématique
`Runaway argument`	une accolade non fermée
`File not found`	image ou fichier absent, ou chemin erroné
`Overfull \hbox`	avertissement : une ligne déborde de la marge

La méthode qui résout tout

Corrigez la première erreur, puis recompilez. Une erreur en engendre souvent dix autres qui disparaîtront d’elles-mêmes.

Si la ligne indiquée semble correcte, regardez au-dessus : une accolade non fermée ou un \begin sans \end déplace le diagnostic bien après sa cause réelle.

Et quand vous ne trouvez rien : commentez la moitié du document, compilez, recommencez sur la moitié fautive. Cinq itérations suffisent à isoler la ligne, quelle que soit la taille du fichier.

4.8 Un document complet

\documentclass[11pt,a4paper]{article}

\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage[french]{babel}
\usepackage{amsmath, amssymb}
\usepackage[margin=2.5cm]{geometry}
\usepackage[hidelinks]{hyperref}

\title{Croissance et chômage au Maroc}
\author{Jaouad Madkour\\ \small Université Abdelmalek Essaâdi}
\date{\today}

\begin{document}

\maketitle

\begin{abstract}
Ce document examine la relation entre croissance du PIB et taux
de chômage à partir de données régionales.
\end{abstract}

\tableofcontents
\newpage

\section{Introduction}

La loi d'Okun établit une relation négative entre variation du
chômage et croissance économique.

\section{Le modèle}

Nous estimons par les moindres carrés ordinaires
\begin{equation}
\label{eq:okun}
\Delta u_t = \alpha + \beta \, g_t + \varepsilon_t,
\end{equation}
où $\Delta u_t$ désigne la variation du taux de chômage et $g_t$
le taux de croissance.

L'estimateur s'écrit
\[
\hat{\beta} = \frac{\sum_{t=1}^{T}(g_t - \bar{g})(\Delta u_t - \overline{\Delta u})}
                   {\sum_{t=1}^{T}(g_t - \bar{g})^2}.
\]

\section{Conclusion}

Le coefficient de l'équation~\eqref{eq:okun} est négatif,
conformément à la théorie.

\end{document}

Ce fichier compile tel quel. Il contient tout ce qu’a présenté le chapitre : classe, préambule, page de titre, résumé, table des matières, sections, équation numérotée et renvoi.

À vous

Reprenez ce document, ajoutez une section « Données » entre l’introduction et le modèle, une liste à puces décrivant trois variables, et vérifiez que la numérotation se réajuste seule.

La solution

\section{Données}

L'échantillon couvre douze régions sur la période 2010--2023.
Trois variables sont mobilisées :

\begin{itemize}
  \item le taux de chômage régional, en pourcentage de la population active ;
  \item le taux de croissance du PIB régional, en volume ;
  \item le taux d'activité, comme variable de contrôle.
\end{itemize}

Les données proviennent du Haut-Commissariat au Plan.

Insérée entre les deux sections existantes, elle devient la section 2, et « Le modèle » passe de 2 à 3 — sans aucune intervention. La table des matières suit, l’équation devient (1) quel que soit son emplacement, et le renvoi reste juste.

C’est exactement ce que promettait l’introduction du cours, et ce qui justifie l’effort initial.

Notez 2010--2023 avec deux tirets : LaTeX compose un tiret demi-cadratin, celui des intervalles. Un seul tiret donnerait un trait d’union, trop court.

Ce qu’il faut retenir

Écriture	Effet
`\documentclass{article}`	première ligne, obligatoire
préambule / `\begin{document}`	réglages / contenu — rien n’existe hors du corps
`babel`, `inputenc`, `fontenc`	langue et accents
`amsmath`, `amssymb`	mathématiques
`geometry`, `graphicx`, `booktabs`	marges, images, tableaux
`hyperref`	liens — toujours en dernier
`article`, `report`, `book`, `beamer`	les quatre classes
`\section`, `\subsection`, `\chapter`	structure — numérotation automatique
`\section*{...}`	sans numéro ni entrée dans la table
ligne vide	nouveau paragraphe — jamais `\\`
`~`	espace insécable
compiler deux fois	pour résoudre les renvois — ou `latexmk`
`.log`	le journal, à lire en cas d’erreur
corriger la première erreur	les suivantes disparaissent souvent

Le chapitre suivant ajoute au document ce qu’un travail empirique exige : les tableaux et les figures.