Saavutettavien PDF-tiedostojen luominen

Ajan myötä PDF-tiedostojen luontiominaisuuksien kehittyminen on tehnyt PDF-saavutettavuudesta mahdollista. Edistysaskeleet, kuten LaTeX Tagging Project, ovat mahdollistaneet myös LaTeX-pohjaisten PDF-tiedostojen saavutettavuuden, ja parannuksia tehdään jatkuvasti.

Erityisesti TeX Live 2025 -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.

Lähestymistapamme perustuu pitkälti LaTeX Projectin saavutettavien PDF-tiedostojen ohjeisiin, joista löydät lisätietoja seuraavista aiheista.

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.

​

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.

\DocumentMetadata{tagging=on}

​

tagging-setup

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

\DocumentMetadata{tagging=on,tagging-setup={math/setup=mathml-SE}}

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) tukee.

​

Kuvaukset

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

​

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.

Alt text example

\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.

Artifact example

\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).

Actual text example

\includegraphics[actualtext=B]{.jpg}

​

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.

Data table example

\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.

Presentation table example

\tagpdfsetup{table/tagging=presentation}
\begin{tabular}{cc}
\textbullet & \textbullet \\
''' & '''
\end{tabular}

​

Usein kysytyt kysymykset

Onko olemassa työkaluja, joilla voi varmistaa dokumenttini saavutettavuuden?

Kyllä, on useita ulkoisia työkaluja, kuten veraPDF, joilla voi validoida PDF/A-osat ja vaatimustenmukaisuustasot. Lisäksi voit käyttää esimerkiksi WebAIM-työkalua kahden värin välisen kontrastisuhteen laskemiseen.

Ovatko Overleaf-projektini paketit yhteensopivia näiden ominaisuuksien kanssa?

Voit tarkistaa asian LaTeX Tagging Projectin pakettien tilaluettelosta.

Voinko edelleen käyttää beamer-luokkaa? Onko esityksiin saatavilla muita paketteja?

beamer-luokan käytössä on rajoituksia; tutustu kokeelliseen ltx-talk-luokkaan.

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) -arviointimme osoittaa vaatimustenmukaisuuden Web Content Accessibility Guidelines (WCAG) 2.2 -ohjeiston AA-tason kanssa.

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ä.

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.

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.

Mistä voin valita uusimman TeX Live -version?

Saat uusimman version Overleaf Labsista, 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 -imagessa.