> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/fr/bases-de-latex/01-learn-latex-in-30-minutes.md).

# Créer votre premier document LaTeX

**NOUVEAU : visitez le nouveau** [**Centre d’apprentissage Overleaf**](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, mais, espérons-le, à la fin, vous n’aurez pas seulement rédigé votre premier document LaTeX ; vous aurez aussi acquis suffisamment de connaissances et d’assurance pour franchir les prochaines étapes vers la maîtrise de LaTeX.

## Qu’est-ce que LaTeX ?

LaTeX (prononcé « *LAY*-tek » ou « *LAH*-tek ») est un outil de mise en page de documents à l’aspect professionnel. Cependant, le mode de fonctionnement de LaTeX est assez différent de celui de nombreuses autres applications de création de documents que vous avez peut-être utilisées, comme Microsoft Word ou LibreOffice Writer : ces outils « [WYSIWYG](https://en.wikipedia.org/wiki/WYSIWYG) » fournissent aux utilisateurs une page interactive dans laquelle ils saisissent et modifient leur texte et appliquent diverses formes de mise en forme. LaTeX fonctionne très différemment : votre document est plutôt un simple fichier texte brut parsemé de commandes LaTeX *commandes* utilisées pour exprimer les résultats souhaités (mis en page). Pour produire un document visible et composé, votre fichier LaTeX est traité par un logiciel appelé un *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 manière professionnelle. Cela signifie que vous n’avez besoin de vous concentrer que sur le *contenu* du document et l’ordinateur, via les commandes LaTeX et le moteur TeX, se chargera de l’ *apparence visuelle* (mise en forme).

## Pourquoi apprendre LaTeX ?

Divers arguments peuvent être avancés en faveur ou à l’encontre de l’apprentissage de LaTeX plutôt que d’autres applications de création 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 en matière de documentation.

Les arguments en faveur de LaTeX incluent :

* la prise en charge de la composition de mathématiques extrêmement complexes, de tableaux et de contenu technique pour les sciences physiques ;
* des fonctions pour les notes de bas de page, les renvois croisés et la gestion des bibliographies ;
* la facilité à produire des éléments de document compliqués ou fastidieux tels que des index, des glossaires, des tables des matières, des listes de figures ;
* le fait d’être hautement personnalisable pour la production de documents sur mesure grâce à sa programmabilité intrinsèque et à son extensibilité via des milliers de [packages 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 mis en page 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 à son avantage, notamment de nombreuses mises en page « libres » que l’on trouve généralement dans les publications de type magazine.

Un avantage important de LaTeX est la séparation entre le contenu du document et son style : une fois que vous avez rédigé le contenu de votre document, son apparence peut être modifiée très facilement. De même, vous pouvez créer un fichier LaTeX qui définit la mise en page/le style d’un type de document particulier et ce fichier peut être utilisé comme un *modèle* pour standardiser la rédaction/la production de documents supplémentaires de ce type ; par exemple, cela permet aux éditeurs scientifiques de créer des modèles d’articles, en LaTeX, que les auteurs utilisent pour rédiger des articles à soumettre aux revues. Overleaf dispose d’une [galerie contenant des milliers de modèles](https://www.overleaf.com/gallery), couvrant une immense gamme de types de documents — des articles scientifiques, des rapports et des livres aux CV et aux 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 — en créant un nouveau projet — et commencer à écrire pour ajouter leur contenu.

## Rédiger votre premier extrait de 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 `.tex` fichier ; sinon, vous pouvez [créer un nouveau projet dans Overleaf](/latex/fr/base-de-connaissances/031-creating-a-document-in-overleaf.md).

Commençons par l’exemple fonctionnel le plus simple, que vous pouvez ouvrir directement dans Overleaf :

```latex
\documentclass{article}
\begin{document}
Premier document. Il s’agit d’un exemple simple, sans
paramètres supplémentaires ni packages inclus.
\end{document}
```

[Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=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 :

![Document d’exemple](/files/cfd92f5f17d05af6c0054d15cea93e1909676250)

Vous pouvez voir que LaTeX a automatiquement mis en retrait la première ligne du paragraphe, s’occupant ainsi de 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 de document, appelé sa *classe*, qui contrôle l’apparence générale du document. Différents types de documents nécessitent différentes classes ; c’est-à-dire qu’un CV nécessitera une classe différente d’un article scientifique, qui pourrait utiliser la classe LaTeX standard `article` . D’autres types de documents sur lesquels vous travaillez peuvent nécessiter différentes classes telles que `book` ou `report`. Pour avoir une idée des nombreux types de classes LaTeX disponibles, [consultez la page correspondante sur CTAN (Comprehensive TeX Archive Network)](https://www.ctan.org/topic/class).

Une fois la classe de document définie, notre contenu, appelé le *corps* du document, s’écrit entre les `\begin{document}` et `\end{document}` balises. Après avoir ouvert l’exemple ci-dessus, vous pouvez modifier le texte et, une fois terminé, afficher le PDF composé résultant en *recompilant le document*. Pour ce faire dans Overleaf, il suffit d’appuyer sur **Recompiler**, comme le montre ce bref extrait vidéo :

{% embed url="<https://videos.ctfassets.net/nrgyaltdicpt/6yo2PA5aMV3OEZl5NtZKWu/54395f569b830b8183b5e0058d5bc0cc/LL30recompile.mp4>" %}

Tout projet Overleaf peut être configuré pour se recompiler automatiquement à chaque modification : cliquez sur la petite flèche à côté du **Recompiler** bouton et réglez **Auto Compile** à **Activée**, comme le montre la capture d’écran suivante :

![Capture d’écran montrant comment régler Auto Compile sur Activé ou Désactivé](/files/13a1e49459c930f631c5a71a53fdff489c4a2d13)

Après avoir 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 enregistrant un document LaTeX sous la forme d’un fichier appelé `main.tex` : l’ `.tex` extension de fichier est, par convention, utilisée lors du nommage des fichiers contenant le code LaTeX de votre document.

L’exemple précédent montrait comment le contenu du document était saisi après la `\begin{document}` commande ; cependant, tout ce qui se trouve dans votre `.tex` fichier après *avant* ce point est appelé le *préambule*préambule, qui agit comme la section « configuration » du document. Dans le préambule, vous définissez la classe (type) du document ainsi que des précisions telles que les langues à utiliser lors de la rédaction du document ; vous chargez les packages que vous souhaitez utiliser (nous y reviendrons plus tard), et c’est aussi là que vous appliquerez d’autres types de configuration. *packages* que vous souhaitez utiliser (nous y reviendrons [plus tard](#finding-and-using-latex-packages)), et c’est aussi là que vous appliquerez d’autres types de configuration.

Un préambule de document minimal pourrait ressembler à ceci :

```latex
\documentclass[12pt, letterpaper]{article}
\usepackage{graphicx}
```

où `\documentclass[12pt, letterpaper]{article}` définit la classe (type) générale 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 fondé sur une `article`-classe.

Dans cet exemple, les deux paramètres font ce qui suit :

* `12pt` définit la taille de police
* `letterpaper` définit le format du papier

Bien sûr, d’autres tailles de police, `9pt`, `11pt`, `12pt`, peuvent être utilisées, mais si aucune n’est précisée, la taille par défaut est `10pt`. Quant au format du papier, d’autres valeurs possibles sont `a4paper` et `legalpaper`. Pour plus d’informations, consultez l’article sur [la taille de page et les marges](/latex/fr/mise-en-forme/07-page-size-and-margins.md).

La ligne du préambule

```latex
\usepackage{graphicx}
```

est un exemple de chargement d’un package externe (ici, [`graphicx`](https://ctan.org/pkg/graphicx?lang=en)) pour étendre les capacités de LaTeX, lui permettant d’importer des fichiers graphiques externes. Les packages LaTeX sont abordés dans la section [Trouver et utiliser des packages LaTeX](#finding-and-using-latex-packages).

## Inclure les informations de titre, d’auteur et de date

Ajouter un titre, un auteur et une date à notre document nécessite trois lignes supplémentaires dans le préambule (et non dans le *préambule* (*ne* corps principal du document). Ces lignes sont :

* `\title{My first LaTeX document}`: le titre du document
* `\author{Hubert Farnsworth}`: ici, vous écrivez le nom de l’auteur ou des auteurs et, éventuellement, la `\thanks` commande entre 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 ajoutera 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
\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 `\maketitle` commande située dans le *corps* corps du document :

```latex
\begin{document}
\maketitle
Nous avons maintenant ajouté un titre, un auteur et une date à notre premier document \LaTeX{} !
\end{document}
```

Le préambule et le corps peuvent maintenant être combinés pour produire un document complet qui peut être ouvert dans Overleaf :

```latex
\documentclass[12pt, letterpaper]{article}
\title{My first LaTeX document}
\author{Hubert Farnsworth\thanks{Funded by the Overleaf team.}}
\date{August 2022}
\begin{document}
\maketitle
Nous avons maintenant ajouté un titre, un auteur et une date à notre premier document \LaTeX{} !
\end{document}
```

[Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=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 :

![Image d’un document simple produit en LaTeX](/files/7f95fe035dbc3b38cc1e4f9d800ba2e159d4e555)

## Ajouter des commentaires

LaTeX est une forme de « code de programme », mais spécialisée dans la mise en page 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 section de texte qui ne sera ni composée ni n’affectera le document de quelque façon que ce soit — souvent utilisée pour ajouter des notes « à faire » ; inclure des notes explicatives ; fournir des explications en ligne sur des macros délicates ou mettre en commentaire des lignes/sections de code LaTeX lors du débogage.

Pour écrire un commentaire en LaTeX, il suffit de saisir un `%` symbole au début de la ligne, comme le montre le code suivant qui utilise l’exemple ci-dessus :

```latex
\documentclass[12pt, letterpaper]{article}
\title{My first LaTeX document}
\author{Hubert Farnsworth\thanks{Funded by the Overleaf team.}}
\date{August 2022}
\begin{document}
\maketitle
Nous avons maintenant ajouté un titre, un auteur et une date à notre premier document \LaTeX{} !

% Cette ligne ici est un commentaire. Elle ne sera pas composée dans le document.
\end{document}
```

[Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=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 au code LaTeX précédent qui ne contenait pas le commentaire.

## Gras, italiques et soulignement

Voyons maintenant quelques commandes de mise en forme du texte :

* **Gras**: le texte en gras en LaTeX est composé à l’aide de la `\textbf{...}` commande.
* *Italique*: le texte en italique est produit à l’aide de la `\textit{...}` commande.
* Soulignement : pour souligner du texte, utilisez la `\underline{...}` commande.

L’exemple suivant montre ces commandes :

```latex
Certaines des \textbf{plus grandes}
découvertes en \underline{science}
ont été faites par \textbf{\textit{accident}}.
```

[Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=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 :

![Image montrant du texte mis en forme dans un document LaTeX](/files/c6d2b98d186bd6c2fc0b24b1fbd1d19d238b47e6)

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 emphase est en italique, mais ce comportement est inversé s’il est utilisé à l’intérieur d’un texte en italique — voir l’exemple suivant :

```latex
Certaines des plus grandes \emph{découvertes} en science
ont été faites par accident.

\textit{Certaines des \emph{plus grandes découvertes}
en science ont été faites par accident.}

\textbf{Certaines des \emph{plus grandes découvertes}
en science ont été faites par accident.}
```

[Ouvrez cet `**\\emph**` exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+the+emph+command\&snip=%5Cdocumentclass%5B12pt%2C+letterpaper%2C+twoside%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 :

![Image démontrant l’utilisation de la commande \emph de LaTeX](/files/12ad11c7c0cf5b98d67edd8213069f9bb2d160e0)

* **Remarque :** certains packages, comme [Beamer](/latex/fr/presentations/01-beamer.md), modifient le comportement de la `\emph` commande.

## Ajouter des images

Dans cette section, nous verrons comment ajouter des images à un document LaTeX. Overleaf prend en charge trois façons d’insérer des images :

1. Utilisez la [**Insérer une figure** bouton](https://learn.overleaf.com/learn/Kb/How_to_insert_figures_in_Overleaf#Using_Insert_Figure_to_add_a_figure_to_your_project)(![The Insert Figure button on the editor toolbar](/files/899dd718d0e11519e9d1ca2d85f193188141e3b9)), situé dans la barre d’outils de l’éditeur, pour insérer une image dans **Éditeur visuel** ou **Éditeur de code**.
2. [Copier et coller une image](/latex/fr/base-de-connaissances/075-how-to-paste-formatted-content-into-overleaf.md#pasting-images-into-your-overleaf-project) dans **Éditeur visuel** ou **Éditeur de code**.
3. Utiliser **Éditeur de code** pour écrire du code LaTeX qui insère un graphique.

Les options 1 et 2 génèrent automatiquement le code LaTeX requis pour insérer des images, mais ici nous présentons l’option 3 — notez que vous devrez [téléverser ces images](/latex/fr/base-de-connaissances/088-including-images-on-overleaf.md) dans votre projet Overleaf. L’exemple suivant montre comment inclure une image :

```latex
\documentclass{article}
\usepackage{graphicx} %Package LaTeX pour importer des graphiques
\graphicspath{{images/}} %configuration du package graphicx

\begin{document}
L’univers est immense et il semble être homogène,
à grande échelle, partout où nous regardons.

% La commande \includegraphics est
% fournie (implémentée) par le
% package graphicx
\includegraphics{universe}

Il y a une image d’une galaxie ci-dessus.
\end{document}
```

[Ouvrez 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 :

![Graphique montrant une image importée dans un document LaTeX](/files/59e7b325fcd015e4b5341ba8472701a57317d853)

L’importation de graphiques dans un document LaTeX nécessite [un complément *package*](#finding-and-using-latex-packages) qui fournit les commandes et les fonctionnalités nécessaires pour inclure des fichiers graphiques externes. L’exemple ci-dessus charge le [`graphicx` package](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 l' `graphicx` package, incluez la ligne suivante dans le préambule de votre document Overleaf :

```latex
\usepackage{graphicx}
```

Dans notre exemple, la commande `\graphicspath{{images/}}` indique à LaTeX que les images sont stockées dans un dossier nommé `images`, qui se trouve dans le répertoire courant :

![Image montrant LaTeX accédant à des images stockées dans un dossier](/files/357c611bbd16ffb422db7163564146cdfa1c47c2)

Le `\includegraphics{universe}` fait réellement le travail d’insertion de l’image dans le document. Ici, `universe` est le nom du fichier image, mais sans son extension.

**Remarque**:

* Bien que le nom complet du fichier, y compris son extension, soit autorisé dans la `\includegraphics` commande, il est considéré comme une bonne pratique d’omettre l’extension du fichier car cela incitera LaTeX à rechercher tous les formats pris en charge.
* En général, le nom du fichier graphique ne doit pas contenir d’espaces ni plusieurs points ; il est également recommandé d’utiliser des lettres minuscules pour l’extension du fichier lors du téléversement d’images dans Overleaf.

Vous trouverez davantage d’informations sur les packages LaTeX à la fin de ce tutoriel dans la section [Trouver et utiliser des packages LaTeX](#finding-and-using-latex-packages).

## Légendes, étiquettes et références

Les images peuvent recevoir une légende, une étiquette et des références au moyen de l’ `environnement figure` , comme indiqué ci-dessous :

```latex
\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}

Comme vous pouvez le voir à la figure \ref{fig:mesh1}, la fonction croît près de l’origine. Cet exemple se trouve à la page \pageref{fig:mesh1}.

\end{document}
```

[Ouvrez 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 :

![Graphique montrant l’utilisation des légendes de figure en LaTeX](/files/0a05398698f665280261c135e9c4a271a2a0d5d1)

Plusieurs commandes méritent d’être signalées dans l’exemple :

* **`\includegraphics[width=0.75\textwidth]{mesh}`**: Cette forme de `\includegraphics` indique à LaTeX de fixer la largeur de la figure à 75 % de la largeur du texte — dont la valeur est stockée dans `\textwidth` commande.
* **`\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 au-dessous de la figure. Si vous créez une liste des figures, cette légende sera utilisée dans cette liste.
* **`\label{fig:mesh1}`**: Pour faire référence à cette image dans votre document, vous lui attribuez une étiquette à l’aide de la `\label` commande. L’étiquette est utilisée pour générer un numéro pour l’image et, combinée avec la commande suivante, elle vous permettra 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 dans un document LaTeX doivent être placées dans un `environnement figure` environnement, ou équivalent, afin que LaTeX puisse positionner automatiquement l’image à un emplacement approprié dans votre document.

Vous trouverez des indications supplémentaires dans les articles d’aide Overleaf suivants :

* [Positionnement des figures](/latex/fr/figures-et-tableaux/02-positioning-images-and-tables.md)
* [Insertion d'images](/latex/fr/autres-sujets/27-inserting-images.md)

## Créer des listes en LaTeX

Vous pouvez créer différents types de listes à l’aide des *environnements*, qui servent à encapsuler le code LaTeX nécessaire à la mise en œuvre d’une fonctionnalité de composition spécifique. Un environnement commence par `\begin{*environment-name*}` et se termine par `\end{*environment-name*}` où `*environment-name*` peut être `environnement figure`, `tabular` ou l’un des types de liste : `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’ `itemize` environnement. Chaque élément de la liste doit être précédé par la `\item` commande, comme indiqué ci-dessous :

```latex
\documentclass{article}
\begin{document}
\begin{itemize}
  \item Les éléments individuels sont indiqués par un point noir, appelé puce.
  \item Le texte des entrées peut être de n'importe quelle longueur.
\end{itemize}
\end{document}
```

[Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=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 :

![Exemple de listes à puces en LaTeX](/files/601ea949d33a7b4c95f891144e05562714a2be1c)

Vous pouvez également ouvrir ce [plus grand projet Overleaf](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 montre 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 à l’aide de l’ `enumerate` environnement :

```latex
\documentclass{article}
\begin{document}
\begin{enumerate}
  \item Ceci est la première entrée de notre liste.
  \item Les numéros de la liste augmentent à chaque entrée ajoutée.
\end{enumerate}
\end{document}
```

[Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=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 :

![Exemple de liste numérotée produite en LaTeX](/files/1f895438365fe55f46cbe39ab28af11fdd615d1a)

Comme pour les `listes non ordonnées` , chaque entrée doit être précédée par la `\item` commande qui, ici, génère automatiquement la valeur numérique de l’étiquette de liste ordonnée, en commençant à 1.

Pour plus d’informations, vous pouvez ouvrir ce [plus grand projet Overleaf](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 montre différents types de listes LaTeX ou consulter notre [article d’aide dédié aux listes LaTeX](/latex/fr/bases-de-latex/04-lists.md), qui fournit bien plus d’exemples et montre comment créer des listes personnalisées.

## Ajouter des mathématiques à LaTeX

L’un des principaux avantages de LaTeX est la facilité avec laquelle les expressions mathématiques peuvent être écrites. LaTeX propose deux modes d’écriture pour la composition des mathématiques :

* *markdown en ligne* mode math utilisé pour écrire des formules qui font partie d’un paragraphe
* *affiché* mode math 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 en ligne

Voyons un exemple de mode math en ligne :

```latex
\documentclass[12pt, letterpaper]{article}
\begin{document}
En physique, l'équivalence masse-énergie s'exprime
par l'équation $E=mc^2$, découverte en 1905 par Albert Einstein.
\end{document}
```

[Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=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 :

![Image montrant des mathématiques composées en mode math en ligne](/files/22a932bc6834736873d59367ecdf82b2b453b1c7)

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
\documentclass[12pt, letterpaper]{article}
\begin{document}
\begin{math}
E=mc^2
\end{math} est composé dans un paragraphe en mode math en ligne — tout comme $E=mc^2$, et \(E=mc^2\) également.
\end{document}
```

[Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=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 :

![Image montrant du contenu produit en mode math en ligne LaTeX](/files/477c31894c3bfd25f12f7403f62cd3ca853b3286)

### Mode math affiché

Les équations composées en mode affiché peuvent être numérotées ou non numérotées, comme dans l’exemple suivant :

```latex
\documentclass[12pt, letterpaper]{article}
\begin{document}
L'équivalence masse-énergie est décrite par la célèbre équation
\[ E=mc^2 \] découverte en 1905 par Albert Einstein.

Dans les unités naturelles ($c = 1$), la formule exprime l’identité
\begin{equation}
E=m
\end{equation}
\end{document}
```

[Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=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 :

![Image montrant des mathématiques en mode affiché en LaTeX](/files/2840ef4361444f6825c2c0752d244c762df3aa1c)

Pour composer des mathématiques en mode affiché, vous pouvez utiliser l’une de ces paires de délimiteurs : `\[ ... \]`, `\begin{displaymath} ... \end{displaymath}` ou `\begin{equation} ... \end{equation}`. Historiquement, la composition des mathématiques en mode affiché nécessitait l’utilisation de `$$` délimiteurs de caractères, comme dans `$$ *... display math here ...*$$`, mais cette méthode [n’est plus recommandée](https://texfaq.org/FAQ-dolldoll): utilisez les délimiteurs de LaTeX `\[ ... \]` à la place.

### Exemples plus complets

Les exemples suivants présentent une variété de contenus mathématiques composés avec LaTeX.

```latex
\documentclass{article}
\begin{document}
Les indices en mode math s’écrivent $a_b$ et les exposants s’écrivent $a^b$. Ils peuvent être combinés et imbriqués pour écrire des expressions telles que

\[ 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}) \]

On écrit les intégrales à l’aide de $\int$ et les fractions à l’aide de $\frac{a}{b}$. Les bornes des intégrales se placent à l’aide d’exposants et d’indices :

\[ \int_0^1 \frac{dx}{e^x} =  \frac{e-1}{e} \]

Les lettres grecques minuscules s’écrivent $\omega$ $\delta$, etc., tandis que les lettres grecques majuscules s’écrivent $\Omega$ $\Delta$.

Les opérateurs mathématiques sont précédés d’une barre oblique inverse, comme $\sin(\beta)$, $\cos(\alpha)$, $\log(x)$, etc.
\end{document}
```

[Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=More+advanced+LaTeX+math+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0ASubscripts+in+math+mode+are+written+as+%24a_b%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_1+i_2+%5Cdots+i_p%7D_%7Bj_1+j_2+%5Cdots+j_q%7D+%3D+T%28x%5E%7Bi_1%7D%2C%5Cdots%2Cx%5E%7Bi_p%7D%2Ce_%7Bj_1%7D%2C%5Cdots%2Ce_%7Bj_q%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_0%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 :

![Image montrant une variété de mathématiques composées en LaTeX](/files/3f9c6e4c3f3416b307527a971bae3531eb952ce6)

L’exemple suivant utilise le `equation*` environnement fourni par le `amsmath` package, donc nous devons ajouter la ligne suivante à notre préambule de document :

```latex
\usepackage{amsmath}% Pour l’environnement equation*
```

Pour plus d’informations sur l’utilisation de `amsmath` see [notre article d’aide](/latex/fr/mathematiques/06-aligning-equations-with-amsmath.md).

```latex
\documentclass{article}
\usepackage{amsmath}% Pour l’environnement equation*
\begin{document}
\section{First example}

Le célèbre théorème de Pythagore \(x^2 + y^2 = z^2\) a été démontré comme étant invalide pour d’autres exposants, ce qui signifie que l’équation suivante n’a pas de solutions entières pour \(n>2\) :

\[ x^n + y^n = z^n \]

\section{Second example}

Ceci est une simple expression mathématique \(\sqrt{x^2+1}\) dans le texte.
Et ceci est également la même chose :
\begin{math}
\sqrt{x^2+1}
\end{math}
mais en utilisant une autre commande.

Ceci est une simple expression mathématique sans numérotation
\[\sqrt{x^2+1}\]
séparée du texte.

Ceci est aussi la même chose :
\begin{displaymath}
\sqrt{x^2+1}
\end{displaymath}

\ldots et ceci :
\begin{equation*}
\sqrt{x^2+1}
\end{equation*}
\end{document}
```

[Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=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 :

![Image montrant une variété de mathématiques composées en LaTeX](/files/5a826e39b4d357b609fa602468760b8893045672)

Les possibilités des mathématiques en LaTeX sont infinies, alors n’hésitez pas à consulter nos pages d’aide pour obtenir des conseils et des exemples sur des sujets précis :

* [Expressions mathématiques](/latex/fr/mathematiques/01-mathematical-expressions.md)
* [Indices et exposants](/latex/fr/mathematiques/02-subscripts-and-superscripts.md)
* [Crochets et parenthèses](/latex/fr/mathematiques/03-brackets-and-parentheses.md)
* [Fractions et binômes](/latex/fr/mathematiques/05-fractions-and-binomials.md)
* [Alignement des équations](/latex/fr/mathematiques/06-aligning-equations-with-amsmath.md)
* [Opérateurs](/latex/fr/mathematiques/07-operators.md)
* [Espacement en mode math](/latex/fr/mathematiques/08-spacing-in-math-mode.md)
* [Intégrales, sommes et limites](/latex/fr/mathematiques/09-integrals-sums-and-limits.md)
* [Style affiché en mode math](/latex/fr/mathematiques/10-display-style-in-math-mode.md)
* [Liste des lettres grecques et des symboles mathématiques](/latex/fr/mathematiques/11-list-of-greek-letters-and-math-symbols.md)
* [Polices mathématiques](/latex/fr/mathematiques/12-mathematical-fonts.md)

## Structure de base d’un document

Ensuite, nous explorons les résumés et la manière de diviser un document LaTeX en différents chapitres, sections et paragraphes.

### Résumés

Les articles scientifiques fournissent généralement un *résumé* qui est un bref aperçu/résumé de leurs thèmes principaux ou de leurs arguments. L'exemple suivant montre la composition d'un résumé à l'aide de LaTeX `résumé` environnement :

```latex
\documentclass{article}
\begin{document}
\begin{abstract}
Ceci est un paragraphe simple au début du
document. Une brève introduction sur le sujet principal.
\end{abstract}
\end{document}
```

[Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=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 :

![Image montrant un résumé mis en page avec LaTeX](/files/019e37a10cb42f665200509d20586022290fbc42)

### Paragraphes et sauts de ligne

Une fois le résumé en place, nous pouvons commencer à rédiger 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 ensuite ;
* comment commencer une nouvelle ligne sans commencer un nouveau paragraphe en insérant un saut de ligne manuel à l'aide de la `\\` commande, qui correspond à deux barres obliques inverses ; sinon, utilisez la `\newline` commande.

Le troisième paragraphe de cet exemple montre l'utilisation des commandes `\\` et `\newline`:

```latex
\documentclass{article}
\begin{document}

\begin{abstract}
Ceci est un paragraphe simple au début du
document. Une brève introduction sur le sujet principal.
\end{abstract}

Après notre résumé, nous pouvons commencer le premier paragraphe, puis appuyer deux fois sur « enter » pour commencer le second.

Cette ligne commencera un deuxième paragraphe.

Je vais commencer le troisième paragraphe puis ajouter \\ un saut de ligne manuel, ce qui fait commencer ce texte sur une nouvelle ligne, mais il reste partie du même paragraphe. Sinon, je peux utiliser la \verb|\\newline|\\newline commande pour commencer une nouvelle ligne, qui fait également partie du même paragraphe.
\end{document}
```

[Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=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 :

![Image montrant la création de paragraphes dans LaTeX](/files/be46aede9e9746816d646fc0147d406c2a569082)

Remarquez comment LaTeX indente automatiquement les paragraphes — sauf immédiatement après les titres de document, comme section et subsection —[comme nous le verrons](#chapters-and-sections).

Les nouveaux utilisateurs sont avertis que de multiples `\\` ou `\newline`espaces ne doivent pas être utilisés pour « simuler » des paragraphes avec un espacement plus grand entre eux, car cela peut interférer avec les algorithmes de composition de LaTeX. La méthode recommandée est de continuer à utiliser des lignes vides pour créer de nouveaux paragraphes, sans aucun `\\`, et chargez le [`parskip` package](https://ctan.org/pkg/parskip?lang=en) en ajoutant `\usepackage{parskip}` dans le préambule.

Vous trouverez de plus amples informations sur les paragraphes dans les articles suivants :

* [Paragraphes et sauts de ligne](/latex/fr/bases-de-latex/02-paragraphs-and-new-lines.md)
* [Comment modifier l'espacement des paragraphes dans LaTeX](/latex/fr/mise-en-forme/04-articles-how-to-change-paragraph-spacing-in-latex.md)
* [Erreur LaTeX : il n'y a pas de ligne ici à terminer](/latex/fr/erreurs-latex/18-latex-error-there-s-no-line-here-to-end.md) fournit des conseils et des indications supplémentaires sur l'utilisation de `\\`.

### Chapitres et sections

Les documents plus longs, quel que soit le logiciel de rédaction, sont généralement divisés en parties, chapitres, sections, sous-sections, etc. LaTeX fournit également des commandes de structuration de document, mais les commandes disponibles, et leur implémentation (ce qu'elles font), peuvent dépendre de la classe de document utilisée. À titre d'exemple, les documents créés avec la `book` classe peuvent être divisés en parties, chapitres, sections, sous-sections, etc., mais la `letter` classe ne fournit aucune commande (ne les prend pas en charge) pour le faire.

L'exemple suivant montre des commandes utilisées pour structurer un document basé sur la `book` classe :

```latex
\documentclass{book}
\begin{document}

\chapter{Premier chapitre}

\section{Introduction}

Voici la première 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{Deuxième section}

Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Etiam lobortis facilisissem.  Nullam nec mi et neque pharetra
sollicitudin.  Praesent imperdiet mi necante...

\subsection{Première sous-section}
Praesent imperdietmi nec ante. Donec ullamcorper, felis non sodales...

\section*{Section non numérotée}
Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Etiam lobortis facilisissem...
\end{document}
```

[Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=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 :

![Image montrant les sections dans un document de livre LaTeX](/files/72ecaa44e02f9b296a4008de4c088ab106b48a76)

Les noms des commandes de structuration sont pour la plupart explicites ; par exemple, `\chapter{Premier chapitre}` crée un nouveau chapitre intitulé `Premier chapitre`, `\section{Introduction}` produit une section intitulée `Introduction`, et ainsi de suite. Les sections peuvent être divisées davantage en `\subsection{...}` et même `\subsubsection{...}`. La numérotation des sections, sous-sections, etc. est automatique, mais peut être désactivée en utilisant la soi-disant *version étoilée* de la commande appropriée, qui se termine par un astérisque (\*), comme `\section*{...}` et `\subsection*{...}`.

*Dans l'ensemble*, les classes de documents LaTeX fournissent les commandes de structuration suivantes, chaque classe spécifique ne prenant en charge qu'un sous-ensemble pertinent :

* `\part{partie}`
* `\chapter{chapitre}`
* `\section{section}`
* `\subsection{sous-section}`
* `\subsubsection{sous-sous-section}`
* `\paragraph{paragraphe}`
* `\subparagraph{sous-paragraphe}`

En particulier, les `\part` et `\chapter` commandes ne sont disponibles que dans les `report` et `book` classes de documents.

Consultez l'article Overleaf [article sur les sections et les chapitres](/latex/fr/structure-du-document/01-sections-and-chapters.md) pour plus d'informations sur les commandes de structuration de document.

## Création de tableaux

Overleaf propose trois options pour créer des tableaux :

1. L'utilisation de la feuille de style [**Insérer un tableau** bouton](/latex/fr/base-de-connaissances/067-how-to-generate-and-insert-latex-tables-in-overleaf.md#inserttable) dans la **Éditeur visuel** (ou **Éditeur de code**) barre d'outils.
2. [Copier et coller un tableau](/latex/fr/base-de-connaissances/075-how-to-paste-formatted-content-into-overleaf.md#pastingtables) depuis un autre document tout en utilisant **Éditeur visuel**.
3. Rédiger le code LaTeX du tableau dans l'éditeur de code.

Si vous débutez avec LaTeX, utiliser la barre d'outils dans **Éditeur visuel** (option 1) est un excellent moyen de démarrer — vous pouvez basculer entre **Éditeur visuel** et **Éditeur de code** pour voir le code derrière le tableau.

Ici, nous nous concentrons sur l'option 3 — la méthode la plus flexible pour créer des tableaux — et fournissons des exemples montrant comment créer des tableaux dans LaTeX, notamment l'ajout de lignes (traits) et de légendes. À mesure que vous gagnerez en expérience, consultez notre guide détaillé sur [comment créer des tableaux avec LaTeX](/latex/fr/figures-et-tableaux/01-tables.md).

### Créer un tableau de base dans LaTeX

Nous commençons par un exemple montrant comment composer un tableau de base :

```latex
\begin{center}
\begin{tabular}{c c c}
 cellule1 & cellule2 & cellule3 \\
 cellule4 & cellule5 & cellule6 \\
 cell7 & cell8 & cell9
\end{tabular}
\end{center}
```

[Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=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 :

![Graphique affichant un tableau composé avec LaTeX](/files/d7d38e666e0ddcaf16aaea212e1c435c9904ce0e)

Le `tabular` l'environnement est la méthode LaTeX par défaut pour créer des tableaux. Vous devez spécifier un paramètre à cet environnement, dans ce cas `{c c c}` qui indique à LaTeX qu'il y aura trois colonnes et que le texte à l'intérieur 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 `&` est utilisé pour délimiter les cellules individuelles d'un tableau dans une ligne du tableau. Pour terminer une ligne du tableau, utilisez la *nouvelle ligne* commande `\\`. Notre tableau est contenu dans un `center` environnement afin de le centrer dans la largeur de texte de la page.

### Ajouter des bordures

Le `tabular` l'environnement prend en charge les lignes horizontales et verticales (traits) dans le tableau :

* pour ajouter des traits horizontaux, au-dessus et au-dessous des lignes, utilisez `\hline` commande
* pour ajouter des traits 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 (trait) ; en plus, nous utilisons `\hline` pour placer un trait horizontal au-dessus de la première ligne et au-dessous de la dernière ligne :

```latex
\begin{center}
\begin{tabular}{|c|c|c|}
 \hline
 cellule1 & cellule2 & cellule3 \\
 cellule4 & cellule5 & cellule6 \\
 cellule7 & cellule8 & cellule9 \\
 \hline
\end{tabular}
\end{center}
```

[Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=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 :

![Graphique affichant un tableau composé avec LaTeX contenant des traits horizontaux et verticaux](/files/25c6a750c01f86206cd056e835acb914de047121)

Voici un autre exemple :

```latex
\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}
```

[Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=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 :

![Graphique affichant un tableau composé avec LaTeX contenant des traits horizontaux et verticaux](/files/61eb567112753e4bfdf9f8c3aeeb5882376b5c84)

### Légendes, étiquettes et références

Vous pouvez légender et référencer les tableaux de la même manière que les images. La seule différence est qu'au lieu de l' **`environnement figure`** environnement, vous utilisez le **`table`** environnement.

```latex
Le tableau \ref{table:data} montre comment ajouter une légende à un tableau et faire référence à un tableau.
\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{Tableau pour tester les légendes et les étiquettes.}
\label{table:data}
\end{table}
```

[Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=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 :

![Un tableau LaTeX avec une légende](/files/872db40986c9dfbe2e31663dc3f01a9cabb0f330)

## Ajouter une table des matières

Créer une table des matières est simple, car la commande `\tableofcontents` fait presque tout le travail pour vous :

```latex
\documentclass{article}
\title{Sections et chapitres}
\author{Gubert Farnsworth}
\date{August 2022}
\begin{document}

\maketitle

\tableofcontents

\section{Introduction}

Voici la première 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*{Section non numérotée}
\addcontentsline{toc}{section}{Section non numérotée}

Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Etiam lobortis facilisissem.  Nullam nec mi et neque pharetra
sollicitudin.  Praesent imperdiet mi necante...

\section{Deuxième 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}
```

[Ouvrez cet exemple dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=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 :

![Graphique montrant une table des matières produite par LaTeX](/files/c8594fed64bc964d6f421e4109369b7b06eed244)

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 montré dans l'exemple.

## Télécharger votre document terminé

Le bref extrait vidéo suivant montre comment télécharger le code source de votre projet ou le fichier PDF mis en page :

{% embed url="<https://videos.ctfassets.net/nrgyaltdicpt/2n6iw0AUELNtABCuva0oV5/cf27bff3a6099da94362d64645e69dfe/LL30download.mp4>" %}

Vous trouverez plus d'informations dans l'article d'aide Overleaf [Exporter votre travail depuis Overleaf](/latex/fr/base-de-connaissances/036-exporting-your-work-from-overleaf.md).

## Trouver et utiliser des packages LaTeX

LaTeX ne fournit pas seulement d'importantes capacités de composition, il offre aussi un *cadre d'extensibilité* grâce à l'utilisation d'extensions *packages*. Plutôt que d'essayer de fournir des commandes et des fonctionnalités qui « essaient de tout faire », LaTeX est conçu pour être *extensible*, permettant aux utilisateurs de charger des blocs de code externes (packages) qui offrent des capacités de composition plus spécialisées ou étendent les fonctionnalités intégrées de LaTeX — par exemple la composition de tableaux. Comme observé dans la section [Ajouter des images](#adding-images), la `graphicx` le package étend LaTeX en fournissant des commandes pour importer des fichiers graphiques et a été chargé (dans le préambule) en écrivant

```latex
\usepackage{graphicx}
```

### Chargement des packages

Comme indiqué ci-dessus, les packages sont chargés dans le préambule du document via la `\usepackage` commande, mais comme (de nombreux) packages LaTeX fournissent un ensemble de *options*, qui peuvent être utilisées pour configurer leur comportement, la `\usepackage` commande ressemble souvent à ceci :

```latex
\usepackage[options]{somepackage}
```

Les crochets «`[...]` » indiquent à LaTeX quel ensemble d'options doit être appliqué lorsqu'il charge `somepackage`. Au sein de l'ensemble d'options demandé par l'utilisateur, les options ou paramètres individuels sont généralement séparés par une virgule ; par exemple, le [`geometry` package](https://ctan.org/pkg/geometry) propose de nombreuses options pour configurer la mise en page dans LaTeX, donc une utilisation typique de `geometry` pourrait ressembler à ceci :

```latex
\usepackage[total={6.5in,8.75in},
top=1.2in, left=0.9in, includefoot]{geometry}
```

Le `geometry` package est un exemple de package rédigé et contribué par des membres de la communauté LaTeX mondiale et mis gratuitement à disposition de toute personne souhaitant l'utiliser.

Si un package LaTeX ne fournit aucune option, ou si l'utilisateur souhaite utiliser les valeurs par défaut des options d'un package, il serait chargé comme ceci :

```latex
\usepackage{somepackage}
```

Lorsque vous écrivez `\usepackage[...]{somepackage}` LaTeX recherche un fichier correspondant appelé `*somepackage*.sty`, qu'il doit charger et traiter — pour rendre les commandes du package disponibles et exécuter tout autre code fourni par ce package. Si LaTeX ne peut pas trouver `*somepackage*.sty` il se terminera avec une erreur, comme le montre l'exemple Overleaf suivant :

```latex
\documentclass[12pt, letterpaper]{article}
\usepackage{somepackage}% un package INEXISTANT
\begin{document}
Cela échouera !
\end{document}
```

[Ouvrez cet ***exemple générant une erreur*** sur Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=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 :

![Image montrant des erreurs causées par un package manquant](/files/3036152a42d7bfc4efedc26d1ee186864d139d54)

### Trouver des informations sur les packages : CTAN

Les packages sont distribués via le [Réseau complet d'archives TeX](https://www.ctan.org/), généralement appelé CTAN, qui, au moment de la rédaction, héberge 6 287 packages provenant de 2 881 contributeurs. CTAN [se décrit lui-même](https://www.ctan.org/ctan) comme

> ... un ensemble de sites Internet à travers le monde qui proposent du matériel lié à TeX au téléchargement.

Vous pouvez parcourir CTAN pour rechercher des packages utiles ; par exemple :

* [par sujet](https://www.ctan.org/topics/cloud)
* [par ordre alphabétique](https://www.ctan.org/pkg) (utile si vous connaissez le nom du package)

Vous pouvez aussi utiliser la [fonction de recherche](https://www.ctan.org/pkg) (en haut de la page).

### Packages disponibles sur Overleaf : présentation de TeX Live

Une fois par an, un (grand) *sous-ensemble* de packages hébergés sur CTAN, ainsi que des polices et d'autres logiciels liés à LaTeX, est regroupé et distribué sous la forme d'un système appelé [TeX Live](https://tug.org/texlive/), qui peut être utilisé pour installer votre propre configuration LaTeX (locale). En fait, [Les serveurs d'Overleaf utilisent également TeX Live](/latex/fr/fichiers-de-classe/02-overleaf-and-tex-live.md) et sont mis à jour lorsqu'une nouvelle version de TeX Live est publiée. Les mises à jour de TeX Live d'Overleaf ne sont pas immédiates, mais ont lieu quelques mois après la publication, ce qui nous laisse le temps d'effectuer des tests de compatibilité de la nouvelle version de TeX Live avec les [milliers de modèles contenus dans notre galerie](https://www.overleaf.com/gallery). Par exemple, voici notre [annonce de mise à niveau TeX Live 2025](https://www.overleaf.com/blog/tex-live-2025-is-now-available).

Bien que TeX Live contienne un (grand) *sous-ensemble* nombre de packages CTAN, il est possible de trouver un package intéressant, comme [`igo` pour composer des diagrammes de Go](https://ctan.org/pkg/igo?lang=en), qui est hébergé sur CTAN mais n'est pas inclus dans TeX Live (ni distribué par lui) et est donc indisponible sur Overleaf. Certains packages hébergés sur CTAN ne font pas partie de TeX Live pour diverses raisons : peut-être qu'un package est obsolète, a des problèmes de licence, est extrêmement récent (téléversé récemment) ou dépend de la plateforme, par exemple il fonctionne sous Windows mais pas sous Linux.

De nouveaux packages, ainsi que les mises à jour des packages existants, sont téléversés sur CTAN tout au long de l'année, mais les mises à jour de TeX Live sont distribuées annuellement ; par conséquent, les packages contenus dans la version actuelle de TeX Live ne seront pas aussi à jour que ceux hébergés sur CTAN. Comme les serveurs d'Overleaf utilisent TeX Live, il est possible que les packages installés sur nos serveurs — c'est-à-dire ceux disponibles pour nos utilisateurs — ne soient pas les toutes dernières versions disponibles sur CTAN, mais, en général, cela ne devrait pas poser de problème.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/latex/fr/bases-de-latex/01-learn-latex-in-30-minutes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
