> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Saavutettavien PDF-tiedostojen luominen

Ajan myötä PDF-tiedostojen luontiominaisuuksien kehittyminen on tehnyt PDF-saavutettavuudesta mahdollista. 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 jatkuvasti.

<Check>
  Erityisesti [TeX Live 2025](https://www.overleaf.com/blog/tex-live-2025-is-now-available) -julkaisu tekee tämän prosessin mahdolliseksi Overleafissa. Huomaa, että **LuaLaTeX** on suositeltu kääntäjä MathML:ää käytettäessä.

  Voit varmistaa, että projektisi asetukset ovat kunnossa, opettelemalla [vaihtamaan kääntäjää ja TeX Live -versiota](https://docs.overleaf.com/getting-started/recompiling-your-project/selecting-a-tex-live-version-and-latex-compiler).
</Check>

Lähestymistapamme perustuu pitkälti LaTeX Projectin [saavutettavien PDF-tiedostojen ohjeisiin](https://latex3.github.io/tagging-project/documentation/usage-instructions), joista löydät lisätietoja seuraavista aiheista.

<Warning>
  Huomaa, että näiden käytäntöjen noudattaminen ei takaa, että projektisi jokainen elementti on saavutettava — katso lisätietoja tämän sivun Usein kysytyt kysymykset -osiosta.
</Warning>

### <Icon icon="tag" /> Tagitus

Pohjimmiltaan PDF-tagitus on prosessi, joka luo automaattisesti "rakenteen", jonka ruudunlukijat tunnistavat helposti ja joka tekee sisällöstä paremmin haettavaa nyt ja tulevaisuudessa. Se hyödyntää LaTeX-koodisi jo määrittämää 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 `\DocumentMetaData`-määrittelyn avulla. Lisää tämä määrittely ennen komentoa `\documentclass`. Määrittelyssä on kaksi tärkeää avainta, jotka vaikuttavat tagitusominaisuuksiin: `tagging` ja `tagging-setup` .

#### **`tagging`**

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

```latex wrap expandable theme={null}
\DocumentMetadata{tagging=on}
```

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

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

```latex wrap expandable theme={null}
\DocumentMetadata{tagging=on,tagging-setup={math/setup=mathml-SE}}
```

<Info>
  Tässä esimerkissä käytimme arvoa \`math/setup=mathml-SE\` MathML-rakenne-elementtien (Structure Element) tagitukseen, mutta arvoksi voidaan asettaa mikä tahansa arvo, jota \[\`\tagpdfsetup\`]\([https://ctan.math.washington.edu/tex-archive/macros/latex/contrib/tagpdf/tagpdf.pdf](https://ctan.math.washington.edu/tex-archive/macros/latex/contrib/tagpdf/tagpdf.pdf)) tukee.
</Info>

### <Icon icon="text-size" /> Kuvaukset

Automaattisen tagituksen lisäksi saatat joutua lisäämään kuvauksia elementtien sisällöstä, erityisesti jos dokumenttisi sisältää kuvia ja/tai taulukoita.

#### <Icon icon="image" /> Kuvat

Tärkeiden kuvausten lisääminen kuville on Overleafissa helppoa, ja ne voivat myös auttaa ymmärtämään tiettyjen kuvien asiayhteyden LaTeX-koodia luettaessa. Sinun tarvitsee vain lisätä kyseinen kuvauksen asetus jokaiseen `\includegraphics`-komentoon. Saavutettavuuden kannalta kuvat jaetaan kolmeen päätyyppiin: kuvat, jotka tarvitsevat vaihtoehtoisen tekstin (alt-tekstin), artefaktit sekä kuvat, jotka vastaavat varsinaista tekstiä.

**Alt-teksti**

Vaihtoehtoisen tekstin lisääminen kuviin varmistaa, että kuvalla on kuvaus, jota voidaan käyttää visuaalisen sisällön tekstipohjaisena korvikkeena. Käytä `alt`-avainta ja anna sille tekstiarvo.

```latex title="Alt text example" wrap theme={null}
\includegraphics[width=0.25\linewidth,alt={Macro photo of a green frog's head and hands}]{frog.jpg}
```

**Artefaktit**

Jos ruudunlukijan ei tarvitse huomioida kuvaa (eli jos se on pelkkä koriste), merkitse kuva artefaktiksi. Käytä `artifact`-avainta antamatta sille arvoa.

```latex title="Artifact example" wrap theme={null}
\includegraphics[artifact]{.jpg}
```

**Varsinainen teksti**

Jos kuva esittää pelkästään Unicode-merkkiä, lisää tekstipohjainen merkki. Käytä `actualtext`-avainta ja anna sille yksi merkki (ilman sulkeita).

```latex title="Actual text example" wrap theme={null}
\includegraphics[actualtext=B]{.jpg}
```

#### <Icon icon="table" /> Taulukot

Vaikka taulukoihin yleensä liittyy tekstiä, on silti tärkeää, että teksti liitetään taulukon oikeisiin osiin. Lisää `\tagpdfsetup` ennen `tabular`-ympäristöä tai johdanto-osaan (preamble) aloittaaksesi Overleaf-projektisi taulukoiden määrittämisen. Saavutettavuuden kannalta taulukot jaetaan kahteen päätyyppiin: 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 anna sille sarja numeroita, jotka vastaavat otsikkorivien sijainteja.

```latex title="Data table example" theme={null}
\tagpdfsetup{table/header-rows={1}}
\begin{tabular}{l|r}
Item & Quantity \\\hline
Widgets & 42 \\
Gadgets & 13
\end{tabular}
```

**Esitystaulukot**

Jos ruudunlukijan ei ole tarkoitus tulkita taulukkoa taulukkona, merkitse se esitystaulukoksi. Käytä avainta `table/tagging=presentation`.

```latex title="Presentation table example" theme={null}
\tagpdfsetup{table/tagging=presentation}
\begin{tabular}{cc}
\textbullet & \textbullet \\
''' & '''
\end{tabular}
```

### <Icon icon="comments-question" /> Usein kysytyt kysymykset

<Accordion title="Onko olemassa työkaluja, joilla voi varmistaa dokumenttini saavutettavuuden?">
  Kyllä, on useita ulkoisia työkaluja, kuten [veraPDF](https://verapdf.org/), joilla voi validoida PDF/A-osat ja vaatimustenmukaisuustasot. Lisäksi voit käyttää esimerkiksi [WebAIM](https://webaim.org/)-työkalua kahden värin välisen kontrastisuhteen laskemiseen.
</Accordion>

<Accordion title="Ovatko Overleaf-projektini paketit yhteensopivia näiden ominaisuuksien kanssa?">
  Voit tarkistaa asian LaTeX Tagging Projectin [pakettien tilaluettelosta](https://latex3.github.io/tagging-project/tagging-status/).
</Accordion>

<Accordion title="Voinko edelleen käyttää `beamer`-luokkaa? Onko esityksiin saatavilla muita paketteja?">
  `beamer`-luokan käytössä on rajoituksia; tutustu kokeelliseen [`ltx-talk`-luokkaan](https://ctan.org/pkg/ltx-talk).
</Accordion>

<Accordion title="Onko Overleaf-editori saavutettava?">
  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) -arviointimme osoittaa vaatimustenmukaisuuden Web Content Accessibility Guidelines (WCAG) 2.2 -ohjeiston AA-tason kanssa.
</Accordion>

<Accordion title="Voivatko Overleafilla tuotetut PDF-tiedostot täyttää Americans with Disability Act (ADA) -lain II osaston ja eurooppalaisen yhdenmukaistetun saavutettavuusstandardin (EN 301 549) vaatimukset?">
  Kyllä. Yhdysvaltojen ja Euroopan lainsäädäntö edellyttää, että PDF-tiedostot täyttävät WCAG 2.1 AA -tason. WCAG 2.1 AA -tason täyttääkseen PDF-tiedoston on oltava tagitettu PDF. PDF-tiedostojen tagitusta tuetaan TeX Live 2025:ssä.
</Accordion>

<Accordion title="Voivatko Overleafilla tuotetut PDF-tiedostot täyttää PDF/UA-1-standardin?">
  Kyllä. LaTeX Projectin Tagging Project on suunniteltu nimenomaan tuottamaan PDF/UA-1-standardin (ja tulevan PDF/UA-2:n) edellyttämät rakennetagit. Jos käyttäjä noudattaa LaTeX Projectin nykyisiä tagitussuosituksia, hän käytännössä rakentaa "PDF/UA-valmiin" dokumentin, mikä on vahvin tapa täyttää Yhdysvaltojen ja Euroopan lainsäädännön edellyttämä WCAG 2.1 AA -vaatimus.
</Accordion>

<Accordion title="Miten vaihdan kääntäjäksi LuaLaTeXin?">
  LuaLaTeXiin, LaTeX tagging project -tiimin suosittelemaan LaTeX-käännösmoottoriin, on helppo vaihtaa. 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).
</Accordion>

<Accordion title="Mistä voin valita uusimman TeX Live -version?">
  Saat uusimman version [Overleaf Labsista](https://www.overleaf.com/labs/participate), joka tarjoaa pääsyn Overleafin "rolling TeX Live" -imageen, mukaan lukien uusimman PDF-tagitustuen. Tämä kokeellinen TeX Live -versio on tarkoitettu ensisijaisesti TeX Liven ja pakettien muutosten testaamiseen sekä uusien saavutettavuusominaisuuksien esikatseluun ennen kuin ne sisällytetään vuosittaiseen TeX Live -julkaisuumme.

  Useimmat PDF-tagitusominaisuudet ovat saatavilla tavallisessa [TeX Live 2025](https://www.overleaf.com/blog/tex-live-2025-is-now-available) -imagessa.
</Accordion>

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

[^2]: Tagituksen määritys on asetettu.

[^3]: Kuvalla on vaihtoehtoinen teksti.

[^4]: Kuva on artefakti.

[^5]: Kuva on merkki.

[^6]: Taulukossa on yksi otsikkorivi.

[^7]: Taulukko on esitystaulukko.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.