> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Apprendre LaTeX en 30 minutes
> NOUVEAU : Rendez-vous sur le nouveau [Overleaf Learning Center](https://learn.overleaf.com/) pour découvrir des cours en ligne gratuits et des webinaires en direct : tout ce qu'il vous faut pour maîtriser LaTeX et tirer le meilleur parti d'Overleaf.
Ce tutoriel d'introduction ne suppose aucune expérience préalable de LaTeX ; nous espérons qu'à la fin, vous aurez non seulement écrit votre premier document LaTeX, mais aussi acquis suffisamment de connaissances et d'assurance pour franchir les étapes suivantes vers la maîtrise de LaTeX.
## Qu'est-ce que LaTeX ?
LaTeX (prononcé « *LA*-tek ») est un outil de composition typographique permettant de produire des documents d'aspect professionnel. Cependant, le mode de fonctionnement de LaTeX est très différent de celui de nombreuses autres applications de production de documents que vous avez peut-être utilisées, comme Microsoft Word ou LibreOffice Writer : ces outils « [WYSIWYG](https://fr.wikipedia.org/wiki/What_you_see_is_what_you_get) » offrent aux utilisateurs une page interactive dans laquelle ils saisissent et modifient leur texte et appliquent différentes formes de mise en forme. LaTeX fonctionne très différemment : votre document est un fichier texte brut parsemé de *commandes* LaTeX qui expriment le résultat (composé) souhaité. Pour produire un document visible et composé, votre fichier LaTeX est traité par un logiciel appelé *moteur TeX*, qui utilise les commandes intégrées à votre fichier texte pour guider et contrôler le processus de composition, en convertissant les commandes LaTeX et le texte du document en un fichier PDF composé de façon professionnelle. Vous n'avez donc qu'à vous concentrer sur le *contenu* de votre document : l'ordinateur, par l'intermédiaire des commandes LaTeX et du moteur TeX, se charge de l'*apparence visuelle* (la mise en forme).
## Pourquoi apprendre LaTeX ?
On peut avancer divers arguments pour ou contre l'apprentissage de LaTeX plutôt que d'autres applications de rédaction de documents ; mais, au bout du compte, il s'agit d'un choix personnel fondé sur les préférences, les affinités et les besoins documentaires.
Parmi les arguments en faveur de LaTeX :
* la prise en charge de la composition de formules mathématiques extrêmement complexes, de tableaux et de contenus techniques pour les sciences physiques ;
* des fonctionnalités pour les notes de bas de page, les renvois et la gestion des bibliographies ;
* la facilité de production d'éléments de document complexes ou fastidieux comme les index, les glossaires, les tables des matières ou les listes de figures ;
* une grande capacité de personnalisation pour la production de documents sur mesure, grâce à sa programmabilité intrinsèque et à son extensibilité au moyen de milliers de [paquets complémentaires gratuits](https://www.ctan.org/pkg).
Dans l'ensemble, LaTeX offre aux utilisateurs un très grand contrôle sur la production de documents composés selon des normes extrêmement élevées. Bien sûr, il existe des types de documents ou de publications pour lesquels LaTeX n'est pas idéal, notamment de nombreuses mises en page « libres » que l'on trouve typiquement dans les magazines.
Un avantage important de LaTeX est la séparation entre le contenu et le style du document : une fois le contenu de votre document rédigé, son apparence peut être modifiée facilement. De même, vous pouvez créer un fichier LaTeX qui définit la mise en page et le style d'un type de document particulier, et ce fichier peut servir de *modèle* pour standardiser la rédaction et la production d'autres documents de ce type ; par exemple, cela permet aux éditeurs scientifiques de créer en LaTeX des modèles d'articles que les auteurs utilisent pour rédiger les articles qu'ils soumettent aux revues. Overleaf propose une [galerie de milliers de modèles](https://www.overleaf.com/gallery) couvrant une très grande variété de types de documents : articles scientifiques, rapports, livres, mais aussi CV et présentations. Comme ces modèles définissent la mise en page et le style du document, les auteurs n'ont qu'à les ouvrir dans Overleaf (ce qui crée un nouveau projet) et à commencer à rédiger leur contenu.
## Écrire votre premier code LaTeX
La première étape consiste à créer un nouveau projet LaTeX. Vous pouvez le faire sur votre propre ordinateur en créant un nouveau fichier `.tex` ; vous pouvez aussi démarrer un nouveau projet dans Overleaf.
Commençons par l'exemple fonctionnel le plus simple, qui peut être ouvert directement dans Overleaf :
```latex theme={null}
\documentclass{article}
\begin{document}
First document. This is a simple example, with no
extra parameters or packages included.
\end{document}
```
[Ouvrir cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=Simplest+working+example+LaTeX+document\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0AFirst+document.+This+is+a+simple+example%2C+with+no+%0Aextra+parameters+or+packages+included.%0A%5Cend%7Bdocument%7D)
Cet exemple produit le résultat suivant :
Vous pouvez constater que LaTeX a automatiquement mis en retrait la première ligne du paragraphe, en prenant en charge cette mise en forme pour vous. Examinons de plus près le rôle de chaque partie de notre code.
La première ligne de code, `\documentclass{article}`, déclare le type du document, appelé sa *classe*, qui contrôle l'apparence générale du document. Des types de documents différents nécessitent des classes différentes ; par exemple, un CV nécessitera une autre classe qu'un article scientifique, qui pourrait utiliser la classe LaTeX standard `article`. D'autres types de documents sur lesquels vous travaillez peuvent nécessiter des classes différentes, comme `book` ou `report`. Pour vous faire une idée des nombreuses classes LaTeX disponibles, [consultez la page correspondante sur le CTAN (Comprehensive TeX Archive Network)](https://www.ctan.org/topic/class).
Une fois la classe du document définie, notre contenu, appelé le *corps* du document, est écrit entre les balises `\begin{document}` et `\end{document}`. Après avoir ouvert l'exemple ci-dessus, vous pouvez modifier le texte puis, une fois terminé, afficher le PDF composé obtenu en *recompilant le document*. Pour ce faire dans Overleaf, cliquez simplement sur **Recompile**, comme le montre ce court extrait vidéo :
Tout projet Overleaf peut être configuré pour se recompiler automatiquement à chaque modification : cliquez sur la petite flèche à côté du bouton **Recompile** et réglez **Auto Compile** sur **On**, comme le montre la capture d'écran suivante :
Maintenant que nous avons vu comment ajouter du contenu à notre document, l'étape suivante consiste à lui donner un titre. Pour cela, nous devons parler brièvement du **préambule**.
## Le préambule d'un document
La capture d'écran ci-dessus montre Overleaf stockant un document LaTeX dans un fichier nommé `main.tex` : par convention, l'extension `.tex` est utilisée pour nommer les fichiers contenant le code LaTeX de votre document.
L'exemple précédent montrait que le contenu du document était saisi après la commande `\begin{document}` ; or, tout ce qui figure dans votre fichier `.tex` *avant* ce point s'appelle le *préambule*, qui sert de section de « configuration » du document. Dans le préambule, vous définissez la classe (le type) du document ainsi que des précisions comme les langues utilisées pour la rédaction ; vous y chargez les *paquets* que vous souhaitez utiliser (nous y reviendrons [plus loin](/fr/texlive/latex-basics/learn-latex-in-30-minutes#Finding%5Fand%5Fusing%5FLaTeX%5Fpackages)), et c'est là que vous appliquez d'autres types de configuration.
Un préambule de document minimal pourrait ressembler à ceci :
```latex theme={null}
\documentclass[12pt, letterpaper]{article}
\usepackage{graphicx}
```
où `\documentclass[12pt, letterpaper]{article}` définit la classe (le type) général du document. Des paramètres supplémentaires, qui doivent être séparés par des virgules, sont placés entre crochets (`[...]`) et servent à configurer cette instance de la classe article, c'est-à-dire les réglages que nous souhaitons utiliser pour ce document précis basé sur la classe `article`.
Dans cet exemple, les deux paramètres ont l'effet suivant :
* `12pt` définit la taille de la police
* `letterpaper` définit le format du papier
D'autres tailles de police, `9pt`, `11pt`, `12pt`, peuvent bien sûr être utilisées, mais si aucune n'est indiquée, la taille par défaut est `10pt`. Pour le format du papier, les autres valeurs possibles sont `a4paper` et `legalpaper`. Pour plus d'informations, consultez l'article sur le format de page et les marges.
La ligne de préambule
```latex theme={null}
\usepackage{graphicx}
```
est un exemple de chargement d'un paquet externe (ici, [graphicx](https://ctan.org/pkg/graphicx?lang=en)) pour étendre les capacités de LaTeX, en lui permettant d'importer des fichiers graphiques externes. Les paquets LaTeX sont abordés dans la section [Trouver et utiliser des paquets LaTeX](/fr/texlive/latex-basics/learn-latex-in-30-minutes#Finding%5Fand%5Fusing%5FLaTeX%5Fpackages).
## Ajouter le titre, l'auteur et la date
Pour ajouter un titre, un auteur et une date à notre document, il faut trois lignes supplémentaires dans le *préambule* (*et non* dans le corps du document). Ces lignes sont :
* `\title{My first LaTeX document}` : le titre du document
* `\author{Hubert Farnsworth}` : vous y écrivez le nom du ou des auteurs et, éventuellement, la commande `\thanks` entre les accolades :
* `\thanks{Funded by the Overleaf team.}` : peut être ajoutée après le nom de l'auteur, à l'intérieur des accolades de la commande `author`. Elle ajoute un exposant et une note de bas de page contenant le texte entre accolades. Utile si vous devez remercier une institution dans votre article.
* `\date{August 2022}` : vous pouvez saisir la date manuellement ou utiliser la commande `\today` pour composer la date du jour à chaque compilation du document
Une fois ces lignes ajoutées, votre préambule devrait ressembler à ceci :
```latex theme={null}
\documentclass[12pt, letterpaper]{article}
\title{My first LaTeX document}
\author{Hubert Farnsworth\thanks{Funded by the Overleaf team.}}
\date{August 2022}
```
Pour composer le titre, l'auteur et la date, utilisez la commande `\maketitle` dans le *corps* du document :
```latex theme={null}
\begin{document}
\maketitle
We have now added a title, author and date to our first \LaTeX{} document!
\end{document}
```
Le préambule et le corps peuvent maintenant être réunis pour produire un document complet, qui peut être ouvert dans Overleaf :
```latex theme={null}
\documentclass[12pt, letterpaper]{article}
\title{My first LaTeX document}
\author{Hubert Farnsworth\thanks{Funded by the Overleaf team.}}
\date{August 2022}
\begin{document}
\maketitle
We have now added a title, author and date to our first \LaTeX{} document!
\end{document}
```
[Ouvrir cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=My+first+LaTeX+document\&snip=%5Cdocumentclass%5B12pt%2C+letterpaper%5D%7Barticle%7D%0A%5Ctitle%7BMy+first+LaTeX+document%7D%0A%5Cauthor%7BHubert+Farnsworth%5Cthanks%7BFunded+by+the+Overleaf+team.%7D%7D%0A%5Cdate%7BAugust+2022%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cmaketitle%0AWe+have+now+added+a+title%2C+author+and+date+to+our+first+%5CLaTeX%7B%7D+document%21%0A%5Cend%7Bdocument%7D)
Cet exemple produit le résultat suivant :
## Ajouter des commentaires
LaTeX est une forme de « code de programme », mais spécialisée dans la composition de documents ; par conséquent, comme pour le code écrit dans n'importe quel autre langage de programmation, il peut être très utile d'inclure des commentaires dans votre document. Un commentaire LaTeX est une portion de texte qui ne sera pas composée et n'affectera en rien le document ; on l'utilise souvent pour ajouter des notes « à faire », des notes explicatives, des explications en ligne de macros délicates, ou pour commenter des lignes ou des sections de code LaTeX lors du débogage.
Pour écrire un commentaire en LaTeX, il suffit de placer un symbole `%` au début de la ligne, comme le montre le code suivant, qui reprend l'exemple ci-dessus :
```latex theme={null}
\documentclass[12pt, letterpaper]{article}
\title{My first LaTeX document}
\author{Hubert Farnsworth\thanks{Funded by the Overleaf team.}}
\date{August 2022}
\begin{document}
\maketitle
We have now added a title, author and date to our first \LaTeX{} document!
% This line here is a comment. It will not be typeset in the document.
\end{document}
```
[Ouvrir cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=My+first+LaTeX+document+with+a+comment\&snip=%5Cdocumentclass%5B12pt%2C+letterpaper%5D%7Barticle%7D%0A%5Ctitle%7BMy+first+LaTeX+document%7D%0A%5Cauthor%7BHubert+Farnsworth%5Cthanks%7BFunded+by+the+Overleaf+team.%7D%7D%0A%5Cdate%7BAugust+2022%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cmaketitle%0AWe+have+now+added+a+title%2C+author+and+date+to+our+first+%5CLaTeX%7B%7D+document%21%0A%0A%25+This+line+here+is+a+comment.+It+will+not+be+typeset+in+the+document.%0A%5Cend%7Bdocument%7D)
Cet exemple produit un résultat identique à celui du code LaTeX précédent, qui ne contenait pas de commentaire.
## Gras, italique et soulignement
Examinons maintenant quelques commandes de mise en forme du texte :
* **Gras** : en LaTeX, le texte en gras est composé avec la commande `\textbf{...}`.
* *Italique* : le texte en italique est produit avec la commande `\textit{...}`.
* Soulignement : pour souligner du texte, utilisez la commande `\underline{...}`.
L'exemple suivant illustre ces commandes :
```latex theme={null}
Some of the \textbf{greatest}
discoveries in \underline{science}
were made by \textbf{\textit{accident}}.
```
[Ouvrir cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=First+example+with+formatted+text\&snip=%5Cdocumentclass%5B12pt%2C+letterpaper%5D%7Barticle%7D%0A%5Ctitle%7BMy+first+LaTeX+document%7D%0A%5Cauthor%7BHubert+Farnsworth%5Cthanks%7BFunded+by+the+Overleaf+team.%7D%7D%0A%5Cdate%7BAugust+2022%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cmaketitle%0ASome+of+the+%5Ctextbf%7Bgreatest%7D%0Adiscoveries+in+%5Cunderline%7Bscience%7D+%0Awere+made+by+%5Ctextbf%7B%5Ctextit%7Baccident%7D%7D.%0A%5Cend%7Bdocument%7D)
Cet exemple produit le résultat suivant :
Une autre commande très utile est `\emph{_argument_}`, dont l'effet sur son `_argument_` dépend du contexte. Dans un texte normal, le texte mis en valeur est en italique, mais ce comportement est inversé à l'intérieur d'un texte en italique ; voir l'exemple suivant :
```latex theme={null}
Some of the greatest \emph{discoveries} in science
were made by accident.
\textit{Some of the greatest \emph{discoveries}
in science were made by accident.}
\textbf{Some of the greatest \emph{discoveries}
in science were made by accident.}
```
[Ouvrir cet exemple \emph dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=Using+the+emph+command\&snip=%5Cdocumentclass%5B12pt%2C+letterpaper%5D%7Barticle%7D%0A%5Ctitle%7BMy+first+LaTeX+document%7D%0A%5Cauthor%7BHubert+Farnsworth%5Cthanks%7BFunded+by+the+Overleaf+team.%7D%7D%0A%5Cdate%7BAugust+2022%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cparindent0pt%25+To+remove+the+paragraph+indentation%0A%5Cmaketitle%0ASome+of+the+greatest+%5Cemph%7Bdiscoveries%7D+in+science+%0Awere+made+by+accident.%0A%0A%5Ctextit%7BSome+of+the+greatest+%5Cemph%7Bdiscoveries%7D+%0Ain+science+were+made+by+accident.%7D%0A%0A%5Ctextbf%7BSome+of+the+greatest+%5Cemph%7Bdiscoveries%7D+%0Ain+science+were+made+by+accident.%7D%0A%5Cend%7Bdocument%7D)
Cet exemple produit le résultat suivant :
* Remarque : certains paquets, comme Beamer, modifient le comportement de la commande `\emph`.
## Ajouter des images
Dans cette section, nous allons voir comment ajouter des images à un document LaTeX. Overleaf propose trois façons d'insérer des images :
1. Utiliser le [bouton **Insert Figure**](https://learn.overleaf.com/learn/Kb/How_to_insert_figures_in_Overleaf#Using%5FInsert%5FFigure%5Fto%5Fadd%5Fa%5Ffigure%5Fto%5Fyour%5Fproject)(), situé dans la barre d'outils de l'éditeur, pour insérer une image dans le **Visual Editor** ou le **Code Editor**.
2. Copier-coller une image dans le **Visual Editor** ou le **Code Editor**.
3. Utiliser le **Code Editor** pour écrire le code LaTeX qui insère un graphique.
Les options 1 et 2 génèrent automatiquement le code LaTeX nécessaire à l'insertion des images, mais nous présentons ici l'option 3 ; notez que vous devrez [téléverser ces images](https://docs.overleaf.com/writing-and-editing/inserting-images) dans votre projet Overleaf. L'exemple suivant montre comment inclure une image :
```latex theme={null}
\documentclass{article}
\usepackage{graphicx} %LaTeX package to import graphics
\graphicspath{{images/}} %configuring the graphicx package
\begin{document}
The universe is immense and it seems to be homogeneous,
on a large scale, everywhere we look.
% The \includegraphics command is
% provided (implemented) by the
% graphicx package
\includegraphics{universe}
There's a picture of a galaxy above.
\end{document}
```
[Ouvrir cet exemple d'image dans Overleaf.](https://www.overleaf.com/project/new/template/25686?id=107971142\&templateName=Example+using+images+in+LaTeX\&latexEngine=pdflatex\&texImage=texlive-full%3A2022.1\&mainFile=)
Cet exemple produit le résultat suivant :
L'importation de graphiques dans un document LaTeX nécessite [un *paquet* complémentaire](/fr/texlive/latex-basics/learn-latex-in-30-minutes#Finding%5Fand%5Fusing%5FLaTeX%5Fpackages) qui fournit les commandes et fonctionnalités nécessaires pour inclure des fichiers graphiques externes. L'exemple ci-dessus charge le [paquet graphicx](https://ctan.org/pkg/graphicx?lang=en) qui, parmi de nombreuses autres commandes, fournit `\includegraphics{...}` pour importer des graphiques et `\graphicspath{...}` pour indiquer à LaTeX où se trouvent les graphiques.
Pour utiliser le paquet `graphicx`, ajoutez la ligne suivante au préambule de votre document Overleaf :
```latex theme={null}
\usepackage{graphicx}
```
Dans notre exemple, la commande `\graphicspath{{images/}}` indique à LaTeX que les images sont conservées dans un dossier nommé `images`, situé dans le répertoire courant :
C'est la commande `\includegraphics{universe}` qui insère effectivement l'image dans le document. Ici, `universe` est le nom du fichier image, sans son extension.
**Remarque** :
* Bien que le nom de fichier complet, extension comprise, soit accepté dans la commande `\includegraphics`, il est considéré comme une bonne pratique d'omettre l'extension, car LaTeX recherchera alors tous les formats pris en charge.
* En règle générale, le nom du fichier graphique ne doit pas contenir d'espaces ni plusieurs points ; il est également recommandé d'utiliser des minuscules pour l'extension lorsque vous téléversez des fichiers image dans Overleaf.
Vous trouverez plus d'informations sur les paquets LaTeX à la fin de ce tutoriel, dans la section [Trouver et utiliser des paquets LaTeX](/fr/texlive/latex-basics/learn-latex-in-30-minutes#Finding%5Fand%5Fusing%5FLaTeX%5Fpackages).
## Légendes, étiquettes et références
Les images peuvent recevoir une légende, une étiquette et être référencées au moyen de l'environnement `figure`, comme ci-dessous :
```latex theme={null}
\documentclass{article}
\usepackage{graphicx}
\graphicspath{{images/}}
\begin{document}
\begin{figure}[h]
\centering
\includegraphics[width=0.75\textwidth]{mesh}
\caption{A nice plot.}
\label{fig:mesh1}
\end{figure}
As you can see in figure \ref{fig:mesh1}, the function grows near the origin. This example is on page \pageref{fig:mesh1}.
\end{document}
```
[Ouvrir cet exemple d'image dans Overleaf.](https://www.overleaf.com/project/new/template/25519?id=107980830\&templateName=Example+using+image+captions+in+LaTeX\&latexEngine=pdflatex\&texImage=texlive-full%3A2022.1\&mainFile=)
Cet exemple produit le résultat suivant :
Plusieurs commandes de cet exemple méritent d'être signalées :
* **`\includegraphics[width=0.75\textwidth]{mesh}`** : cette forme de `\includegraphics` demande à LaTeX de fixer la largeur de la figure à 75 % de la largeur du texte, dont la valeur est stockée dans la commande `\textwidth`.
* **`\caption{A nice plot.}`** : comme son nom l'indique, cette commande définit la légende de la figure, qui peut être placée au-dessus ou en dessous de celle-ci. Si vous créez une liste des figures, cette légende y sera utilisée.
* **`\label{fig:mesh1}`** : pour faire référence à cette image dans votre document, vous lui attribuez une étiquette à l'aide de la commande `\label`. L'étiquette sert à générer un numéro pour l'image et, combinée à la commande suivante, vous permet d'y faire référence.
* **`\ref{fig:mesh1}`** : ce code sera remplacé par le numéro correspondant à la figure référencée.
Les images intégrées à un document LaTeX doivent être placées dans un environnement `figure` (ou similaire), afin que LaTeX puisse positionner automatiquement l'image à un emplacement approprié de votre document.
Vous trouverez plus de conseils dans les articles d'aide Overleaf suivants :
* Positionnement des figures
* [Insérer des images](https://docs.overleaf.com/writing-and-editing/inserting-images)
## Créer des listes en LaTeX
Vous pouvez créer différents types de listes à l'aide d'*environnements*, qui servent à encapsuler le code LaTeX nécessaire à une fonctionnalité de composition donnée. Un environnement commence par `\begin{_environment-name_}` et se termine par `\end{_environment-name_}`, où `_environment-name_` peut être `figure`, `tabular` ou l'un des types de listes : `itemize` pour les listes non ordonnées ou `enumerate` pour les listes ordonnées.
### Listes non ordonnées
Les listes non ordonnées sont produites par l'environnement `itemize`. Chaque entrée de la liste doit être précédée de la commande `\item`, comme ci-dessous :
```latex theme={null}
\documentclass{article}
\begin{document}
\begin{itemize}
\item The individual entries are indicated with a black dot, a so-called bullet.
\item The text in the entries may be of any length.
\end{itemize}
\end{document}
```
[Ouvrir cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=Example+of+a+LaTeX+unordered+list\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bitemize%7D%0A++%5Citem+The+individual+entries+are+indicated+with+a+black+dot%2C+a+so-called+bullet.%0A++%5Citem+The+text+in+the+entries+may+be+of+any+length.%0A%5Cend%7Bitemize%7D%0A%5Cend%7Bdocument%7D)
Cet exemple produit le résultat suivant :
Vous pouvez également ouvrir ce [projet Overleaf plus complet](https://www.overleaf.com/project/new/template/25521?id=107987258\&templateName=Demonstrating+various+types+of+LaTeX+list\&latexEngine=pdflatex\&texImage=texlive-full%3A2022.1\&mainFile=), qui présente différents types de listes LaTeX.
### Listes ordonnées
Les listes ordonnées utilisent la même syntaxe que les listes non ordonnées, mais sont créées avec l'environnement `enumerate` :
```latex theme={null}
\documentclass{article}
\begin{document}
\begin{enumerate}
\item This is the first entry in our list.
\item The list numbers increase with each entry we add.
\end{enumerate}
\end{document}
```
[Ouvrir cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=Example+of+the+enumerate+environment\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Benumerate%7D%0A++%5Citem+This+is+the+first+entry+in+our+list.%0A++%5Citem+The+list+numbers+increase+with+each+entry+we+add.%0A%5Cend%7Benumerate%7D%0A%5Cend%7Bdocument%7D)
Cet exemple produit le résultat suivant :
Comme pour les listes non ordonnées, chaque entrée doit être précédée de la commande `\item` qui, ici, génère automatiquement le numéro de l'entrée de la liste ordonnée, en commençant à 1.
Pour en savoir plus, vous pouvez ouvrir ce [projet Overleaf plus complet](https://www.overleaf.com/project/new/template/25521?id=107987258\&templateName=Demonstrating+various+types+of+LaTeX+list\&latexEngine=pdflatex\&texImage=texlive-full%3A2022.1\&mainFile=), qui présente différents types de listes LaTeX, ou consulter notre article d'aide dédié aux listes LaTeX, qui propose de nombreux autres exemples et montre comment créer des listes personnalisées.
## Ajouter des mathématiques dans LaTeX
L'un des principaux avantages de LaTeX est la facilité avec laquelle on peut écrire des expressions mathématiques. LaTeX propose deux modes d'écriture pour composer des mathématiques :
* le mode mathématique *en ligne* (inline), utilisé pour écrire des formules qui font partie d'un paragraphe
* le mode mathématique *hors texte* (display), utilisé pour écrire des expressions qui ne font pas partie d'un texte ou d'un paragraphe et qui sont composées sur des lignes séparées
### Mode mathématique en ligne
Voyons un exemple de mode mathématique en ligne :
```latex theme={null}
\documentclass[12pt, letterpaper]{article}
\begin{document}
In physics, the mass-energy equivalence is stated
by the equation $E=mc^2$, discovered in 1905 by Albert Einstein.
\end{document}
```
[Ouvrir cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=Inline+LaTeX+maths+example\&snip=%5Cdocumentclass%5B12pt%2C+letterpaper%5D%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0AIn+physics%2C+the+mass-energy+equivalence+is+stated+%0Aby+the+equation+%24E%3Dmc%5E2%24%2C+discovered+in+1905+by+Albert+Einstein.%0A%5Cend%7Bdocument%7D)
Cet exemple produit le résultat suivant :
Pour composer des mathématiques en mode en ligne, vous pouvez utiliser l'une de ces paires de délimiteurs : `\( ... \)`, `$ ... $` ou `\begin{math} ... \end{math}`, comme le montre l'exemple suivant :
```latex theme={null}
\documentclass[12pt, letterpaper]{article}
\begin{document}
\begin{math}
E=mc^2
\end{math} is typeset in a paragraph using inline math mode---as is $E=mc^2$, and so too is \(E=mc^2\).
\end{document}
```
[Ouvrir cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=Demonstrating+inline+math+mode\&snip=%5Cdocumentclass%5B12pt%2C+letterpaper%5D%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bmath%7D%0AE%3Dmc%5E2%0A%5Cend%7Bmath%7D+is+typeset+in+a+paragraph+using+inline+math+mode---as+is+%24E%3Dmc%5E2%24%2C+and+so+too+is+%5C%28E%3Dmc%5E2%5C%29.%0A%5Cend%7Bdocument%7D)
Cet exemple produit le résultat suivant :
### Mode mathématique hors texte
Les équations composées en mode hors texte peuvent être numérotées ou non, comme dans l'exemple suivant :
```latex theme={null}
\documentclass[12pt, letterpaper]{article}
\begin{document}
The mass-energy equivalence is described by the famous equation
\[ E=mc^2 \] discovered in 1905 by Albert Einstein.
In natural units ($c = 1$), the formula expresses the identity
\begin{equation}
E=m
\end{equation}
\end{document}
```
[Ouvrir cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=Display+math+mode+example\&snip=%5Cdocumentclass%5B12pt%2C+letterpaper%5D%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0AThe+mass-energy+equivalence+is+described+by+the+famous+equation%0A%5C%5B+E%3Dmc%5E2+%5C%5D+discovered+in+1905+by+Albert+Einstein.+%0A%0AIn+natural+units+%28%24c+%3D+1%24%29%2C+the+formula+expresses+the+identity%0A%5Cbegin%7Bequation%7D%0AE%3Dm%0A%5Cend%7Bequation%7D%0A%5Cend%7Bdocument%7D)
Cet exemple produit le résultat suivant :
Pour composer des mathématiques en mode hors texte, vous pouvez utiliser l'une de ces paires de délimiteurs : `\[ ... \]`, `\begin{displaymath} ... \end{displaymath}` ou `\begin{equation} ... \end{equation}`. Historiquement, la composition en mode hors texte nécessitait les délimiteurs `$$`, comme dans `$$ _... display math here ..._$$`, mais cette méthode [n'est plus recommandée](https://texfaq.org/FAQ-dolldoll) : utilisez plutôt les délimiteurs LaTeX `\[ ... \]`.
### Exemples plus complets
Les exemples suivants présentent divers contenus mathématiques composés avec LaTeX.
```latex theme={null}
\documentclass{article}
\begin{document}
Subscripts in math mode are written as $a_b$ and superscripts are written as $a^b$. These can be combined and nested to write expressions such as
\[ T^{i_1 i_2 \dots i_p}_{j_1 j_2 \dots j_q} = T(x^{i_1},\dots,x^{i_p},e_{j_1},\dots,e_{j_q}) \]
We write integrals using $\int$ and fractions using $\frac{a}{b}$. Limits are placed on integrals using superscripts and subscripts:
\[ \int_0^1 \frac{dx}{e^x} = \frac{e-1}{e} \]
Lower case Greek letters are written as $\omega$ $\delta$ etc. while upper case Greek letters are written as $\Omega$ $\Delta$.
Mathematical operators are prefixed with a backslash as $\sin(\beta)$, $\cos(\alpha)$, $\log(x)$ etc.
\end{document}
```
[Ouvrir cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=More+advanced+LaTeX+math+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0ASubscripts+in+math+mode+are+written+as+%24a%5Fb%24+and+superscripts+are+written+as+%24a%5Eb%24.+These+can+be+combined+and+nested+to+write+expressions+such+as%0A%0A%5C%5B+T%5E%7Bi%5F1+i%5F2+%5Cdots+i%5Fp%7D%5F%7Bj%5F1+j%5F2+%5Cdots+j%5Fq%7D+%3D+T%28x%5E%7Bi%5F1%7D%2C%5Cdots%2Cx%5E%7Bi%5Fp%7D%2Ce%5F%7Bj%5F1%7D%2C%5Cdots%2Ce%5F%7Bj%5Fq%7D%29+%5C%5D%0A+%0AWe+write+integrals+using+%24%5Cint%24+and+fractions+using+%24%5Cfrac%7Ba%7D%7Bb%7D%24.+Limits+are+placed+on+integrals+using+superscripts+and+subscripts%3A%0A%0A%5C%5B+%5Cint%5F0%5E1+%5Cfrac%7Bdx%7D%7Be%5Ex%7D+%3D++%5Cfrac%7Be-1%7D%7Be%7D+%5C%5D%0A%0ALower+case+Greek+letters+are+written+as+%24%5Comega%24+%24%5Cdelta%24+etc.+while+upper+case+Greek+letters+are+written+as+%24%5COmega%24+%24%5CDelta%24.%0A%0AMathematical+operators+are+prefixed+with+a+backslash+as+%24%5Csin%28%5Cbeta%29%24%2C+%24%5Ccos%28%5Calpha%29%24%2C+%24%5Clog%28x%29%24+etc.%0A%5Cend%7Bdocument%7D)
Cet exemple produit le résultat suivant :
L'exemple suivant utilise l'environnement `equation*`, fourni par le paquet `amsmath` ; nous devons donc ajouter la ligne suivante au préambule de notre document :
```latex theme={null}
\usepackage{amsmath}% For the equation* environment
```
Pour plus d'informations sur l'utilisation d'`amsmath`, consultez notre article d'aide.
```latex theme={null}
\documentclass{article}
\usepackage{amsmath}% For the equation* environment
\begin{document}
\section{First example}
The well-known Pythagorean theorem \(x^2 + y^2 = z^2\) was proved to be invalid for other exponents, meaning the next equation has no integer solutions for \(n>2\):
\[ x^n + y^n = z^n \]
\section{Second example}
This is a simple math expression \(\sqrt{x^2+1}\) inside text.
And this is also the same:
\begin{math}
\sqrt{x^2+1}
\end{math}
but by using another command.
This is a simple math expression without numbering
\[\sqrt{x^2+1}\]
separated from text.
This is also the same:
\begin{displaymath}
\sqrt{x^2+1}
\end{displaymath}
\ldots and this:
\begin{equation*}
\sqrt{x^2+1}
\end{equation*}
\end{document}
```
[Ouvrir cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=More+math+content+typeset+in+LaTeX\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bamsmath%7D%25+For+the+equation%2A+environment%0A%5Cbegin%7Bdocument%7D%0A%5Csection%7BFirst+example%7D%0A%0AThe+well-known+Pythagorean+theorem+%5C%28x%5E2+%2B+y%5E2+%3D+z%5E2%5C%29+was+proved+to+be+invalid+for+other+exponents%2C+meaning+the+next+equation+has+no+integer+solutions+for+%5C%28n%3E2%5C%29%3A%0A%0A%5C%5B+x%5En+%2B+y%5En+%3D+z%5En+%5C%5D%0A%0A%5Csection%7BSecond+example%7D%0A%0AThis+is+a+simple+math+expression+%5C%28%5Csqrt%7Bx%5E2%2B1%7D%5C%29+inside+text.+%0AAnd+this+is+also+the+same%3A+%0A%5Cbegin%7Bmath%7D%0A%5Csqrt%7Bx%5E2%2B1%7D%0A%5Cend%7Bmath%7D%0Abut+by+using+another+command.%0A%0AThis+is+a+simple+math+expression+without+numbering%0A%5C%5B%5Csqrt%7Bx%5E2%2B1%7D%5C%5D+%0Aseparated+from+text.%0A%0AThis+is+also+the+same%3A%0A%5Cbegin%7Bdisplaymath%7D%0A%5Csqrt%7Bx%5E2%2B1%7D%0A%5Cend%7Bdisplaymath%7D%0A%0A%5Cldots+and+this%3A%0A%5Cbegin%7Bequation%2A%7D%0A%5Csqrt%7Bx%5E2%2B1%7D%0A%5Cend%7Bequation%2A%7D%0A%5Cend%7Bdocument%7D)
Cet exemple produit le résultat suivant :
Les possibilités offertes par les mathématiques dans LaTeX sont infinies ; n'hésitez donc pas à consulter nos pages d'aide pour obtenir des conseils et des exemples sur des sujets précis :
* Expressions mathématiques
* Indices et exposants
* Crochets et parenthèses
* Fractions et coefficients binomiaux
* Alignement d'équations
* Opérateurs
* Espacement en mode mathématique
* Intégrales, sommes et limites
* Style hors texte en mode mathématique
* Liste des lettres grecques et des symboles mathématiques
* Polices mathématiques
## Structure de base d'un document
Nous allons maintenant voir les résumés et la façon de découper un document LaTeX en chapitres, sections et paragraphes.
### Résumés
Les articles scientifiques comportent généralement un *résumé* (abstract), c'est-à-dire une brève présentation ou synthèse de leurs principaux sujets ou arguments. L'exemple suivant montre comment composer un résumé à l'aide de l'environnement `abstract` de LaTeX :
```latex theme={null}
\documentclass{article}
\begin{document}
\begin{abstract}
This is a simple paragraph at the beginning of the
document. A brief introduction about the main subject.
\end{abstract}
\end{document}
```
[Ouvrir cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=How+to+create+a+document+abstract\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Babstract%7D%0AThis+is+a+simple+paragraph+at+the+beginning+of+the+%0Adocument.+A+brief+introduction+about+the+main+subject.%0A%5Cend%7Babstract%7D%0A%5Cend%7Bdocument%7D)
Cet exemple produit le résultat suivant :
### Paragraphes et retours à la ligne
Une fois le résumé en place, nous pouvons commencer à écrire notre premier paragraphe. L'exemple suivant montre :
* comment créer un nouveau paragraphe en appuyant deux fois sur la touche « Entrée », ce qui termine la ligne en cours et insère une ligne vide ;
* comment commencer une nouvelle ligne sans commencer un nouveau paragraphe, en insérant un saut de ligne manuel à l'aide de la commande `\\` (une double barre oblique inverse) ; vous pouvez aussi utiliser la commande `\newline`.
Le troisième paragraphe de cet exemple illustre l'utilisation des commandes `\\` et `\newline` :
```latex theme={null}
\documentclass{article}
\begin{document}
\begin{abstract}
This is a simple paragraph at the beginning of the
document. A brief introduction about the main subject.
\end{abstract}
After our abstract we can begin the first paragraph, then press ``enter'' twice to start the second one.
This line will start a second paragraph.
I will start the third paragraph and then add \\ a manual line break which causes this text to start on a new line but remains part of the same paragraph. Alternatively, I can use the \verb|\newline|\newline command to start a new line, which is also part of the same paragraph.
\end{document}
```
[Ouvrir cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=Example+to+create+a+new+paragraph\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%0A%5Cbegin%7Babstract%7D%0AThis+is+a+simple+paragraph+at+the+beginning+of+the+%0Adocument.+A+brief+introduction+about+the+main+subject.%0A%5Cend%7Babstract%7D%0A%0AAfter+our+abstract+we+can+begin+the+first+paragraph%2C+then+press+%60%60enter%27%27+twice+to+start+the+second+one.%0A%0AThis+line+will+start+a+second+paragraph.%0A%0AI+will+start+the+third+paragraph+and+then+add+%5C%5C+a+manual+line+break+which+causes+this+text+to+start+on+a+new+line+but+remains+part+of+the+same+paragraph.+Alternatively%2C+I+can+use+the+%5Cverb%7C%5Cnewline%7C%5Cnewline+command+to+start+a+new+line%2C+which+is+also+part+of+the+same+paragraph.%0A%5Cend%7Bdocument%7D)
Cet exemple produit le résultat suivant :
Remarquez que LaTeX met automatiquement les paragraphes en retrait, sauf immédiatement après les titres du document comme ceux des sections et sous-sections, [comme nous le verrons](/fr/texlive/latex-basics/learn-latex-in-30-minutes#Chapters%5Fand%5Fsections).
Nous conseillons aux nouveaux utilisateurs de ne pas utiliser plusieurs `\\` ou `\newline` pour « simuler » des paragraphes plus espacés, car cela peut perturber les algorithmes de composition de LaTeX. La méthode recommandée consiste à continuer d'utiliser des lignes vides pour créer de nouveaux paragraphes, sans aucun `\\`, et à charger le [paquet parskip](https://ctan.org/pkg/parskip?lang=en) en ajoutant `\usepackage{parskip}` au préambule.
Vous trouverez plus d'informations sur les paragraphes dans les articles suivants :
* Paragraphes et retours à la ligne
* Comment modifier l'espacement des paragraphes dans LaTeX
* LaTeX Error: There's no line here to end, qui donne des conseils supplémentaires sur l'utilisation de `\\`.
### Chapitres et sections
Les documents longs, quel que soit le logiciel de rédaction, sont généralement découpés en parties, chapitres, sections, sous-sections, etc. LaTeX fournit également des commandes de structuration de documents, mais les commandes disponibles et leur implémentation (ce qu'elles font) peuvent dépendre de la classe de document utilisée. Par exemple, les documents créés avec la classe `book` peuvent être divisés en parties, chapitres, sections, sous-sections, etc., mais la classe `letter` ne fournit (ne prend en charge) aucune commande pour cela.
L'exemple suivant présente les commandes utilisées pour structurer un document basé sur la classe `book` :
```latex theme={null}
\documentclass{book}
\begin{document}
\chapter{First Chapter}
\section{Introduction}
This is the first section.
Lorem ipsum dolor sit amet, consectetuer adipiscing
elit. Etiam lobortisfacilisis sem. Nullam nec mi et
neque pharetra sollicitudin. Praesent imperdietmi nec ante.
Donec ullamcorper, felis non sodales...
\section{Second Section}
Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Etiam lobortis facilisissem. Nullam nec mi et neque pharetra
sollicitudin. Praesent imperdiet mi necante...
\subsection{First Subsection}
Praesent imperdietmi nec ante. Donec ullamcorper, felis non sodales...
\section*{Unnumbered Section}
Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Etiam lobortis facilisissem...
\end{document}
```
[Ouvrir cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=Book+class+example+document\&snip=%5Cdocumentclass%7Bbook%7D%0A%5Cbegin%7Bdocument%7D%0A%0A%5Cchapter%7BFirst+Chapter%7D%0A%0A%5Csection%7BIntroduction%7D%0A%0AThis+is+the+first+section.%0A%0ALorem++ipsum++dolor++sit++amet%2C++consectetuer++adipiscing++%0Aelit.+Etiam++lobortisfacilisis+sem.++Nullam+nec+mi+et+%0Aneque+pharetra+sollicitudin.++Praesent+imperdietmi+nec+ante.+%0ADonec+ullamcorper%2C+felis+non+sodales...%0A%0A%5Csection%7BSecond+Section%7D%0A%0ALorem+ipsum+dolor+sit+amet%2C+consectetuer+adipiscing+elit.++%0AEtiam+lobortis+facilisissem.++Nullam+nec+mi+et+neque+pharetra+%0Asollicitudin.++Praesent+imperdiet+mi+necante...%0A%0A%5Csubsection%7BFirst+Subsection%7D%0APraesent+imperdietmi+nec+ante.+Donec+ullamcorper%2C+felis+non+sodales...%0A%0A%5Csection%2A%7BUnnumbered+Section%7D%0ALorem+ipsum+dolor+sit+amet%2C+consectetuer+adipiscing+elit.++%0AEtiam+lobortis+facilisissem...%0A%5Cend%7Bdocument%7D)
Cet exemple produit le résultat suivant :
Les noms des commandes de sectionnement sont pour la plupart explicites ; par exemple, `\chapter{First Chapter}` crée un nouveau chapitre intitulé `First Chapter`, `\section{Introduction}` produit une section intitulée `Introduction`, et ainsi de suite. Les sections peuvent être subdivisées en `\subsection{...}` et même en `\subsubsection{...}`. La numérotation des sections, sous-sections, etc. est automatique, mais peut être désactivée en utilisant la *version étoilée* de la commande concernée, qui se termine par un astérisque (\*), comme `\section*{...}` et `\subsection*{...}`.
*Collectivement*, les classes de documents LaTeX fournissent les commandes de sectionnement suivantes, chaque classe prenant en charge un sous-ensemble pertinent :
* `\part{part}`
* `\chapter{chapter}`
* `\section{section}`
* `\subsection{subsection}`
* `\subsubsection{subsubsection}`
* `\paragraph{paragraph}`
* `\subparagraph{subparagraph}`
En particulier, les commandes `\part` et `\chapter` ne sont disponibles que dans les classes de documents `report` et `book`.
Consultez l'article d'Overleaf consacré aux sections et aux chapitres pour plus d'informations sur les commandes de structuration de documents.
## Créer des tableaux
Overleaf propose trois façons de créer des tableaux :
1. Utiliser le [bouton **Insert Table**](https://www.overleaf.com/learn/how-to/How_to_insert_tables_in_Overleaf%23inserttable#Using%5FInsert%5FTable%5Fto%5Fcreate%5Fa%5Ftable%5Fin%5Fyour%5Fproject) de la barre d'outils du **Visual Editor** (ou du **Code Editor**).
2. [Copier-coller un tableau](https://www.overleaf.com/learn/how-to/How_to_paste_formatted_content_into_Overleaf%23pastingtables) depuis un autre document en utilisant le **Visual Editor**.
3. Écrire le code LaTeX du tableau dans le Code Editor.
Si vous débutez avec LaTeX, la barre d'outils du **Visual Editor** (option 1) est un excellent moyen de commencer : vous pouvez basculer entre le **Visual Editor** et le **Code Editor** pour voir le code qui se cache derrière le tableau.
Nous nous concentrons ici sur l'option 3, la méthode la plus flexible pour créer des tableaux, et proposons des exemples qui montrent comment créer des tableaux en LaTeX, y compris l'ajout de lignes (filets) et de légendes. À mesure que vous gagnez en expérience, consultez notre guide détaillé sur [la création de tableaux avec LaTeX](https://www.overleaf.com/learn/latex/Tables).
### Créer un tableau simple en LaTeX
Commençons par un exemple montrant comment composer un tableau simple :
```latex theme={null}
\begin{center}
\begin{tabular}{c c c}
cell1 & cell2 & cell3 \\
cell4 & cell5 & cell6 \\
cell7 & cell8 & cell9
\end{tabular}
\end{center}
```
[Ouvrir cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=An+example+of+a+basic+table\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bcenter%7D%0A%5Cbegin%7Btabular%7D%7Bc+c+c%7D%0A+cell1+%26+cell2+%26+cell3+%5C%5C+%0A+cell4+%26+cell5+%26+cell6+%5C%5C++%0A+cell7+%26+cell8+%26+cell9++++%0A%5Cend%7Btabular%7D%0A%5Cend%7Bcenter%7D%0A%5Cend%7Bdocument%7D%0A%3C%2Fsource%3E)
Cet exemple produit le résultat suivant :
L'environnement `tabular` est la méthode LaTeX par défaut pour créer des tableaux. Vous devez lui passer un paramètre, ici `{c c c}`, qui indique à LaTeX qu'il y aura trois colonnes et que le texte de chacune doit être centré. Vous pouvez aussi utiliser `r` pour aligner le texte à droite et `l` pour l'aligner à gauche. Le symbole d'alignement `&` sert à délimiter les cellules d'une ligne du tableau. Pour terminer une ligne du tableau, utilisez la commande de *nouvelle ligne* `\\`. Notre tableau est placé dans un environnement `center` afin d'être centré dans la largeur du texte de la page.
### Ajouter des bordures
L'environnement `tabular` prend en charge des lignes (filets) horizontales et verticales dans le tableau :
* pour ajouter des filets horizontaux au-dessus et en dessous des lignes, utilisez la commande `\hline`
* pour ajouter des filets verticaux entre les colonnes, utilisez le paramètre de ligne verticale `|`
Dans cet exemple, l'argument est `{|c|c|c|}`, qui déclare trois colonnes (centrées), chacune séparée par une ligne verticale (filet) ; de plus, nous utilisons `\hline` pour placer un filet horizontal au-dessus de la première ligne et en dessous de la dernière :
```latex theme={null}
\begin{center}
\begin{tabular}{|c|c|c|}
\hline
cell1 & cell2 & cell3 \\
cell4 & cell5 & cell6 \\
cell7 & cell8 & cell9 \\
\hline
\end{tabular}
\end{center}
```
[Ouvrir cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=Table+example+with+rules\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bcenter%7D%0A%5Cbegin%7Btabular%7D%7B%7Cc%7Cc%7Cc%7C%7D+%0A+%5Chline%0A+cell1+%26+cell2+%26+cell3+%5C%5C+%0A+cell4+%26+cell5+%26+cell6+%5C%5C+%0A+cell7+%26+cell8+%26+cell9+%5C%5C+%0A+%5Chline%0A%5Cend%7Btabular%7D%0A%5Cend%7Bcenter%7D%0A%5Cend%7Bdocument%7D)
Cet exemple produit le résultat suivant :
Voici un autre exemple :
```latex theme={null}
\begin{center}
\begin{tabular}{||c c c c||}
\hline
Col1 & Col2 & Col2 & Col3 \\ [0.5ex]
\hline\hline
1 & 6 & 87837 & 787 \\
\hline
2 & 7 & 78 & 5415 \\
\hline
3 & 545 & 778 & 7507 \\
\hline
4 & 545 & 18744 & 7560 \\
\hline
5 & 88 & 788 & 6344 \\ [1ex]
\hline
\end{tabular}
\end{center}
```
[Ouvrir cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=Another+table+example+containing+rules\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bcenter%7D%0A+%5Cbegin%7Btabular%7D%7B%7C%7Cc+c+c+c%7C%7C%7D+%0A+%5Chline%0A+Col1+%26+Col2+%26+Col2+%26+Col3+%5C%5C+%5B0.5ex%5D+%0A+%5Chline%5Chline%0A+1+%26+6+%26+87837+%26+787+%5C%5C+%0A+%5Chline%0A+2+%26+7+%26+78+%26+5415+%5C%5C%0A+%5Chline%0A+3+%26+545+%26+778+%26+7507+%5C%5C%0A+%5Chline%0A+4+%26+545+%26+18744+%26+7560+%5C%5C%0A+%5Chline%0A+5+%26+88+%26+788+%26+6344+%5C%5C+%5B1ex%5D+%0A+%5Chline%0A%5Cend%7Btabular%7D%0A%5Cend%7Bcenter%7D%0A%5Cend%7Bdocument%7D)
Cet exemple produit le résultat suivant :
### Légendes, étiquettes et références
Vous pouvez ajouter une légende à un tableau et y faire référence à peu près de la même manière que pour les images. La seule différence est qu'au lieu de l'environnement **`figure`**, vous utilisez l'environnement **`table`**.
Le tableau \ref\{table:data} montre comment ajouter une légende à un tableau et y faire référence.
```latex theme={null}
\begin{table}[h!]
\centering
\begin{tabular}{||c c c c||}
\hline
Col1 & Col2 & Col2 & Col3 \\ [0.5ex]
\hline\hline
1 & 6 & 87837 & 787 \\
2 & 7 & 78 & 5415 \\
3 & 545 & 778 & 7507 \\
4 & 545 & 18744 & 7560 \\
5 & 88 & 788 & 6344 \\ [1ex]
\hline
\end{tabular}
\caption{Table to test captions and labels.}
\label{table:data}
\end{table}
```
[Ouvrir cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=Table+captions+and+references\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0ATable+%5Cref%7Btable%3Adata%7D+shows+how+to+add+a+table+caption+and+reference+a+table.%0A%5Cbegin%7Btable%7D%5Bh%21%5D%0A%5Ccentering%0A%5Cbegin%7Btabular%7D%7B%7C%7Cc+c+c+c%7C%7C%7D+%0A+%5Chline%0A+Col1+%26+Col2+%26+Col2+%26+Col3+%5C%5C+%5B0.5ex%5D+%0A+%5Chline%5Chline%0A+1+%26+6+%26+87837+%26+787+%5C%5C+%0A+2+%26+7+%26+78+%26+5415+%5C%5C%0A+3+%26+545+%26+778+%26+7507+%5C%5C%0A+4+%26+545+%26+18744+%26+7560+%5C%5C%0A+5+%26+88+%26+788+%26+6344+%5C%5C+%5B1ex%5D+%0A+%5Chline%0A%5Cend%7Btabular%7D%0A%5Ccaption%7BTable+to+test+captions+and+labels.%7D%0A%5Clabel%7Btable%3Adata%7D%0A%5Cend%7Btable%7D%0A%5Cend%7Bdocument%7D)
Cet exemple produit le résultat suivant :
## Ajouter une table des matières
Créer une table des matières est très simple, car la commande `\tableofcontents` fait presque tout le travail à votre place :
```latex theme={null}
\documentclass{article}
\title{Sections and Chapters}
\author{Gubert Farnsworth}
\date{August 2022}
\begin{document}
\maketitle
\tableofcontents
\section{Introduction}
This is the first section.
Lorem ipsum dolor sit amet, consectetuer adipiscing
elit. Etiam lobortisfacilisis sem. Nullam nec mi et
neque pharetra sollicitudin. Praesent imperdietmi nec ante.
Donec ullamcorper, felis non sodales...
\section*{Unnumbered Section}
\addcontentsline{toc}{section}{Unnumbered Section}
Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Etiam lobortis facilisissem. Nullam nec mi et neque pharetra
sollicitudin. Praesent imperdiet mi necante...
\section{Second Section}
Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Etiam lobortis facilisissem. Nullam nec mi et neque pharetra
sollicitudin. Praesent imperdiet mi necante...
\end{document}
```
[Ouvrir cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=Generating+a+table+of+contents\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Ctitle%7BSections+and+Chapters%7D%0A%5Cauthor%7BGubert+Farnsworth%7D%0A%5Cdate%7BAugust+2022%7D%0A%5Cbegin%7Bdocument%7D%0A++%0A%5Cmaketitle%0A++%0A%5Ctableofcontents%0A%0A%5Csection%7BIntroduction%7D%0A+++%0AThis+is+the+first+section.%0A++++++%0ALorem++ipsum++dolor++sit++amet%2C++consectetuer++adipiscing++%0Aelit.+++Etiam++lobortisfacilisis+sem.++Nullam+nec+mi+et+%0Aneque+pharetra+sollicitudin.++Praesent+imperdietmi+nec+ante.+%0ADonec+ullamcorper%2C+felis+non+sodales...%0A+++++++%0A%5Csection%2A%7BUnnumbered+Section%7D%0A%5Caddcontentsline%7Btoc%7D%7Bsection%7D%7BUnnumbered+Section%7D%0A%0ALorem+ipsum+dolor+sit+amet%2C+consectetuer+adipiscing+elit.++%0AEtiam+lobortis+facilisissem.++Nullam+nec+mi+et+neque+pharetra+%0Asollicitudin.++Praesent+imperdiet+mi+necante...%0A%0A%5Csection%7BSecond+Section%7D%0A+++++++%0ALorem+ipsum+dolor+sit+amet%2C+consectetuer+adipiscing+elit.++%0AEtiam+lobortis+facilisissem.++Nullam+nec+mi+et+neque+pharetra+%0Asollicitudin.++Praesent+imperdiet+mi+necante...%0A%5Cend%7Bdocument%7D)
Cet exemple produit le résultat suivant :
Les sections, sous-sections et chapitres sont automatiquement inclus dans la table des matières. Pour ajouter manuellement des entrées, comme une section non numérotée, utilisez la commande `\addcontentsline`, comme dans l'exemple.
## Télécharger votre document terminé
Le court extrait vidéo suivant montre comment télécharger le code source de votre projet ou le fichier PDF composé :
Vous trouverez plus d'informations dans l'article d'aide d'Overleaf [Exporter votre travail depuis Overleaf](https://docs.overleaf.com/managing-projects-and-files/downloading-a-project).
## Trouver et utiliser des paquets LaTeX
LaTeX offre non seulement d'importantes capacités de composition, mais aussi un *cadre d'extensibilité* grâce à l'utilisation de *paquets* complémentaires. Plutôt que de chercher à fournir des commandes et des fonctionnalités qui « font tout », LaTeX est conçu pour être *extensible* : les utilisateurs peuvent charger des ensembles de code externes (des paquets) qui apportent des capacités de composition plus spécialisées ou étendent les fonctionnalités intégrées de LaTeX, comme la composition de tableaux. Comme nous l'avons vu dans la section [Ajouter des images](/fr/texlive/latex-basics/learn-latex-in-30-minutes#Adding%5Fimages), le paquet `graphicx` étend LaTeX en fournissant des commandes pour importer des fichiers graphiques ; il a été chargé (dans le préambule) en écrivant
```latex theme={null}
\usepackage{graphicx}
```
### Charger des paquets
Comme indiqué plus haut, les paquets sont chargés dans le préambule du document à l'aide de la commande `\usepackage` ; mais comme (de nombreux) paquets LaTeX proposent un ensemble d'*options* permettant de configurer leur comportement, la commande `\usepackage` ressemble souvent à ceci :
```latex theme={null}
\usepackage[options]{somepackage}
```
Les crochets « `[...]` » indiquent à LaTeX quel ensemble d'options appliquer lorsqu'il charge `somepackage`. Dans l'ensemble d'options demandé par l'utilisateur, les options ou réglages individuels sont généralement séparés par une virgule ; par exemple, le [paquet geometry](https://ctan.org/pkg/geometry) propose de nombreuses options pour configurer la mise en page dans LaTeX, si bien qu'une utilisation typique de `geometry` pourrait ressembler à ceci :
```latex theme={null}
\usepackage[total={6.5in,8.75in},
top=1.2in, left=0.9in, includefoot]{geometry}
```
Le paquet `geometry` est un exemple de paquet écrit et partagé par des membres de la communauté LaTeX mondiale, et mis gratuitement à la disposition de tous ceux qui souhaitent l'utiliser.
Si un paquet LaTeX ne propose aucune option, ou si l'utilisateur souhaite utiliser les valeurs par défaut des options d'un paquet, celui-ci se charge ainsi :
```latex theme={null}
\usepackage{somepackage}
```
Lorsque vous écrivez `\usepackage[...]{somepackage}`, LaTeX recherche un fichier correspondant nommé `_somepackage_.sty`, qu'il doit charger et traiter afin de rendre disponibles les commandes du paquet et d'exécuter tout autre code fourni par ce paquet. Si LaTeX ne trouve pas `_somepackage_.sty`, il s'arrête avec une erreur, comme le montre l'exemple Overleaf suivant :
```latex theme={null}
\documentclass[12pt, letterpaper]{article}
\usepackage{somepackage}% a NON-EXISTENT package
\begin{document}
This will fail!
\end{document}
```
[Ouvrir cet ***exemple qui génère une erreur*** dans Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=Error+due+to+missing+package\&snip=%5Cdocumentclass%5B12pt%2C+letterpaper%5D%7Barticle%7D%0A%5Cusepackage%7Bsomepackage%7D%25+a+NON-EXISTENT+package%0A%5Cbegin%7Bdocument%7D%0AThis+will+fail%21%0A%5Cend%7Bdocument%7D)
Cet exemple produit le résultat suivant :
### Trouver des informations sur les paquets : le CTAN
Les paquets sont distribués via le [Comprehensive TeX Archive Network](https://www.ctan.org/), généralement appelé CTAN, qui, au moment de la rédaction, héberge 6287 paquets provenant de 2881 contributeurs. Le CTAN [se décrit](https://www.ctan.org/ctan) comme
> ... un ensemble de sites Internet répartis dans le monde entier qui proposent en téléchargement du matériel lié à TEX.
Vous pouvez parcourir le CTAN pour rechercher des paquets utiles, par exemple :
* [par thème](https://www.ctan.org/topics/cloud)
* [par ordre alphabétique](https://www.ctan.org/pkg) (utile si vous connaissez le nom du paquet)
Vous pouvez aussi utiliser la [fonction de recherche](https://www.ctan.org/pkg) (en haut de la page).
### Paquets disponibles sur Overleaf : présentation de TeX Live
Une fois par an, un (vaste) *sous-ensemble* des paquets hébergés sur le CTAN, ainsi que des polices liées à LaTeX et d'autres logiciels, est rassemblé et distribué sous la forme d'un système appelé [TeX Live](https://tug.org/texlive/), qui peut servir à installer votre propre environnement LaTeX (local). En fait, [les serveurs d'Overleaf utilisent également TeX Live](https://www.overleaf.com/learn/latex/Overleaf_and_TeX_Live) et sont mis à jour lors de la sortie d'une nouvelle version de TeX Live. Les mises à jour de TeX Live sur Overleaf ne sont pas immédiates : elles ont lieu quelques mois après la sortie, ce qui nous laisse le temps de tester la compatibilité de la nouvelle version de TeX Live avec les [milliers de modèles de notre galerie](https://www.overleaf.com/gallery). Voici par exemple notre [annonce de la mise à niveau vers TeX Live 2025](https://www.overleaf.com/blog/tex-live-2025-is-now-available).
Bien que TeX Live contienne un (vaste) *sous-ensemble* des paquets du CTAN, il est possible de trouver un paquet intéressant, comme [igo pour composer des diagrammes de go](https://ctan.org/pkg/igo?lang=en), qui est hébergé sur le CTAN mais n'est pas inclus dans TeX Live (ni distribué par lui), et donc indisponible sur Overleaf. Certains paquets hébergés sur le CTAN ne font pas partie de TeX Live pour diverses raisons : un paquet peut être obsolète, présenter des problèmes de licence, être très récent (téléversé récemment) ou dépendre d'une plateforme, par exemple fonctionner sous Windows mais pas sous Linux.
De nouveaux paquets, ainsi que des mises à jour de paquets existants, sont téléversés sur le CTAN tout au long de l'année, mais les mises à jour de TeX Live sont distribuées une fois par an ; par conséquent, les paquets contenus dans la version actuelle de TeX Live ne seront pas aussi à jour que ceux hébergés sur le CTAN. Comme les serveurs d'Overleaf utilisent TeX Live, il est possible que les paquets installés sur nos serveurs (c'est-à-dire ceux mis à la disposition de nos utilisateurs) ne soient pas les toutes dernières versions disponibles sur le CTAN, mais, en général, cela ne devrait pas poser de problème.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.