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

# Criar PDFs acessíveis

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

<Check>
  O lançamento do [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. Observe que o **LuaLaTeX** é o compilador recomendado ao usar MathML.

  Você pode garantir que as configurações do seu projeto estejam definidas corretamente aprendendo 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).
</Check>

A nossa abordagem baseia-se em grande parte nas [instruções para PDFs acessíveis](https://latex3.github.io/tagging-project/documentation/usage-instructions) do LaTeX Project, que você pode consultar para mais detalhes sobre os tópicos a seguir.

<Warning>
  Observe que aplicar estas práticas não garante que todos os elementos do seu projeto sejam acessíveis — consulte a seção de perguntas frequentes desta página para mais informações.
</Warning>

### <Icon icon="tag" /> Marcação (tagging)

Em essência, a marcação de PDF é um processo que cria automaticamente uma "estrutura" facilmente identificada por leitores de tela, e que torna o documento mais pesquisável agora e no futuro. Ela aproveita a estrutura já definida pelo seu código LaTeX para que o leitor de tela possa distinguir elementos como títulos, texto do corpo, figuras e equações.

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

#### **`tagging`**

Certifique-se de que a marcação está ativada definindo a chave `tagging` como `on`.

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

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

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

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

<Info>
  Neste exemplo, usamos \`math/setup=mathml-SE\` para a marcação de elementos de estrutura MathML, mas ela pode ser definida como qualquer valor suportado por \[\`\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" /> Descrições

Além da marcação automática, também pode ser necessário adicionar descrições do conteúdo dos elementos, especialmente se o seu documento contiver imagens e/ou tabelas.

#### <Icon icon="image" /> Imagens

É simples adicionar descrições essenciais para imagens no Overleaf, o que também pode ajudar a compreender o contexto de certas imagens ao consultar o código LaTeX. Basta adicionar a opção de descrição de imagem correspondente em cada ocorrência de `\includegraphics`. Há três tipos principais de imagens a distinguir para fins de acessibilidade: imagens que exigem texto alternativo (alt), artefatos e imagens que correspondem a texto real.

**Texto alternativo**

Adicionar texto alternativo às imagens garante que a foto tenha uma descrição que possa ser usada como substituto textual do elemento visual. Use a chave `alt` e insira um valor de texto.

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

**Artefatos**

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

```latex title="Artifact example" wrap theme={null}
\includegraphics[artifact]{.jpg}
```

**Texto real**

Se uma imagem for apenas a figura de um caractere Unicode, inclua o caractere em forma de texto. Use a chave `actualtext` e atribua-lhe um único caractere (sem chaves).

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

#### <Icon icon="table" /> Tabelas

Embora as tabelas normalmente tenham texto associado, ainda é importante que esse texto esteja associado às partes corretas da tabela. Adicione `\tagpdfsetup` antes do seu `tabular` ou no preâmbulo para iniciar a configuração das tabelas do seu projeto Overleaf. Há dois tipos principais de tabelas a distinguir para fins de acessibilidade: tabelas de dados e tabelas de apresentação.

**Tabelas de dados**

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

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

**Tabelas de apresentação**

Se uma tabela não se destinar a ser interpretada como tabela por um leitor de tela, marque-a como tabela de apresentação. Use a chave `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" /> Perguntas frequentes

<Accordion title="Existem ferramentas que ajudam a verificar se o meu documento é acessível?">
  Sim, existem várias ferramentas externas, incluindo o [veraPDF](https://verapdf.org/), que podem validar as partes e os níveis de conformidade PDF/A. Além disso, você pode usar uma ferramenta como o [WebAIM](https://webaim.org/) para calcular a taxa de contraste entre duas cores.
</Accordion>

<Accordion title="Os pacotes do meu projeto Overleaf são compatíveis com estes recursos?">
  Você pode consultar a [lista de status dos pacotes](https://latex3.github.io/tagging-project/tagging-status/) do LaTeX Tagging Project.
</Accordion>

<Accordion title="Ainda posso usar o `beamer`? Existem outros pacotes disponíveis para apresentações?">
  Há limitações no uso do `beamer`; experimente a [classe `ltx-talk`](https://ctan.org/pkg/ltx-talk), ainda experimental.
</Accordion>

<Accordion title="O editor do Overleaf é acessível?">
  Sim. Como aplicação web, o Overleaf aproveita os recursos e funcionalidades de acessibilidade dos navegadores modernos, que são avaliados regularmente por especialistas em acessibilidade. O nosso [Voluntary Product Accessibility Template (VPAT)](https://www.overleaf.com/for/customers/vpat) mais recente mostra conformidade com as Web Content Accessibility Guidelines (WCAG) 2.2 nível AA.
</Accordion>

<Accordion title="Os PDFs produzidos pelo Overleaf podem cumprir os requisitos do Título II da Americans with Disability Act (ADA) e da norma europeia harmonizada de acessibilidade (EN 301 549)?">
  Sim. A legislação dos Estados Unidos e da Europa exige que os PDFs cumpram a WCAG 2.1 AA. Para cumprir a WCAG 2.1 AA, um PDF deve ser um PDF marcado. O suporte à marcação de PDFs é fornecido no TeX Live 2025.
</Accordion>

<Accordion title="Os PDFs produzidos pelo Overleaf podem cumprir a norma PDF/UA-1?">
  Sim. O Tagging Project do LaTeX Project foi concebido especificamente para produzir as marcações estruturais exigidas pela PDF/UA-1 (e pela futura PDF/UA-2). Se um usuário seguir as recomendações atuais de marcação do LaTeX Project, estará efetivamente criando um documento "pronto para PDF/UA", que é a forma mais sólida de cumprir a exigência legal da WCAG 2.1 AA imposta pela legislação dos EUA e da Europa.
</Accordion>

<Accordion title="Como mudo o meu compilador para o LuaLaTeX?">
  É fácil passar a usar o LuaLaTeX, o mecanismo de compilação LaTeX recomendado pela equipe do LaTeX Tagging Project. Embora o compilador padrão no Overleaf seja o PDFLaTeX, você pode [mudar para o LuaLaTeX nas configurações do seu projeto](https://docs.overleaf.com/getting-started/recompiling-your-project/selecting-a-tex-live-version-and-latex-compiler).
</Accordion>

<Accordion title="Onde posso selecionar a versão mais recente do TeX Live?">
  Você pode obter a versão mais recente no [Overleaf Labs](https://www.overleaf.com/labs/participate), que dá acesso à imagem "rolling TeX Live" no Overleaf, incluindo as novidades mais recentes no suporte à marcação de PDF. Esta versão experimental do TeX Live destina-se principalmente a testar alterações no TeX Live e nos pacotes, e a pré-visualizar novos recursos de acessibilidade antes de serem incorporados na nossa versão anual do TeX Live.

  A maioria dos recursos de marcação de PDF está disponível na imagem padrão do [TeX Live 2025](https://www.overleaf.com/blog/tex-live-2025-is-now-available).
</Accordion>

[^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 artefato.

[^5]: A imagem é um caractere.

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

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


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