> 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/it/competenze/creare-pdf-accessibili.md).

# Creare PDF accessibili

Con il tempo, gli aggiornamenti alle funzionalità di creazione dei PDF hanno reso possibile l’accessibilità dei PDF. Progressi tra cui il [Progetto di marcatura LaTeX](https://latex3.github.io/tagging-project/documentation/) hanno reso accessibili anche i PDF basati su LaTeX, e i miglioramenti continuano a verificarsi.

{% hint style="success" %}
La pubblicazione di [TeX Live 2025](https://www.overleaf.com/blog/tex-live-2025-is-now-available), in particolare, è ciò che rende possibile questo processo in Overleaf. Nota che **LuaLaTeX** è il compilatore consigliato quando si utilizza MathML.

Puoi assicurarti che le impostazioni del tuo progetto siano configurate di conseguenza imparando come [cambiare i compilatori e le versioni di TeX Live](https://docs.overleaf.com/getting-started/recompiling-your-project/selecting-a-tex-live-version-and-latex-compiler).
{% endhint %}

Il nostro approccio è in gran parte informato dalle [istruzioni per PDF accessibili](https://latex3.github.io/tagging-project/documentation/usage-instructions), che puoi consultare per maggiori dettagli sui seguenti argomenti.

{% hint style="warning" %}
Nota che l'implementazione di queste pratiche non garantisce che ogni elemento del tuo progetto sia accessibile—vedi la sezione FAQ di questa pagina per maggiori informazioni.
{% endhint %}

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

In sostanza, la marcatura PDF è un processo che crea automaticamente una "struttura" facilmente identificabile dai lettori di schermo, ed è più ricercabile sia ora sia in futuro. Sfrutta la struttura esistente definita dal tuo codice LaTeX, così il lettore di schermo può distinguere tra elementi come intestazioni, testo del corpo, figure ed equazioni.

TeX Live 2025 supporta pienamente i tag PDF automatizzati con la `\DocumentMetaData` dichiarazione. Aggiungi questa dichiarazione prima di `\documentclass`. Ci sono due chiavi importanti per questa dichiarazione che influenzano le capacità di marcatura: `tagging` e `tagging-setup` .

#### **`tagging`**

Assicurati che la marcatura sia abilitata impostando la chiave `tagging` su `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`**

Configura come viene marcato il tuo documento cambiando il valore della chiave `tagging-setup` .

<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" %}
In questo esempio, abbiamo usato \`math/setup=mathml-SE\` per la marcatura degli elementi strutturali MathML, ma può essere impostato su qualsiasi valore supportato da \[\`\tagpdfsetup\`]\(<https://ctan.math.washington.edu/tex-archive/macros/latex/contrib/tagpdf/tagpdf.pdf>).
{% endhint %}

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

Oltre alla marcatura automatica, potresti anche dover aggiungere descrizioni del contenuto degli elementi, in particolare se il tuo documento contiene immagini e/o tabelle.

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

È semplice aggiungere descrizioni essenziali per le immagini in Overleaf, il che può anche aiutare a comprendere il contesto di certe immagini quando si fa riferimento al codice LaTeX. Tutto ciò che devi fare è aggiungere l'opzione di descrizione dell'immagine associata in ogni istanza di `\includegraphics`. Esistono tre tipi principali di immagini da distinguere per l'accessibilità: immagini che richiedono testo alternativo (alt), artefatti e immagini che si traducono in testo reale.

**Testo alternativo**

Aggiungere testo alternativo alle immagini garantisce che la foto abbia una descrizione che può essere usata come sostituto testuale del contenuto visivo. Usa la chiave `alt` e inserisci un valore testuale.

<pre class="language-latex" data-title="Esempio di testo alternativo" data-overflow="wrap"><code class="lang-latex">\includegraphics[width=0.25\linewidth,<a data-footnote-ref href="#user-content-fn-3">alt={Foto macro della testa e delle zampe di una rana verde}</a>]{frog.jpg}
</code></pre>

**Artefatti**

Se un'immagine non deve essere rilevata da un lettore di schermo (cioè se è puramente decorativa), contrassegna l'immagine come artefatto. Usa la chiave `artifact` senza assegnare un valore.

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

**Testo reale**

Se un'immagine è solo una rappresentazione di un carattere Unicode, allora includi il carattere testuale. Usa la chiave `actualtext` e assegnale un singolo carattere (senza parentesi quadre).

<pre class="language-latex" data-title="Esempio di testo reale" 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> Tabelle

Sebbene le tabelle abbiano solitamente del testo associato, è comunque importante che il testo sia associato agli aspetti corretti della tabella. Aggiungi `\tagpdfsetup` prima del tuo `tabular` oppure nel preambolo per iniziare la configurazione delle tabelle del tuo progetto Overleaf. Esistono due tipi principali di tabelle da distinguere per l'accessibilità: tabelle di dati e tabelle di presentazione.

**Tabelle di dati**

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

<pre class="language-latex" data-title="Esempio di tabella di dati"><code class="lang-latex">\tagpdfsetup{<a data-footnote-ref href="#user-content-fn-6">table/header-rows={1}</a>}
\begin{tabular}{l|r}
Articolo &#x26; Quantità \\\hline
Widget &#x26; 42 \\
Gadget &#x26; 13
\end{tabular}
</code></pre>

**Tabelle di presentazione**

Se una tabella non deve essere interpretata come tabella da un lettore di schermo, allora contrassegnala come tabella di presentazione. Usa la chiave `table/tagging=presentation` .

<pre class="language-latex" data-title="Esempio di tabella di presentazione"><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> FAQ <a href="#faqs" id="faqs"></a>

<details>

<summary>Ci sono strumenti che possano aiutare a verificare che il mio documento sia accessibile?</summary>

Sì, ci sono diversi strumenti esterni, tra cui [veraPDF](https://verapdf.org/), che possono convalidare le parti PDF/A e i livelli di conformità. Inoltre, puoi usare uno strumento come [WebAIM](https://webaim.org/) per calcolare il rapporto di contrasto tra due colori.

</details>

<details>

<summary>I pacchetti del mio progetto Overleaf sono compatibili con queste funzionalità?</summary>

Puoi fare riferimento alla [lista di stato dei pacchetti](https://latex3.github.io/tagging-project/tagging-status/).

</details>

<details>

<summary>Posso ancora usare <code>beamer</code>? Ci sono altri pacchetti disponibili per le presentazioni?</summary>

Ci sono limitazioni nell'uso di `beamer`; consulta la classe sperimentale [`ltx-talk` class](https://ctan.org/pkg/ltx-talk).

</details>

<details>

<summary>L'editor di Overleaf è accessibile?</summary>

Sì. Come applicazione web, Overleaf sfrutta le funzionalità di accessibilità e i sistemi dei browser web moderni, che vengono regolarmente valutati da esperti di accessibilità. Il nostro più recente [Voluntary Product Accessibility Template (VPAT)](https://www.overleaf.com/for/customers/vpat) completato mostra la conformità con le Web Content Accessibility Guidelines (WCAG) 2.2 livello AA.

</details>

<details>

<summary>I PDF prodotti da Overleaf possono soddisfare i requisiti del Titolo II dell'Americans with Disability Act (ADA) e della norma europea armonizzata per l'accessibilità (EN 301 549)?</summary>

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

</details>

<details>

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

Sì. Il progetto di marcatura del LaTeX Project è progettato specificamente per produrre i tag strutturali richiesti da PDF/UA-1 (e dal prossimo PDF/UA-2). Se un utente segue le attuali raccomandazioni di marcatura del LaTeX Project, sta di fatto costruendo un documento "pronto per PDF/UA", che è il modo più solido per soddisfare il mandato legale WCAG 2.1 AA richiesto dalla legislazione statunitense ed europea.

</details>

<details>

<summary>Come faccio a cambiare il compilatore in LuaLaTeX?</summary>

È facile passare all'uso di LuaLaTeX, il motore di compilazione LaTeX consigliato dal team del progetto di marcatura LaTeX. Sebbene il compilatore predefinito in Overleaf sia PDFLaTeX, puoi [passare a LuaLaTeX nelle impostazioni del tuo progetto](https://docs.overleaf.com/getting-started/recompiling-your-project/selecting-a-tex-live-version-and-latex-compiler).

</details>

<details>

<summary>Dove posso selezionare la versione più recente di TeX Live?</summary>

Puoi ottenere l'ultima in [Overleaf Labs](https://www.overleaf.com/labs/participate), che fornisce accesso all'immagine "rolling TeX Live" in Overleaf, inclusi i più recenti supporti per la marcatura PDF. Questa versione sperimentale di TeX Live è principalmente destinata a testare le modifiche a TeX Live, ai pacchetti e a visualizzare in anteprima le nuove funzionalità di accessibilità prima che vengano integrate nella nostra versione annuale di TeX Live.

La maggior parte delle funzionalità di marcatura PDF è disponibile nell' [TeX Live 2025](https://www.overleaf.com/blog/tex-live-2025-is-now-available) immagine standard.

</details>

[^1]: La marcatura automatica è abilitata.

[^2]: La configurazione della marcatura è impostata.

[^3]: L'immagine ha 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.


---

# 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/it/competenze/creare-pdf-accessibili.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.