Votre premier document

Commencez par le plus petit document compilé, puis ajoutez un titre et des en-têtes jusqu'à obtenir un petit rapport. En chemin, vous découvrirez les règles de base de LaTeX.

Le plus petit document

Chaque document LaTeX comporte trois parties. \documentclass{...} en haut choisit le type de document ; tout ce qui précède \begin{document} est le préambule (où vont les paramètres) ; et tout entre \begin{document} et \end{document} est le corps. Ces quelques lignes sont un exemple complet et fonctionnel.

\documentclass{article}
\begin{document}
This is my first document.
\end{document}

La classe est un modèle qui décide de l'apparence générale du document : marges, formes de titre, fonctionnement des chapitres, etc. article est la classe standard pour les articles, les rapports courts et les notes techniques, et c'est le point de départ sûr en cas de doute. Il existe également report, book et — pour le japonais — jlreq (voir « TeX/LaTeX et japonais » pour écrire en japonais).

Les règles de base

Chaque commande commence par une barre oblique inverse \. Les arguments obligatoires sont placés entre accolades { }, les facultatifs entre crochets [ ] (par exemple \documentclass[12pt]{article}). Tout ce qui va de % à la fin de la ligne est un commentaire et n'est pas imprimé.

Dans le corps, les sauts de ligne dans la source sont ignorés et une ligne vide commence un nouveau paragraphe — LaTeX décide des sauts de ligne finaux. Notez que & % $ # _ { } a des significations particulières ; pour les imprimer littéralement, échappez-les sous la forme \&, \%, etc.

Compilez-le en un PDF

Exécutez le fichier via un moteur TeX pour obtenir un PDF. Dans un éditeur ou sur Overleaf il vous suffit d'appuyer sur « compiler » ; sur la ligne de commande :

pdflatex document.tex     # → document.pdf
# or, simpler — runs the right number of passes automatically:
latexmk -pdf document.tex

Les documents comportant une table des matières ou des références croisées nécessitent deux passes (latexmk calcule le nombre pour vous). Pour le pipeline complet, voir « De la source à PDF ».

Correction des premières erreurs

Dans le premier document, apprendre comment lire les erreurs compte plus que les éviter. Lorsque la compilation s'arrête, recherchez dans le journal .log ou l'éditeur la première ligne commençant par !. TeX peut produire de nombreuses erreurs de suivi à partir d'une seule erreur, alors corrigez celle du haut et réexécutez.

• Chaque \begin{...} a besoin de son \end{...} correspondant ; s'il en manque un, la construction peut s'arrêter vers la fin.
• Pour imprimer %, $, _ ou & littéralement, écrivez \%, \$, \_ et \&.
• Un \section mal orthographié donne Undefined control sequence ; vérifiez le nom de la commande et tout package requis.

Ajoutez un titre et des titres – faites-en un rapport

Mettez \title, \author et \date dans le préambule, puis appelez \maketitle en haut du corps pour imprimer le titre. Les titres créés avec \section et \subsection sont numérotés automatiquement et \tableofcontents crée la liste de contenu pour vous.

\documentclass{article}
\title{My First Report}
\author{Taro Yamada}
\date{\today}
\begin{document}
\maketitle
\tableofcontents

\section{Introduction}
This is the introduction.

\section{Method}
\subsection{Setup}
Details go here.
\end{document}

Pour laisser un titre sans numéro, ajoutez un astérisque : \section*{...}. \today est remplacé par la date à laquelle vous compilez.

Ajouter des fonctionnalités avec des packages

Les fonctionnalités manquantes proviennent des packages — ajoutez simplement \usepackage{...} au préambule. Pour les images, graphicx ; pour les mathématiques sérieuses, amsmath ; pour les marges, geometry. Une vaste collection vit sur CTAN.

\documentclass{article}
\usepackage{graphicx}   % images
\usepackage{amsmath}    % better math
\begin{document}
% your content
\end{document}