> 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/autres-sujets/42-referencing-figures.md).

# Faire référence aux figures

En LaTeX, nous pouvons *label* des éléments numérotés (sections, formules, etc.), puis utiliser cette *label* à *référencer* à d’autres endroits, et les mêmes commandes s’appliquent également à l’environnement figure (ils sont numérotés).

## Bases des étiquettes et des références

```latex
\label{marker}
```

Le *marqueur de note* peut être vu comme un nom que nous donnons à l’objet que nous voulons référencer. Il est important d’ajouter `\label` *après* un élément numéroté, par exemple `\section`, `\subsection`, `\caption` etc., sinon l’étiquette ne « se fixera » pas sur le bon numéro ou compteur.

```latex
\ref{marker}
```

Cela affiche le numéro attribué à l’objet étiqueté par *marqueur de note*.

```latex
\pageref{marker}
```

Cela affiche le numéro de la page où l’objet étiqueté par *marqueur de note* apparaît.

## Compilation d’un document LaTeX avec des étiquettes et des références

Le *marqueur de note* utilisée pour étiqueter des objets n’est affichée nulle part dans le document, et les références correspondantes sont remplacées par les numéros appropriés. Si nous référençons un marqueur inexistant, LaTeX se compilera correctement mais avec un avertissement concernant des références indéfinies. La référence au marqueur inconnu sera remplacée par *??*.

Dans l’exemple d’Overleaf inclus ci-dessus, on peut voir que nous avons pu ajouter avec succès une référence à des figures incluses plus tard dans le document. Pour que cela soit possible, LaTeX doit être exécuté deux fois : la première exécution compile et enregistre toutes les étiquettes ainsi que leurs positions, et lors de la seconde exécution toutes les références sont remplacées par les numéros appropriés. Ainsi, nous devons compiler notre document deux fois pour voir la sortie correcte.

## Utiliser des noms parlants pour référencer des figures

Puisque nous pouvons utiliser n’importe quelle chaîne comme étiquette, il est courant d’ajouter quelques lettres à l’étiquette (comme préfixe) pour indiquer ce qui est étiqueté. Cela devient important lorsqu’un grand nombre de types d’objets différents sont référencés dans un document, car il peut être utile de se souvenir du type d’objet auquel une étiquette fait référence. De plus, cela permet aussi de référencer différents types d’objets à l’aide d’une chaîne commune.

Par exemple, si un document contient

* une section sur la population des nations,
* un tableau contenant les chiffres de population, et
* une figure contenant un diagramme en barres des tailles de population,

il peut être pratique de les référencer tous à l’aide de variantes de *population*. Cela peut être réalisé en utilisant les étiquettes

* *sec:population* pour la section,
* *tab:population* pour le tableau, et
* *fig:population* pour la figure.

Voici un exemple pour les figures -

```latex
\begin{figure}[h!]
  \includegraphics[scale=1.7]{birds.jpg}
  \caption{The birds}
  \label{fig:birds}
\end{figure}
```

Encore une fois, notez que `\label` est donné *après* `\caption`.

 [Ouvrir l'exemple dans Overleaf](https://www.overleaf.com/project/new/template/26046?id=111048636\&templateName=Example+to+cross-reference+figures\&latexEngine=pdflatex\&texImage=texlive-full%3A2022.1\&mainFile=)


---

# 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/autres-sujets/42-referencing-figures.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.