> 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/fi/lisaa-aiheita/42-referencing-figures.md).

# Kuvien viittaaminen

LaTeXissa voimme *label* numeroidut kohteet (osiot, kaavat jne.) ja sitten käyttää sitä *label* kohteeseen *viitata* niihin muualla, ja samat komennot pätevät myös figure-ympäristöön (ne ovat numeroituja).

## Tunnisteiden ja viittausten perusteet

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

Se *tunnisteeksi* voidaan nähdä nimenä, jonka annamme kohteelle, johon haluamme viitata. On tärkeää lisätä `\label` *jälkeen* numeroitu elementti, esim. `\section`, `\subsection`, `\caption` jne., muuten tunniste ei "kiinnity" oikeaan numeroon tai laskuriin.

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

Tämä tulostaa numeron, joka on annettu kohteelle, jonka tunniste on *tunnisteeksi*.

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

Tämä tulostaa sivun numeron, jolla kohde, jonka tunniste on *tunnisteeksi* esiintyy.

## LaTeX-asiakirjan kokoaminen tunnisteilla ja viittauksilla

Se *tunnisteeksi* kohteiden merkitsemiseen käytettyä tunnistetta ei näytetä missään asiakirjassa, ja siihen viittaukset korvataan sopivilla numeroilla. Jos viittaamme olemattomaan tunnisteeseen, LaTeX kääntyy onnistuneesti, mutta antaa varoituksen määrittelemättömistä viittauksista. Viittaus tuntemattomaan tunnisteeseen korvataan *??*.

Yllä olevassa Overleaf-esimerkissä voit nähdä, että pystyimme onnistuneesti lisäämään viittauksen myöhemmin asiakirjaan sisällytettyihin kuviin. Jotta tämä olisi mahdollista, LaTeX on ajettava kahdesti - ensimmäinen ajo kokoaa ja tallentaa kaikki tunnisteet ja niiden sijainnit, ja toisella ajolla kaikki viittaukset korvataan sopivilla numeroilla. Siksi meidän on koottava asiakirjamme kahdesti, jotta näemme oikean tulosteen.

## Merkityksellisten nimien käyttäminen kuvien viittaamiseen

Koska voimme käyttää mitä tahansa merkkijonoa tunnisteena, on tavallista lisätä tunnisteen alkuun muutama kirjain (etuliitteeksi) osoittamaan, mitä ollaan merkitsemässä. Tämä tulee tärkeäksi, kun asiakirjassa viitataan monenlaisiin kohteisiin, sillä voi olla hyödyllistä muistaa, minkä tyyppiseen kohteeseen tunniste viittaa. Lisäksi se mahdollistaa erityyppisiin kohteisiin viittaamisen yhteisellä merkkijonolla.

Esimerkiksi, jos asiakirja sisältää

* osion kansojen väkiluvusta,
* taulukon, joka sisältää väkiluvut, ja
* kuvan, joka sisältää pylväskaavion väestömääristä,

voi olla kätevää viitata kaikkiin niihin käyttämällä muunnelmia sanasta *väestö*. Tämä voidaan toteuttaa käyttämällä tunnisteita

* *sec:population* osiolle,
* *tab:population* taulukolle, ja
* *fig:population* kuvalle.

Seuraavassa on esimerkki kuvista -

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

Huomaa jälleen, että `\label` on annettu *jälkeen* `\caption`.

&#x20;[Avaa esimerkki Overleafissa](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/fi/lisaa-aiheita/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.
