> 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/fi/taidot/saavutettavien-pdf-tiedostojen-luominen.md).

# Saavutettavien PDF-tiedostojen luominen

Ajan myötä PDF:n luomiskyvykkyyksiin tehdyt päivitykset ovat mahdollistaneet PDF:n saavutettavuuden. Edistysaskeleet, kuten [LaTeX Tagging Project](https://latex3.github.io/tagging-project/documentation/) ovat mahdollistaneet myös LaTeX-pohjaisten PDF-tiedostojen saavutettavuuden, ja parannuksia tehdään edelleen.

{% hint style="success" %}
Julkaisun [TeX Live 2025](https://www.overleaf.com/blog/tex-live-2025-is-now-available), erityisesti, on se, mikä tekee tästä prosessista mahdollisen Overleafissa. Huomaa, että **LuaLaTeX** on suositeltu kääntäjä MathML:ää käytettäessä.

Voit varmistaa, että projektisi asetukset on määritetty tämän mukaisesti, opettelemalla, miten [vaihdat kääntäjiä ja TeX Live -versioita](https://docs.overleaf.com/getting-started/recompiling-your-project/selecting-a-tex-live-version-and-latex-compiler).
{% endhint %}

Lähestymistapamme perustuu suurelta osin LaTeX Projectin [saavutettavan PDF:n ohjeisiin](https://latex3.github.io/tagging-project/documentation/usage-instructions), joihin voit tutustua saadaksesi lisätietoja seuraavista aiheista.

{% hint style="warning" %}
Huomaa, että näiden käytäntöjen toteuttaminen ei takaa, että jokainen projektisi elementti on saavutettava — katso lisätietoja tämän sivun UKK-osiosta.
{% endhint %}

### <i class="fa-tag">:tag:</i> Merkintä

PDF-merkintä on pohjimmiltaan prosessi, joka luo automaattisesti "rakenteen", jonka ruudunlukijat tunnistavat helposti ja jonka sisältöä on helpompi hakea nyt ja tulevaisuudessa. Se hyödyntää LaTeX-koodisi määrittämää olemassa olevaa rakennetta, jotta ruudunlukija voi erottaa toisistaan elementit kuten otsikot, leipätekstin, kuvat ja yhtälöt.

TeX Live 2025 tukee täysin automaattisia PDF-tageja käyttäen `\DocumentMetaData` määritteen. Lisää tämä määrite ennen `\documentclass`. Tässä määritteessä on kaksi tärkeää avainta, jotka vaikuttavat merkintäominaisuuksiin: `tagging` ja `tagging-setup` .

#### **`tagging`**

Varmista, että merkintä on käytössä asettamalla `tagging` avaimen arvoksi `on`.

<pre class="language-latex" data-overflow="wrap" data-expandable="true"><code class="lang-latex">\DocumentMetadata{<a data-footnote-ref href="#user-content-fn-1">tagging=on</a>}
</code></pre>

#### **`tagging-setup`**

Määritä, miten dokumenttisi merkitään, muuttamalla `tagging-setup` avaimen arvoa.

<pre class="language-latex" data-overflow="wrap" data-expandable="true"><code class="lang-latex">\DocumentMetadata{<a data-footnote-ref href="#user-content-fn-1">tagging=on</a>,<a data-footnote-ref href="#user-content-fn-2">tagging-setup={math/setup=mathml-SE}</a>}
</code></pre>

{% hint style="info" %}
Tässä esimerkissä käytimme \`math/setup=mathml-SE\`-arvoa MathML Structure Element -merkintään, mutta se voidaan asettaa mihin tahansa arvoon, jota \[\`\tagpdfsetup\`]\(<https://ctan.math.washington.edu/tex-archive/macros/latex/contrib/tagpdf/tagpdf.pdf>) tukee.
{% endhint %}

### <i class="fa-text-size">:text-size:</i> Kuvaukset

Automaattisen merkinnän lisäksi sinun voi myös olla tarpeen lisätä kuvailevat tiedot elementtien sisällöstä, erityisesti jos dokumentissasi on kuvia ja/tai taulukoita.

#### <i class="fa-image">:image:</i> Kuvat

Overleafissa on helppoa lisätä kuville olennaiset kuvaukset, mikä voi myös auttaa ymmärtämään tiettyjen kuvien kontekstia LaTeX-koodiin viitattaessa. Sinun tarvitsee vain lisätä vastaava kuvan kuvaus -valinta jokaisen `\includegraphics`. Saavutettavuuden kannalta on kolme päätyyppiä kuville erotettaviksi: kuvat, jotka tarvitsevat vaihtoehtoista tekstiä, artefaktit ja kuvat, jotka muunnetaan varsinaiseksi tekstiksi.

**Vaihtoehtoinen teksti**

Vaihtoehtoisen tekstin lisääminen kuviin varmistaa, että valokuvalla on kuvaus, jota voidaan käyttää tekstipohjaisena korvikkeena visuaaliselle sisällölle. Käytä `alt` avainta ja syötä tekstiarvo.

<pre class="language-latex" data-title="Vaihtoehtoisen tekstin esimerkki" data-overflow="wrap"><code class="lang-latex">\includegraphics[width=0.25\linewidth,<a data-footnote-ref href="#user-content-fn-3">alt={Makrokuva vihreän sammakon päästä ja käpälistä}</a>]{frog.jpg}
</code></pre>

**Artefaktit**

Jos kuvaa ei tarvitse lukea ruudunlukijalla (eli jos se on pelkkää koristetta), merkitse kuva artefaktiksi. Käytä `artifact` avainta ilman arvoa.

<pre class="language-latex" data-title="Artefaktin esimerkki" data-overflow="wrap"><code class="lang-latex">\includegraphics[<a data-footnote-ref href="#user-content-fn-4">artifact</a>]{.jpg}
</code></pre>

**Varsinainen teksti**

Jos kuva on pelkästään Unicode-merkin kuva, sisällytä tekstipohjainen merkki. Käytä `actualtext` avainta ja anna sille yksi merkki (ilman hakasulkeita).

<pre class="language-latex" data-title="Varsinaisen tekstin esimerkki" data-overflow="wrap"><code class="lang-latex">\includegraphics[<a data-footnote-ref href="#user-content-fn-5">actualtext=B</a>]{.jpg}
</code></pre>

#### <i class="fa-table">:table:</i> Taulukot

Vaikka taulukoihin liittyy yleensä tekstiä, on silti tärkeää, että teksti yhdistetään taulukon oikeisiin osiin. Lisää `\tagpdfsetup` ennen `tabular` tai esipuheessa aloittaaksesi Overleaf-projektisi taulukoiden määrittämisen. Saavutettavuuden kannalta taulukoista erotetaan kaksi päätyyppiä: datataulukot ja esitystaulukot.

**Datataulukot**

Jos taulukossa on vähintään yksi otsikkorivi, määritä, mitkä rivit ovat otsikkorivejä. Käytä `table/header-rows` avainta ja syötä numerosarja, joka vastaa otsikkorivien sijainteja.

<pre class="language-latex" data-title="Datataulukon esimerkki"><code class="lang-latex">\tagpdfsetup{<a data-footnote-ref href="#user-content-fn-6">table/header-rows={1}</a>}
\begin{tabular}{l|r}
Item &#x26; Quantity \\\hline
Widgets &#x26; 42 \\
Gadgets &#x26; 13
\end{tabular}
</code></pre>

**Esitystaulukot**

Jos taulukkoa ei ole tarkoitus tulkita taulukoksi ruudunlukijalla, merkitse se esitystaulukoksi. Käytä `table/tagging=presentation` avaimen arvoa.

<pre class="language-latex" data-title="Esitystaulukon esimerkki"><code class="lang-latex">\tagpdfsetup{<a data-footnote-ref href="#user-content-fn-7">table/tagging=presentation</a>}
\begin{tabular}{cc}
\textbullet &#x26; \textbullet \\
''' &#x26; '''
\end{tabular}
</code></pre>

### <i class="fa-comments-question">:comments-question:</i> UKK <a href="#faqs" id="faqs"></a>

<details>

<summary>Onko olemassa työkaluja, jotka voivat auttaa varmistamaan, että dokumenttini on saavutettava?</summary>

Kyllä, on useita ulkoisia työkaluja, kuten [veraPDF](https://verapdf.org/), joka voi validoida PDF/A-osat ja vaatimustenmukaisuustasot. Lisäksi voit käyttää työkalua kuten [WebAIM](https://webaim.org/) laskemaan kahden värin kontrastisuhteen.

</details>

<details>

<summary>Ovatko Overleaf-projektini paketit yhteensopivia näiden ominaisuuksien kanssa?</summary>

Voit tutustua LaTeX Tagging Projectin [pakettien tilaluetteloon](https://latex3.github.io/tagging-project/tagging-status/).

</details>

<details>

<summary>Voinko edelleen käyttää <code>beamer</code>? Onko esityksiä varten saatavilla muita paketteja?</summary>

Käyttöön liittyy rajoituksia `beamer`; tutustu kokeelliseen [`ltx-talk` luokkaan](https://ctan.org/pkg/ltx-talk).

</details>

<details>

<summary>Onko Overleaf-editori saavutettava?</summary>

Kyllä. Verkkosovelluksena Overleaf hyödyntää nykyaikaisten verkkoselainten saavutettavuusominaisuuksia ja toimintoja, joita saavutettavuusasiantuntijat arvioivat säännöllisesti. Viimeisin valmistunut [Voluntary Product Accessibility Template (VPAT)](https://www.overleaf.com/for/customers/vpat) osoittaa yhdenmukaisuuden Web Content Accessibility Guidelines (WCAG) 2.2 Level AA:n kanssa.

</details>

<details>

<summary>Voivatko Overleafin tuottamat PDF-tiedostot täyttää Americans with Disability Actin (ADA) Title II:n vaatimukset ja yhdenmukaistetun eurooppalaisen saavutettavuusstandardin (EN 301 549)?</summary>

Kyllä. Yhdysvalloissa ja Euroopassa voimassa oleva lainsäädäntö edellyttää, että PDF-tiedostot täyttävät WCAG 2.1 AA -vaatimukset. Jotta WCAG 2.1 AA täyttyisi, PDF:n on oltava tagattu PDF. PDF:n taggaamisen tuki on saatavilla TeX Live 2025:ssä.

</details>

<details>

<summary>Voivatko Overleafin tuottamat PDF-tiedostot täyttää PDF/UA-1-standardin?</summary>

Kyllä. LaTeX Projectin Tagging Project on suunniteltu erityisesti tuottamaan PDF/UA-1:n (ja tulevan PDF/UA-2:n) edellyttämät rakennetagit. Jos käyttäjä noudattaa LaTeX Projectin nykyisiä merkintäsuosituksia, hän rakentaa käytännössä dokumenttia, joka on "PDF/UA-ready", mikä on vahvin tapa täyttää WCAG 2.1 AA -lakivelvoite, jota Yhdysvaltain ja Euroopan lainsäädäntö edellyttää.

</details>

<details>

<summary>Miten vaihdan kääntäjäni LuaLaTeXiin?</summary>

On helppoa vaihtaa käyttämään LuaLaTeXia, LaTeXin käännösmoottoria, jota LaTeX-merkintäprojektin tiimi suosittelee. Vaikka Overleafin oletuskääntäjä on PDFLaTeX, voit [vaihtaa LuaLaTeXiin projektisi asetuksissa](https://docs.overleaf.com/getting-started/recompiling-your-project/selecting-a-tex-live-version-and-latex-compiler).

</details>

<details>

<summary>Mistä voin valita TeX Liven uusimman version?</summary>

Uusimman saat [Overleaf Labs](https://www.overleaf.com/labs/participate), joka tarjoaa pääsyn Overleafin "rolling TeX Live" -kuvaan, mukaan lukien uusimmat PDF-merkintätuen ominaisuudet. Tämä kokeellinen TeX Live -versio on ensisijaisesti tarkoitettu TeX Liven, pakettien muutosten testaamiseen ja uusien saavutettavuusominaisuuksien esikatseluun ennen kuin ne sisällytetään vuosittaiseen TeX Live -julkaisuumme.

Useimmat PDF-merkintäominaisuudet ovat käytettävissä tavallisessa [TeX Live 2025](https://www.overleaf.com/blog/tex-live-2025-is-now-available) kuvassa.

</details>

[^1]: Automaattinen merkintä on käytössä.

[^2]: Merkintäasetukset on määritetty.

[^3]: Kuvalla on vaihtoehtoinen teksti.

[^4]: Kuva on artefakti.

[^5]: Kuva on merkki.

[^6]: Taulukossa on yksi otsikkorivi.

[^7]: Taulukko on esitystaulukko.


---

# 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/fi/taidot/saavutettavien-pdf-tiedostojen-luominen.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.