> 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/it/altri-argomenti/42-referencing-figures.md).

# Riferimento alle figure

In LaTeX, possiamo *label* entità che sono numerate (sezioni, formule, ecc.), e poi usare quel *label* su *riferirci* ad esse altrove, e gli stessi comandi si applicano anche all'ambiente figure (sono numerati).

## Nozioni di base su etichette e riferimenti

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

Il *marcatore* può essere visto come un nome che diamo all'oggetto a cui vogliamo fare riferimento. È importante aggiungere `comando \label` *dopo* un elemento numerato, ad es. `\section`, `\subsection`, `\caption` ecc., altrimenti l'etichetta non si "aggancerà" al numero o contatore corretto.

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

Questo stampa il numero assegnato all'oggetto etichettato da *marcatore*.

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

Questo stampa il numero della pagina in cui l'oggetto etichettato da *marcatore* appare.

## Compilazione di un documento LaTeX con etichette e riferimenti

Il *marcatore* usato per etichettare gli oggetti non viene mostrato in alcun punto del documento, e i riferimenti ad esso vengono sostituiti con i numeri appropriati. Se facciamo riferimento a un marcatore inesistente, LaTeX compilerà correttamente ma con un avviso sui riferimenti non definiti. Il riferimento al marcatore sconosciuto sarà sostituito da *??*.

Nell'esempio di Overleaf incluso sopra, puoi vedere che siamo riusciti ad aggiungere correttamente riferimenti alle figure incluse nel documento in seguito. Per rendere possibile ciò, LaTeX deve essere eseguito due volte - la prima esecuzione compila e memorizza tutte le etichette e le loro posizioni, e nella seconda esecuzione tutti i riferimenti vengono sostituiti con i numeri appropriati. Pertanto, dobbiamo compilare il nostro documento due volte per vedere l'output corretto.

## Usare nomi significativi per riferirsi alle figure

Poiché possiamo usare qualsiasi stringa come etichetta, è prassi comune aggiungere alcune lettere all'etichetta (come prefisso) per indicare ciò che viene etichettato. Questo diventa importante quando in un documento vengono referenziati molti tipi diversi di oggetti, poiché può essere utile ricordare il tipo di oggetto a cui si riferisce un'etichetta. Inoltre, rende anche possibile fare riferimento a diversi tipi di oggetti usando una stringa comune.

Ad esempio, se un documento contiene

* una sezione sulla popolazione delle nazioni,
* una tabella contenente i numeri della popolazione, e
* una figura contenente un grafico a barre delle dimensioni della popolazione,

potrebbe essere conveniente riferirsi a tutti usando varianti di *popolazione*. Questo può essere fatto usando le etichette

* *sec:population* per la sezione,
* *tab:population* per la tabella, e
* *fig:population* per la figura.

Di seguito è riportato un esempio per le figure -

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

Anche in questo caso, nota che `comando \label` viene assegnato *dopo* `\caption`.

 [Apri un esempio in 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/it/altri-argomenti/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.