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

# 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](https://latex3.github.io/tagging-project/documentation/) hanno permesso di rendere accessibili anche i PDF basati su LaTeX, e i miglioramenti continuano.

<Check>
  È in particolare il rilascio di [TeX Live 2025](https://www.overleaf.com/blog/tex-live-2025-is-now-available) 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](https://docs.overleaf.com/getting-started/recompiling-your-project/selecting-a-tex-live-version-and-latex-compiler).
</Check>

Il nostro approccio si basa in gran parte sulle [istruzioni per PDF accessibili](https://latex3.github.io/tagging-project/documentation/usage-instructions) del LaTeX Project, a cui puoi fare riferimento per maggiori dettagli sui seguenti argomenti.

<Warning>
  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.
</Warning>

### <Icon icon="tag" /> 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`.

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

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

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

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

<Info>
  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](https://ctan.math.washington.edu/tex-archive/macros/latex/contrib/tagpdf/tagpdf.pdf)).
</Info>

### <Icon icon="text-size" /> 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.

#### <Icon icon="image" /> 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.

```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}
```

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

```latex title="Artifact example" wrap theme={null}
\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).

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

#### <Icon icon="table" /> 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.

```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}
```

**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`.

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

### <Icon icon="comments-question" /> FAQ

<Accordion title="Esistono strumenti che possono aiutarmi a verificare che il mio documento sia accessibile?">
  Sì, esistono diversi strumenti esterni, tra cui [veraPDF](https://verapdf.org/), in grado di convalidare le parti e i livelli di conformità PDF/A. Inoltre, puoi usare uno strumento come [WebAIM](https://webaim.org/) per calcolare il rapporto di contrasto tra due colori.
</Accordion>

<Accordion title="I pacchetti del mio progetto Overleaf sono compatibili con queste funzionalità?">
  Puoi fare riferimento all'[elenco dello stato dei pacchetti](https://latex3.github.io/tagging-project/tagging-status/) del LaTeX Tagging Project.
</Accordion>

<Accordion title="Posso ancora usare `beamer`? Sono disponibili altri pacchetti per le presentazioni?">
  L'uso di `beamer` presenta delle limitazioni; prova la [classe `ltx-talk`](https://ctan.org/pkg/ltx-talk) sperimentale.
</Accordion>

<Accordion title="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)](https://www.overleaf.com/for/customers/vpat) completato mostra la conformità alle Web Content Accessibility Guidelines (WCAG) 2.2 livello AA.
</Accordion>

<Accordion title="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.
</Accordion>

<Accordion title="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.
</Accordion>

<Accordion title="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](https://docs.overleaf.com/getting-started/recompiling-your-project/selecting-a-tex-live-version-and-latex-compiler).
</Accordion>

<Accordion title="Dove posso selezionare la versione più recente di TeX Live?">
  Puoi ottenere le novità più recenti in [Overleaf Labs](https://www.overleaf.com/labs/participate), 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](https://www.overleaf.com/blog/tex-live-2025-is-now-available).
</Accordion>

[^1]: Il tagging automatico è abilitato.

[^2]: La configurazione del tagging è impostata.

[^3]: L'immagine ha un testo alternativo.

[^4]: L'immagine è un artefatto.

[^5]: L'immagine è un carattere.

[^6]: La tabella ha una riga di intestazione.

[^7]: La tabella è una tabella di presentazione.


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