> 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/pt/competencias/criar-pdfs-acessiveis.md).

# Criar PDFs acessíveis

Ao longo do tempo, as atualizações às capacidades de criação de PDF tornaram possível a acessibilidade de PDF. Avanços como o [Projeto de Marcação LaTeX](https://latex3.github.io/tagging-project/documentation/) tornaram também possível que os PDFs baseados em LaTeX fossem acessíveis, e continuam a ocorrer melhorias.

{% hint style="success" %}
O lançamento de [TeX Live 2025](https://www.overleaf.com/blog/tex-live-2025-is-now-available), em particular, é o que torna este processo possível no Overleaf. Note que **LuaLaTeX** é o compilador recomendado ao usar MathML.

Pode garantir que as definições do seu projeto estão configuradas em conformidade ao aprender a [alterar compiladores e versões do TeX Live](https://docs.overleaf.com/getting-started/recompiling-your-project/selecting-a-tex-live-version-and-latex-compiler).
{% endhint %}

A nossa abordagem é em grande parte informada pelas [instruções de PDF acessível](https://latex3.github.io/tagging-project/documentation/usage-instructions), às quais pode recorrer para mais detalhes sobre os tópicos seguintes.

{% hint style="warning" %}
Note que implementar estas práticas não garante que todos os elementos do seu projeto sejam acessíveis — consulte a secção de perguntas frequentes desta página para mais informações.
{% endhint %}

### <i class="fa-tag">:tag:</i> Marcação

Em essência, a marcação de PDF é um processo que cria automaticamente uma "estrutura" que é facilmente identificada pelos leitores de ecrã e é mais pesquisável tanto agora como no futuro. Tira partido da estrutura existente definida pelo seu código LaTeX para que o leitor de ecrã possa diferenciar entre elementos como cabeçalhos, texto do corpo, figuras e equações.

O TeX Live 2025 suporta totalmente etiquetas PDF automatizadas com a `\DocumentMetaData` declaração. Adicione esta declaração antes de `\documentclass`. Existem duas chaves importantes nesta declaração que afetam as capacidades de marcação: `marcação` e `tagging-setup` .

#### **`marcação`**

Certifique-se de que a marcação está ativada definindo a `marcação` chave para `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`**

Configure a forma como o seu documento é marcado alterando o valor da `tagging-setup` chave.

<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" %}
Neste exemplo, usámos \`math/setup=mathml-SE\` para marcação de Elemento de Estrutura MathML, mas pode ser definido com qualquer valor suportado por \[\`\tagpdfsetup\`]\(<https://ctan.math.washington.edu/tex-archive/macros/latex/contrib/tagpdf/tagpdf.pdf>).
{% endhint %}

### <i class="fa-text-size">:text-size:</i> Descrições

Para além da marcação automática, também poderá precisar de adicionar descrições do conteúdo dos elementos, particularmente se o seu documento contiver imagens e/ou tabelas.

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

É simples adicionar descrições vitais para imagens no Overleaf, o que também pode ajudar a compreender o contexto de certas imagens ao consultar o código LaTeX. Tudo o que tem de fazer é adicionar a opção de descrição da imagem associada em cada ocorrência de `\includegraphics`. Existem três tipos principais de imagens a distinguir para acessibilidade: imagens que requerem texto alternativo (alt), artefactos e imagens que se traduzem em texto real.

**Texto alternativo**

Adicionar texto alternativo a imagens garante que a fotografia tem uma descrição que pode ser usada como substituto textual do visual. Use a `alt` chave e introduza um valor de texto.

<pre class="language-latex" data-title="Exemplo de texto 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 da cabeça e das patas de um sapo verde}</a>]{frog.jpg}
</code></pre>

**Artefactos**

Se uma imagem não precisar de ser interpretada por um leitor de ecrã (ou seja, se for puramente decorativa), marque a imagem como um artefacto. Use a `artefacto` chave sem atribuir um valor.

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

**Texto real**

Se uma imagem for apenas uma imagem de um carácter Unicode, então inclua o carácter baseado em texto. Use a `actualtext` chave e atribua-lhe um único carácter (sem parênteses retos).

<pre class="language-latex" data-title="Exemplo de texto real" 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> Tabelas

Embora as tabelas geralmente tenham texto associado, continua a ser importante que o texto esteja associado aos aspetos corretos da tabela. Adicione `\tagpdfsetup` antes do seu `tabular` ou no preâmbulo para iniciar a configuração das tabelas do seu projeto Overleaf. Existem dois tipos principais de tabelas a distinguir para acessibilidade: tabelas de dados e tabelas de apresentação.

**Tabelas de dados**

Se uma tabela tiver pelo menos uma linha de cabeçalho, então identifique quais as linhas de cabeçalho. Use a `table/header-rows` chave e introduza uma série de números que correspondam às localizações das linhas de cabeçalho.

<pre class="language-latex" data-title="Exemplo de tabela de dados"><code class="lang-latex">\tagpdfsetup{<a data-footnote-ref href="#user-content-fn-6">table/header-rows={1}</a>}
\begin{tabular}{l|r}
Item &#x26; Quantidade \\\hline
Widgets &#x26; 42 \\
Gadgets &#x26; 13
\end{tabular}
</code></pre>

**Tabelas de apresentação**

Se uma tabela não se destinar a ser interpretada como tabela por um leitor de ecrã, então marque-a como tabela de apresentação. Use a `table/tagging=presentation` chave.

<pre class="language-latex" data-title="Exemplo de tabela de apresentação"><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> Perguntas frequentes <a href="#faqs" id="faqs"></a>

<details>

<summary>Existem ferramentas que possam ajudar a verificar se o meu documento é acessível?</summary>

Sim, existem várias ferramentas externas, incluindo [veraPDF](https://verapdf.org/), que podem validar partes e níveis de conformidade PDF/A. Além disso, pode utilizar uma ferramenta como [WebAIM](https://webaim.org/) para calcular a taxa de contraste entre duas cores.

</details>

<details>

<summary>Os pacotes no meu projeto Overleaf são compatíveis com estas funcionalidades?</summary>

Pode consultar a [lista de estado dos pacotes](https://latex3.github.io/tagging-project/tagging-status/).

</details>

<details>

<summary>do Projeto de Marcação LaTeX <code>beamer</code>Ainda posso usar o beamer? Há outros pacotes disponíveis para apresentações?</summary>

Há limitações no uso de `beamer`; consulte a experimental [`ltx-talk` classe](https://ctan.org/pkg/ltx-talk).

</details>

<details>

<summary>O editor Overleaf é acessível?</summary>

Sim. Enquanto aplicação web, o Overleaf tira partido das funcionalidades de acessibilidade dos navegadores web modernos, que são regularmente avaliados por especialistas em acessibilidade. A nossa mais recente [Voluntary Product Accessibility Template (VPAT)](https://www.overleaf.com/for/customers/vpat) mostra conformidade com as Diretrizes de Acessibilidade para o Conteúdo Web (WCAG) 2.2 Nível AA.

</details>

<details>

<summary>Os PDFs produzidos pelo Overleaf podem satisfazer os requisitos do Título II da Americans with Disability Act (ADA) e da Norma Europeia harmonizada para acessibilidade (EN 301 549)?</summary>

Sim. A legislação nos Estados Unidos e na Europa exige que os PDFs cumpram a WCAG 2.1 AA. Para cumprir a WCAG 2.1 AA, um PDF tem de ser um PDF com marcação. O suporte para marcar um PDF é fornecido no TeX Live 2025.

</details>

<details>

<summary>Os PDFs produzidos pelo Overleaf podem cumprir a norma PDF/UA-1?</summary>

Sim. O projeto de marcação do LaTeX do LaTeX Project foi concebido especificamente para produzir as etiquetas estruturais exigidas pelo PDF/UA-1 (e pelo futuro PDF/UA-2). Se um utilizador seguir as atuais recomendações de marcação do LaTeX Project, estará efetivamente a criar um documento "PDF/UA-ready", que é a forma mais robusta de cumprir o mandato legal WCAG 2.1 AA exigido pela legislação dos EUA e da Europa.

</details>

<details>

<summary>Como mudo o meu compilador para LuaLaTeX?</summary>

É fácil mudar para o uso do LuaLaTeX, o motor de compilação LaTeX recomendado pela equipa do projeto de marcação LaTeX. Embora o compilador predefinido no Overleaf seja o PDFLaTeX, pode [mudar para LuaLaTeX nas definições do seu projeto](https://docs.overleaf.com/getting-started/recompiling-your-project/selecting-a-tex-live-version-and-latex-compiler).

</details>

<details>

<summary>Onde posso selecionar a versão mais recente do TeX Live?</summary>

Pode obter a versão mais recente em [Overleaf Labs](https://www.overleaf.com/labs/participate), que fornece acesso à imagem "rolling TeX Live" no Overleaf, incluindo o suporte mais recente para marcação de PDF. Esta versão experimental do TeX Live é principalmente para testar alterações ao TeX Live, aos pacotes e para pré-visualizar novas funcionalidades de acessibilidade antes de serem compiladas na nossa versão anual do TeX Live.

A maioria das funcionalidades de marcação de PDF está disponível na [TeX Live 2025](https://www.overleaf.com/blog/tex-live-2025-is-now-available) imagem standard.

</details>

[^1]: A marcação automática está ativada.

[^2]: A configuração de marcação está definida.

[^3]: A imagem tem texto alternativo.

[^4]: A imagem é um artefacto.

[^5]: A imagem é um carácter.

[^6]: A tabela tem uma linha de cabeçalho.

[^7]: A tabela é uma tabela de apresentação.


---

# 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/pt/competencias/criar-pdfs-acessiveis.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.