> 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/texlive/fr/notions-de-base-de-latex/apprendre-latex-en-30-minutes.md).

# Apprendre LaTeX en 30 minutes

> **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 dont vous avez besoin 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 aurez non seulement rédigé votre premier document LaTeX, mais aussi acquis suffisamment de connaissances et de confiance pour passer aux étapes suivantes vers la maîtrise de LaTeX.

## Qu’est-ce que LaTeX ?

LaTeX (se prononce « *LAY*-tek » ou « *LAH*-tek ») est un outil de composition de documents à l’apparence professionnelle. 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 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, mis en page, 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, 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* de votre document et que 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 pour ou contre l’apprentissage de LaTeX plutôt que d’autres applications de rédaction de documents ; mais, en définitive, il s’agit d’un choix personnel fondé sur les préférences, les affinités et les exigences de la documentation.

Les arguments en faveur de LaTeX comprennent :

* la prise en charge de la composition de mathématiques extrêmement complexes, de tableaux et de contenu technique pour les sciences physiques ;
* des fonctionnalités pour les notes de bas de page, les renvois croisés et la gestion des bibliographies ;
* la facilité de 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 [paquets complémentaires gratuits](https://www.ctan.org/pkg).

Dans l’ensemble, LaTeX offre aux utilisateurs un 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 où LaTeX ne brille pas, notamment de nombreux modèles de pages « libres », que l’on trouve typiquement dans les publications de type magazine.

Un avantage important de LaTeX est la séparation du contenu du document et de 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 propose une [galerie contenant des milliers de modèles](https://www.overleaf.com/gallery), couvrant un éventail énorme de types de documents — des articles scientifiques, rapports et livres aux 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 — en créant un nouveau projet — et à commencer à écrire pour ajouter leur contenu.

## Rédiger 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 `.tex` fichier ; autrement, vous pouvez [commencer un nouveau projet dans Overleaf](broken://pages/5d3dae41cced641a296da5947f38d8af35602436).

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

```latex
\documentclass{article}
\begin{document}
Premier document. C’est un exemple simple, sans 
paramètres supplémentaires ni paquets inclus.
\end{document}
```

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

![Document d’exemple](https://images.ctfassets.net/nrgyaltdicpt/5oBbZABsWEnHZpwhfvV2PD/95ba7d5496616b4f10dffe6fb90f578a/LL30Fig1-plain.svg)

Vous pouvez voir que LaTeX a automatiquement indenté la première ligne du paragraphe, se chargeant ainsi de cette mise en forme pour vous. Examinons de plus près ce que fait 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. Différents types de documents nécessitent différentes classes ; par exemple, un CV nécessitera une classe différente de celle d’un article scientifique, qui pourrait utiliser la classe standard article de LaTeX. `article` . D’autres types de documents sur lesquels vous travaillez peuvent nécessiter des classes différentes, comme `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 du document définie, notre contenu, appelé le *corps* du document, est é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é, voir le PDF composé résultant en *recompilant le document*. Pour ce faire dans Overleaf, appuyez simplement sur **Recompiler**, comme le montre ce court extrait vidéo :

Tout projet Overleaf peut être configuré pour être recompilé automatiquement à chaque modification : cliquez sur la petite flèche à côté du **Recompiler** bouton et définissez **Compilation automatique** sur **Activé**, comme le montre la capture d’écran suivante :

![Capture d’écran montrant comment définir la compilation automatique sur Activé ou Désactivé](/files/dbad1822b5c8574746acf460784968307bbe269d)

Après avoir vu comment ajouter du contenu à notre document, l’étape suivante consiste à lui donner un titre. Pour ce faire, nous devons parler brièvement du **préambule**.

## Le préambule d’un document

La capture d’écran ci-dessus montre Overleaf en train d’enregistrer un document LaTeX sous le nom de fichier `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 figure dans votre `.tex` fichier apparaissant *avant* ce point est appelé le *préambule*, qui joue le rôle de section de « configuration » du document. Dans le préambule, vous définissez la classe (type) du document ainsi que des éléments précis tels que les langues à utiliser lors de la rédaction du document ; le chargement *des paquets* que vous souhaitez utiliser (plus d’informations à ce sujet [plus tard](#Finding%5Fand%5Fusing%5FLaTeX%5Fpackages)), et c’est là que vous appliqueriez 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 inclus entre crochets (`[...]`) et utilisés pour configurer cette instance de la classe article ; autrement dit, les réglages que nous souhaitons utiliser pour ce document `article`fondé sur cette classe.

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

* `12pt` définit la taille de la 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 spécifiée, la taille par défaut est `10pt`. Quant au format du papier, les autres valeurs possibles sont `a4paper` et `legalpaper`. Pour plus d’informations, consultez l’article sur [la taille de page et les marges](broken://pages/9d7391eed9bd8a94da484605a8ed19b8281b88aa).

La ligne de préambule

```latex
\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, lui permettant d’importer des fichiers graphiques externes. Les paquets LaTeX sont abordés dans la section [Trouver et utiliser des paquets LaTeX](#Finding%5Fand%5Fusing%5FLaTeX%5Fpackages).

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

L’ajout d’un titre, d’un auteur et d’une date à notre document nécessite trois lignes supplémentaires dans le *préambule* (*pas* le corps principal du document). Ces lignes sont :

* `\title{Mon premier document LaTeX}`: le titre du document
* `\author{Hubert Farnsworth}`: ici, vous écrivez le nom de l’auteur ou des auteurs et, éventuellement, la commande `\thanks` entre accolades :
  * `\thanks{Financé par l’équipe Overleaf.}`: 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 avec le texte contenu entre les accolades. Utile si vous devez remercier une institution dans votre article.
* `\date{août 2022}`: vous pouvez saisir la date manuellement ou utiliser la commande `\today` pour composer la date actuelle à chaque compilation du document

Une fois ces lignes ajoutées, votre préambule devrait ressembler à ceci :

```latex
\documentclass[12pt, letterpaper]{article}
\title{Mon premier document LaTeX}
\author{Hubert Farnsworth\thanks{Financé par l’équipe Overleaf.}}
\date{août 2022}
```

Pour composer le titre, l’auteur et la date, utilisez la `\maketitle` commande 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{Mon premier document LaTeX}
\author{Hubert Farnsworth\thanks{Financé par l’équipe Overleaf.}}
\date{août 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%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 :

![Image d’un document simple produit en LaTeX](https://images.ctfassets.net/nrgyaltdicpt/3WzMd0bx2zlj3zLTKS8SxT/dc2b7c16adbc96bdd750b6d2c8b4227e/LL30Fig2r-plain.svg)

## Ajout de commentaires

LaTeX est une forme de « code de programme », mais spécialisée dans la composition de documents ; par conséquent, comme pour tout code écrit dans un 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 pas composée ni n’affectera le document de quelque manière que ce soit — souvent utilisée pour ajouter des notes « à faire » ; inclure des notes explicatives ; fournir des explications dans le texte sur des macros délicates ou mettre en commentaire des lignes/sections de code LaTeX lors du débogage.

Pour faire un commentaire en LaTeX, il suffit d’écrire le `%` 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{Mon premier document LaTeX}
\author{Hubert Farnsworth\thanks{Financé par l’équipe Overleaf.}}
\date{août 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%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

Ensuite, examinons quelques commandes de mise en forme du texte :

* **Gras**: le texte en gras dans 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 illustre 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%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 :

![Image montrant du texte formaté dans un document LaTeX](https://images.ctfassets.net/nrgyaltdicpt/6vo15r0tLCByTpcvn1w2E8/8f14edc7ece1f10ce4ba2c76e1e58a56/LL30Fig3r-plain.svg)

Une autre commande très utile est `\emph{_argument_}`, dont l’effet sur son `_argument_` dépend du contexte. Dans le 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 hasard.

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

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

[Ouvrez cet **\emph** exemple 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 :

![Image démontrant l’utilisation de la commande LaTeX \emph](https://images.ctfassets.net/nrgyaltdicpt/1K0A8RXXOomakJBAr2usmp/62d0e8b5275092dd0b1b4a59c745b632/LL30Fig4r-plain.svg)

* **Remarque :** certains paquets, comme [Beamer](broken://pages/5764406a25032b4fa0336396c1be963ec2013af3), modifient le comportement de la `\emph` commande.

## Ajouter des images

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

1. Utilisez le [**Insérer une figure** bouton](https://learn.overleaf.com/learn/Kb/How%5Fto%5Finsert%5Ffigures%5Fin%5FOverleaf#Using%5FInsert%5FFigure%5Fto%5Fadd%5Fa%5Ffigure%5Fto%5Fyour%5Fproject)(![The Insert Figure button on the editor toolbar](https://sharelatex-wiki-cdn-671420.cdn77.org/learn-scripts/images/a/a8/InsertFigureButton.png)), situé dans la barre d’outils de l’éditeur, pour insérer une image dans **l’éditeur visuel** ou **l’éditeur de code**.
2. [Copiez et collez une image](broken://pages/4f774e2d37e4aefc92ae5214d576804363e4b420) dans **l’éditeur visuel** ou **l’éditeur de code**.
3. Utilisez **l’é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 nécessaire pour insérer des images, mais ici nous introduisons 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
\documentclass{article}
\usepackage{graphicx} %Paquet LaTeX pour importer des graphiques
\graphicspath{{images/}} %configuration du paquet graphicx
 
\begin{document}
L’univers est immense et il semble homogène, 
à grande échelle, partout où nous regardons.

% La commande \includegraphics est 
% fournie (implémentée) par le 
% paquet 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 :

![Illustration montrant une image importée dans un document LaTeX](https://images.ctfassets.net/nrgyaltdicpt/4p5toat08FUgehv4yuNwXS/efc9e75e4342c9caeec94f26627fa337/LL30Fig5v2-plain.svg)

L’importation de graphiques dans un document LaTeX nécessite [un module complémentaire *paquet*](#Finding%5Fand%5Fusing%5FLaTeX%5Fpackages) qui fournit les commandes et les fonctionnalités requises 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 `graphicx` paquet, 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 conservé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](https://sharelatex-wiki-cdn-671420.cdn77.org/learn-scripts/images/1/17/ImagesInAFolder.png)

La `\includegraphics{universe}` commande effectue le travail réel 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 de fichier complet, 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 amènera 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 de fichiers image vers Overleaf.

Davantage d’informations sur les paquets LaTeX se trouvent à la fin de ce tutoriel, dans la section [Trouver et utiliser des paquets LaTeX](#Finding%5Fand%5Fusing%5FLaTeX%5Fpackages).

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

Les images peuvent être légendées, étiquetées et référencées 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{Un joli graphique.}
    \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 :

![Illustration montrant l’utilisation des légendes de figure dans LaTeX](https://images.ctfassets.net/nrgyaltdicpt/4DkAWWkQqZP6QHU2EErogQ/9aa2371f2cde0f3f8bf22aa1c0b91789/LL30Fig6r-plain.svg)

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

* **`\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 le `\textwidth` commande.
* **`\caption{Un joli graphique.}`**: 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 référencer cette image dans votre document, vous lui donnez 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 à la commande suivante, 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 figure, ou similaire, afin que LaTeX puisse positionner automatiquement l’image à un emplacement approprié dans votre document.

Des indications supplémentaires figurent dans les articles d’aide Overleaf suivants :

* [Positionnement des figures](broken://pages/dd833220c372864bd4fdbbc2a7d7b47f45655500)
* [Insérer des images](https://docs.overleaf.com/writing-and-editing/inserting-images)

## Créer des listes dans LaTeX

Vous pouvez créer différents types de listes en utilisant des *environnements*, qui servent à encapsuler le code LaTeX nécessaire pour mettre en œuvre 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 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’ `itemize` environnement itemize. Chaque élément de la liste doit être précédé de 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 éléments peut être de n’importe quelle longueur.
\end{itemize}
\end{document}
```

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

![Un exemple de listes à puces dans LaTeX](https://images.ctfassets.net/nrgyaltdicpt/1lDj29Mg9ZuLNHXwZrTJew/cd7d950c65fd05b251c4aa55746f4eb7/LL30Fig7-plain.svg)

Vous pouvez aussi ouvrir ce [projet Overleaf plus large](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 illustre 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 que nous ajoutons.
\end{enumerate}
\end{document}
```

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

![Un exemple de liste numérotée produit en LaTeX](https://images.ctfassets.net/nrgyaltdicpt/2vkfa7RiAIJxv5wIZbg9UK/530c384f159d091a587de279d13fefec/LL30Fig8-plain.svg)

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 de l’étiquette de liste ordonnée numérique, en commençant à 1.

Pour plus d’informations, vous pouvez ouvrir ce [projet Overleaf plus large](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 divers types de listes LaTeX ou consulter notre [article d’aide sur les listes LaTeX](broken://pages/b5570ebf4a361cab6d0eb6d12b1ec19066a35290), qui fournit bien d’autres 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 de composition pour les mathématiques :

* *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 est exprimée 
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%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 :

![Image montrant des mathématiques composées en mode math en ligne](https://images.ctfassets.net/nrgyaltdicpt/77oK8pfew1B1VvxiBtALag/15714f2da4e469bbb8cf70a0d3733e5d/LL30Fig9-plain.svg)

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 utilisant le mode math en ligne — tout comme $E=mc^2$, et il en va de même pour \(E=mc^2\).
\end{document}
```

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

![Image montrant du contenu produit à l’aide du mode math en ligne de LaTeX](https://images.ctfassets.net/nrgyaltdicpt/46VPfEGxYJ3di18TLzaLo9/ed67df07532c52b6543fd2bae7cb7c04/LL30Fig10r-plain.svg)

### Mode math affiché

Les équations composées en mode affiché peuvent être numérotées ou non, 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. 

En 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%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 :

![Image montrant des mathématiques en mode affiché dans LaTeX](https://images.ctfassets.net/nrgyaltdicpt/6n1FPYFzmzCHPpWoEoYQZM/79b33f1096be06326bff7d2e1976c67c/LL30Fig11-plain.svg)

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 `$$ _... mathématiques affichées ici ..._$$`, mais cette méthode [n’est plus recommandée](https://texfaq.org/FAQ-dolldoll): utilisez plutôt les délimiteurs de LaTeX `\[ ... \]` à la place.

### Exemples plus complets

Les exemples suivants montrent différents types de contenu mathématique composés à l’aide de LaTeX.

```latex
\documentclass{article}
\begin{document}
Les indices en mode math sont écrits comme $a_b$ et les exposants comme $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}) \]
 
Nous écrivons les intégrales avec $\int$ et les fractions avec $\frac{a}{b}$. Les bornes sont placées sur les intégrales à l’aide d’exposants et d’indices :

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

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

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

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

![Image montrant une gamme de mathématiques composées en LaTeX](https://images.ctfassets.net/nrgyaltdicpt/5xfm4NybWckHL5ndpdnBRq/bc0b5e27044820ea5cdd11648a68f543/LL30Fig12r-plain.svg)

L’exemple suivant utilise l’ `equation*` environnement qui est fourni par le `package` amsmath

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

Pour plus d’informations sur l’utilisation de `package` voir [notre article d’aide](broken://pages/43573e7c7c22c0373f499d99b6dabe35533ec6ad).

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

Le célèbre théorème de Pythagore \(x^2 + y^2 = z^2\) a été démontré comme 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{Deuxième exemple}

Ceci est une simple expression mathématique \(\sqrt{x^2+1}\) dans le texte. 
Et ceci est aussi 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.

C’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%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 :

![Image montrant une gamme de mathématiques composées en LaTeX](https://images.ctfassets.net/nrgyaltdicpt/hT85gkewCDlxCHeNU5slE/9256c129b25bec7a93dcfe9e44b0654a/LL30Fig13r-plain.svg)

Les possibilités avec les mathématiques dans LaTeX sont infinies, alors n’hésitez pas à consulter nos pages d’aide pour obtenir des conseils et des exemples sur des sujets spécifiques :

* [Expressions mathématiques](broken://pages/1f8b2acf806cf35a2fa3cda1e39314ab243bfe45)
* [Indices et exposants](broken://pages/cc28c058611273d5324de6b50d4ceea5d8d92eaa)
* [Crochets et parenthèses](broken://pages/e8421846d4da5f7e7ebe25b7610a63e352de8230)
* [Fractions et binômes](broken://pages/02d63de3cf6ce4ca21f16805b267222655b9bab4)
* [Alignement des équations](broken://pages/38f3b2c7c8f0574de34782e8691804698c4d85c0)
* [Opérateurs](broken://pages/79328835590ea59328c2244bfe3442ead33067c3)
* [Espacement en mode math](broken://pages/200716b511cb4431735f76e337e9a00b3af8283b)
* [Intégrales, sommes et limites](broken://pages/43a9044250c8917bb4ec2eeaf069d7d6542fcb7f)
* [Style affiché en mode math](broken://pages/504976c233ff2b5cf5e09be02ad9eab76823bffc)
* [Liste des lettres grecques et des symboles mathématiques](broken://pages/367d576c0946d5c1dedae9ce85716cd62e0c9481)
* [Polices mathématiques](broken://pages/0af7932350f32e047f8317dda8e61a7a57c7655c)

## Structure de base d’un document

Ensuite, nous explorons les résumés et la manière de partitionner 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 ou arguments essentiels. L’exemple suivant montre la composition d’un résumé à l’aide de l’ `résumé` environnement :

```latex
\documentclass{article}
\begin{document}
\begin{abstract}
Ceci est un simple paragraphe 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%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 :

![Image montrant un résumé composé en LaTeX](https://images.ctfassets.net/nrgyaltdicpt/4cPu8x8ZxuDVF6efcZ03yi/91aa6aa84719613b0e25c725b70aa0b8/LL30Fig14-plain.svg)

### Paragraphes et nouvelles lignes

Une fois le résumé en place, nous pouvons commencer à écrire notre premier paragraphe. L’exemple suivant montre :

* comment un nouveau paragraphe est créé en appuyant deux fois sur la touche « entrée », ce qui met fin à la ligne en cours et insère une ligne vide suivante ;
* comment commencer une nouvelle ligne sans commencer un nouveau paragraphe en insérant un saut de ligne manuel à l’aide de la `\\` commande, qui est une double barre oblique inversée ; utilisez sinon 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 simple paragraphe 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 « entrée » 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 qui amène ce texte à commencer sur une nouvelle ligne, mais il reste partie du même paragraphe. Sinon, je peux utiliser la commande \verb|\newline|\newline pour commencer une nouvelle ligne, qui fait elle aussi partie du même paragraphe.
\end{document}
```

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

![Image montrant la création de paragraphes en LaTeX](https://images.ctfassets.net/nrgyaltdicpt/5DdSH06hFli8k4lR0dxw4m/a55cddf9aa10b64302ae7b72ba0c6447/LL30Fig15r-plain.svg)

Remarquez comment LaTeX indente automatiquement les paragraphes — sauf immédiatement après les titres de document tels que section et subsection —[comme nous le verrons](#Chapters%5Fand%5Fsections).

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

Vous trouverez plus d’informations sur les paragraphes dans les articles suivants :

* [Paragraphes et nouvelles lignes](broken://pages/b4286ec80f8a2de00689c5751a51545cda27e273)
* [Comment modifier l’espacement des paragraphes dans LaTeX](broken://pages/634bace95f859dc6742e358765d631903192f2aa)
* [Erreur LaTeX : il n’y a pas de ligne ici à finir](broken://pages/a0c712d89beb929b5fc0143ab4f2679716490038) fournit des conseils et des orientations 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, et ainsi de suite. LaTeX fournit également des commandes de structuration des documents, mais les commandes disponibles, ainsi que leurs implémentations (ce qu’elles font), peuvent dépendre de la classe de document utilisée. À titre d’exemple, les documents créés à l’aide de la `book` classe peuvent être divisés en parties, chapitres, sections, sous-sections, et ainsi de suite, mais la `classe lettre` ne fournit aucune commande (de prise en charge) pour faire cela.

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

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

\chapter{Premier chapitre}

\section{Introduction}

Ceci est 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%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 :

![Image montrant des sections dans un document book LaTeX](https://images.ctfassets.net/nrgyaltdicpt/1A1T7YsurQdM058OwmLqd8/7f6e962c31356bafa702bab9062f6061/LL30Fig16-plain.svg)

Les noms des commandes de sectionnement sont en grande partie 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 davantage divisé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 dite *avec astérisque* de la commande approprié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{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](broken://pages/52099cabe2709d57621800d72ce4d9ff8c639714) pour plus d’informations sur les commandes de structure du document.

## Créer des tableaux

Overleaf propose trois options pour créer des tableaux :

1. En utilisant le [**Insérer un tableau** bouton](https://www.overleaf.com/learn/how-to/How%5Fto%5Finsert%5Ftables%5Fin%5FOverleaf%23inserttable#Using%5FInsert%5FTable%5Fto%5Fcreate%5Fa%5Ftable%5Fin%5Fyour%5Fproject) dans la barre d’outils **l’éditeur visuel** (ou **l’éditeur de code**).
2. [Copier-coller un tableau](https://www.overleaf.com/learn/how-to/How%5Fto%5Fpaste%5Fformatted%5Fcontent%5Finto%5FOverleaf%23pastingtables) d’un autre document tout en utilisant **l’éditeur visuel**.
3. Écrire le code LaTeX du tableau dans l’éditeur de code.

Si vous débutez avec LaTeX, l’utilisation de la barre d’outils dans **l’éditeur visuel** (option 1) est une excellente façon de commencer — vous pouvez passer de **l’éditeur visuel** et **l’é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 en LaTeX, y compris l’ajout de lignes (traits) et de légendes. À mesure que vous gagnerez en expérience, jetez un œil à notre guide détaillé sur [comment créer des tableaux à l’aide de LaTeX](https://www.overleaf.com/learn/latex/Tables).

### Créer un tableau de base en 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 \\  
 cellule7 & cellule8 & cellule9    
\end{tabular}
\end{center}
```

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

![Graphique affichant un tableau composé en LaTeX](https://images.ctfassets.net/nrgyaltdicpt/5K46QavbKv9vF4RI1GbUf2/f22d4f8a06d00251166f86d2c891321e/LL30Fig17-plain.svg)

La `tabular` 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 également 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 au sein d’une ligne. Pour terminer une ligne de tableau, utilisez la *nouvelle ligne* commande `\\`. Notre tableau est contenu dans un environnement `center` afin qu’il soit centré dans la largeur de texte de la page.

### Ajouter des bordures

La `tabular` 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 outre, 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%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 :

![Graphique affichant un tableau composé en LaTeX contenant des traits horizontaux et verticaux](https://images.ctfassets.net/nrgyaltdicpt/5uWYGUhK1XJJJaWz5R1EmX/3ee88bf6b2eaf8d0644b57fa8064800b/LL30Fig18-plain.svg)

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%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 :

![Graphique affichant un tableau composé en LaTeX contenant des traits horizontaux et verticaux](https://images.ctfassets.net/nrgyaltdicpt/1Cy9FcRnDVDRUPQdCgaKq6/c21e5f7d9a53514756c6e1f2996e51e0/LL30Fig19-plain.svg)

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

Vous pouvez ajouter une légende et une référence aux tableaux de manière très similaire aux images. La seule différence est qu’au lieu de l’ **`environnement figure`** environnement, vous utilisez l’ **`table`** environnement.

Le tableau \ref{table:data} montre comment ajouter une légende à un tableau et faire une référence à un tableau.

```latex
\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 de test pour les légendes et les étiquettes.}
\label{table:data}
\end{table}
```

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

![Un tableau LaTeX avec une légende](https://images.ctfassets.net/nrgyaltdicpt/1f5w74UIaTCkpApaPdVeWf/580a87c2413ddc9d6bdef3bf462689fc/LL30Fig20-plain.svg)

## Ajouter une table des matières

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

```latex
\documentclass{article}
\title{Sections et chapitres}
\author{Gubert Farnsworth}
\date{août 2022}
\begin{document}
  
\maketitle
  
\tableofcontents

\section{Introduction}
   
Ceci est 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%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 :

![Graphique montrant une table des matières produite par LaTeX](https://images.ctfassets.net/nrgyaltdicpt/MxY592Q6EGsDKMA2mZw0t/fffa41a0a0d30770526f73aff72a7be1/LL30Fig21r-plain.svg)

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 indiqué dans l’exemple.

## Télécharger votre document terminé

Le bref clip 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 Overleaf [Exporter votre travail depuis Overleaf](https://docs.overleaf.com/managing-projects-and-files/downloading-a-project).

## Trouver et utiliser des paquets LaTeX

LaTeX ne fournit pas seulement d’importantes capacités de composition, mais offre aussi un *cadre pour l’extensibilité* par l’utilisation d’ *des paquets*extensions. 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 corps de code externes (packages) qui fournissent 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 observé dans la section [Ajouter des images](#Adding%5Fimages), le `graphicx` package

```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 (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é lors du chargement de `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 [package geometry](https://ctan.org/pkg/geometry) fournit 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}
```

La `geometry` ce package est un exemple d’un package rédigé et contribué par des membres de la communauté LaTeX mondiale et mis à disposition, gratuitement, à toute personne qui souhaite l’utiliser.

Si un package LaTeX ne propose aucune option, ou si l’utilisateur souhaite utiliser les valeurs par défaut des options d’un package, il serait chargé ainsi :

```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 s’arrêtera avec une erreur, comme le montre l’exemple Overleaf suivant :

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

[Ouvrez cet ***exemple générant une erreur*** sur 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 :

![Image montrant l’erreur causée par un package manquant](https://sharelatex-wiki-cdn-671420.cdn77.org/learn-scripts/images/6/60/LL30packagefail.png)

### Trouver des informations sur les packages : CTAN

Les packages 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 packages provenant de 2881 contributeurs. CTAN [se décrit](https://www.ctan.org/ctan) comme

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

Vous pouvez parcourir CTAN pour rechercher des packages 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 package)

Vous pouvez également 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 liées à LaTeX et d’autres logiciels, est compilé et distribué sous 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](https://www.overleaf.com/learn/latex/Overleaf%5Fand%5FTeX%5FLive) et sont mis à jour lorsqu’une nouvelle version de TeX Live est publiée. Les mises à jour 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 la mise à niveau vers 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, tel que [igo pour la composition de diagrammes de Go](https://ctan.org/pkg/igo?lang=en), qui est hébergé sur CTAN mais n’est pas inclus dans (distribué par) TeX Live 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 (récemment téléversé) ou dépend de la plateforme, par exemple fonctionne sous Windows mais pas sous Linux.

De nouveaux packages, ainsi que des mises à jour de ceux 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 chaque année ; 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, il est peu probable que cela pose 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/texlive/fr/notions-de-base-de-latex/apprendre-latex-en-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.
