Creare PDF accessibili

Nel tempo, gli aggiornamenti delle funzionalità di creazione dei PDF hanno reso possibile l’accessibilità dei PDF. Progressi come il LaTeX Tagging Project hanno permesso di rendere accessibili anche i PDF basati su LaTeX, e i miglioramenti continuano.

È in particolare il rilascio di TeX Live 2025 a rendere possibile questo processo in Overleaf. Tieni presente che LuaLaTeX è il compilatore consigliato quando si utilizza MathML.

Puoi assicurarti che le impostazioni del tuo progetto siano configurate di conseguenza imparando a cambiare compilatore e versione di TeX Live.

Il nostro approccio si basa in gran parte sulle istruzioni per PDF accessibili del LaTeX Project, a cui puoi fare riferimento per maggiori dettagli sui seguenti argomenti.

Tieni presente che l’applicazione di queste pratiche non garantisce che ogni elemento del tuo progetto sia accessibile: consulta la sezione FAQ di questa pagina per ulteriori informazioni.

​

Tagging

In sostanza, il tagging dei PDF è un processo che crea automaticamente una “struttura” facilmente identificabile dagli screen reader e più ricercabile, sia ora sia in futuro. Sfrutta la struttura esistente definita dal tuo codice LaTeX, in modo che lo screen reader possa distinguere tra elementi come intestazioni, testo del corpo, figure ed equazioni.

TeX Live 2025 supporta pienamente i tag PDF automatici con la dichiarazione \DocumentMetaData. Aggiungi questa dichiarazione prima di \documentclass. Ci sono due chiavi importanti di questa dichiarazione che influiscono sulle capacità di tagging: tagging e tagging-setup .

​

tagging

Assicurati che il tagging sia abilitato impostando la chiave tagging su on.

\DocumentMetadata{tagging=on}

​

tagging-setup

Configura il modo in cui il tuo documento viene taggato modificando il valore della chiave tagging-setup.

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

In questo esempio abbiamo usato `math/setup=mathml-SE` per il tagging MathML Structure Element, ma può essere impostato su qualsiasi valore supportato da [`\tagpdfsetup`](https://ctan.math.washington.edu/tex-archive/macros/latex/contrib/tagpdf/tagpdf.pdf).

​

Descrizioni

Oltre al tagging automatico, potrebbe essere necessario aggiungere anche descrizioni del contenuto degli elementi, in particolare se il tuo documento contiene immagini e/o tabelle.

​

Immagini

Aggiungere descrizioni fondamentali per le immagini in Overleaf è semplice, e può anche aiutare a comprendere il contesto di determinate immagini quando si consulta il codice LaTeX. Tutto ciò che devi fare è aggiungere l’opzione di descrizione dell’immagine corrispondente in ogni istanza di \includegraphics. Ai fini dell’accessibilità si distinguono tre tipi principali di immagini: immagini che richiedono un testo alternativo (alt), artefatti e immagini che corrispondono a testo effettivo.

Testo alternativo

L’aggiunta di un testo alternativo alle immagini garantisce che la foto abbia una descrizione utilizzabile come sostituto testuale dell’elemento visivo. Usa la chiave alt e inserisci un valore di testo.

Alt text example

\includegraphics[width=0.25\linewidth,alt={Macro photo of a green frog's head and hands}]{frog.jpg}

Artefatti

Se un’immagine non deve essere rilevata da uno screen reader (ad es. se è puramente decorativa), contrassegnala come artefatto. Usa la chiave artifact senza assegnarle un valore.

Artifact example

\includegraphics[artifact]{.jpg}

Testo effettivo

Se un’immagine è soltanto la raffigurazione di un carattere Unicode, includi il carattere in forma testuale. Usa la chiave actualtext e assegnale un singolo carattere (senza parentesi).

Actual text example

\includegraphics[actualtext=B]{.jpg}

​

Tabelle

Sebbene alle tabelle sia solitamente associato del testo, è comunque importante che il testo sia associato agli aspetti corretti della tabella. Aggiungi \tagpdfsetup prima del tuo tabular o nel preambolo per iniziare la configurazione delle tabelle del tuo progetto Overleaf. Ai fini dell’accessibilità si distinguono due tipi principali di tabelle: tabelle di dati e tabelle di presentazione.

Tabelle di dati

Se una tabella ha almeno una riga di intestazione, indica quali righe sono righe di intestazione. Usa la chiave table/header-rows e inserisci una serie di numeri corrispondenti alle posizioni delle righe di intestazione.

Data table example

\tagpdfsetup{table/header-rows={1}}
\begin{tabular}{l|r}
Item & Quantity \\\hline
Widgets & 42 \\
Gadgets & 13
\end{tabular}

Tabelle di presentazione

Se una tabella non deve essere interpretata come tale da uno screen reader, contrassegnala come tabella di presentazione. Usa la chiave table/tagging=presentation.

Presentation table example

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

​

FAQ

Esistono strumenti che possono aiutarmi a verificare che il mio documento sia accessibile?

Sì, esistono diversi strumenti esterni, tra cui veraPDF, in grado di convalidare le parti e i livelli di conformità PDF/A. Inoltre, puoi usare uno strumento come WebAIM per calcolare il rapporto di contrasto tra due colori.

I pacchetti del mio progetto Overleaf sono compatibili con queste funzionalità?

Puoi fare riferimento all’elenco dello stato dei pacchetti del LaTeX Tagging Project.

Posso ancora usare beamer? Sono disponibili altri pacchetti per le presentazioni?

L’uso di beamer presenta delle limitazioni; prova la classe ltx-talk sperimentale.

L'editor di Overleaf è accessibile?

Sì. In quanto applicazione web, Overleaf sfrutta le funzionalità di accessibilità dei browser web moderni, che vengono regolarmente valutate da esperti di accessibilità. Il nostro più recente Voluntary Product Accessibility Template (VPAT) completato mostra la conformità alle Web Content Accessibility Guidelines (WCAG) 2.2 livello AA.

I PDF prodotti da Overleaf possono soddisfare i requisiti del Titolo II dell'Americans with Disability Act (ADA) e dello standard europeo armonizzato per l'accessibilità (EN 301 549)?

Sì. La legislazione negli Stati Uniti e in Europa richiede che i PDF soddisfino le WCAG 2.1 AA. Per soddisfare le WCAG 2.1 AA, un PDF deve essere un PDF taggato. Il supporto per il tagging dei PDF è fornito in TeX Live 2025.

I PDF prodotti da Overleaf possono soddisfare lo standard PDF/UA-1?

Sì. Il Tagging Project del LaTeX Project è progettato specificamente per produrre i tag strutturali richiesti da PDF/UA-1 (e dal futuro PDF/UA-2). Se un utente segue le attuali raccomandazioni di tagging del LaTeX Project, sta di fatto creando un documento “PDF/UA-ready”, che è il modo più efficace per soddisfare l’obbligo legale WCAG 2.1 AA previsto dalla legislazione statunitense ed europea.

Come posso passare al compilatore LuaLaTeX?

Passare a LuaLaTeX, il motore di compilazione LaTeX consigliato dal team del LaTeX Tagging Project, è facile. Sebbene il compilatore predefinito in Overleaf sia PDFLaTeX, puoi passare a LuaLaTeX nelle impostazioni del progetto.

Dove posso selezionare la versione più recente di TeX Live?

Puoi ottenere le novità più recenti in Overleaf Labs, che dà accesso all’immagine “rolling TeX Live” in Overleaf, compreso il supporto più aggiornato per il tagging dei PDF. Questa versione sperimentale di TeX Live serve principalmente per testare le modifiche a TeX Live e ai pacchetti e per avere un’anteprima delle nuove funzionalità di accessibilità prima che vengano incluse nella nostra release annuale di TeX Live.

La maggior parte delle funzionalità di tagging dei PDF è disponibile nell’immagine standard di TeX Live 2025.