创建无障碍 PDF

随着时间推移，PDF 创建能力的不断更新使 PDF 无障碍成为可能。LaTeX Tagging Project 等方面的进展也让基于 LaTeX 的 PDF 能够实现无障碍，并且相关改进仍在持续进行。

尤其是 TeX Live 2025 的发布，使这一过程在 Overleaf 中成为可能。请注意，使用 MathML 时推荐使用 LuaLaTeX 编译器。

你可以通过了解如何更改编译器和 TeX Live 版本，确保你的项目设置正确。

我们的方法主要参考了 LaTeX Project 的无障碍 PDF 说明，你可以参阅该说明，了解以下主题的更多详情。

请注意，采用这些做法并不能保证项目中的每个元素都是无障碍的——更多信息请参阅本页的常见问题部分。

​

标签

从本质上讲，PDF 标签是一个自动创建”结构”的过程，这种结构易于屏幕阅读器识别，并且无论现在还是将来都更易于搜索。它利用 LaTeX 代码中已定义的结构，使屏幕阅读器能够区分标题、正文、图形和公式等元素。

TeX Live 2025 通过 \DocumentMetaData 声明完全支持自动 PDF 标签。请将此声明添加在 \documentclass 之前。该声明中有两个影响标签功能的重要键：tagging 和 tagging-setup。

​

tagging

将 tagging 键设置为 on，以确保启用标签功能。

\DocumentMetadata{tagging=on}

​

tagging-setup

通过更改 tagging-setup 键的值来配置文档的标签方式。

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

在本例中，我们使用 `math/setup=mathml-SE` 进行 MathML 结构元素标签，但它可以设置为 [`\tagpdfsetup`](https://ctan.math.washington.edu/tex-archive/macros/latex/contrib/tagpdf/tagpdf.pdf) 支持的任意值。

​

描述

除了自动标签之外，你可能还需要为元素内容添加描述，尤其是当文档中包含图像和/或表格时。

​

图像

在 Overleaf 中为图像添加关键描述非常简单，这在查阅 LaTeX 代码时也有助于理解某些图像的上下文。你只需在每个 \includegraphics 中添加相应的图像描述选项即可。从无障碍角度，需要区分三种主要的图像类型：需要替代（alt）文本的图像、装饰性元素（artifact），以及对应实际文本的图像。

替代文本

为图像添加替代文本可以确保图片有一段描述，可作为视觉内容的文本替代。使用 alt 键并输入文本值。

Alt text example

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

装饰性元素

如果某个图像不需要被屏幕阅读器读取（即纯粹用于装饰），请将该图像标记为装饰性元素（artifact）。使用 artifact 键，无需赋值。

Artifact example

\includegraphics[artifact]{.jpg}

实际文本

如果某个图像只是一个 Unicode 字符的图片，请包含对应的文本字符。使用 actualtext 键并为其指定单个字符（不加括号）。

Actual text example

\includegraphics[actualtext=B]{.jpg}

​

表格

虽然表格通常本身就带有文本，但确保文本与表格的正确部分相关联仍然很重要。在 tabular 之前或导言区中添加 \tagpdfsetup，开始为 Overleaf 项目中的表格进行设置。从无障碍角度，需要区分两种主要的表格类型：数据表格和展示性表格。

数据表格

如果表格至少有一个表头行，请指定哪些行是表头行。使用 table/header-rows 键，并输入一系列与表头行位置对应的数字。

Data table example

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

展示性表格

如果某个表格不应被屏幕阅读器当作表格来解读，请将其标记为展示性表格。使用 table/tagging=presentation 键。

Presentation table example

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

​

常见问题

是否有工具可以帮助验证我的文档是否无障碍？

有的，有多种外部工具，包括 veraPDF，可以验证 PDF/A 部分和一致性级别。此外，你还可以使用 WebAIM 等工具计算两种颜色之间的对比度。

我的 Overleaf 项目中的宏包是否与这些功能兼容？

你可以参阅 LaTeX Tagging Project 的宏包状态列表。

我还能使用 beamer 吗？是否有其他可用于演示文稿的宏包？

使用 beamer 存在一些限制；你可以了解一下实验性的 ltx-talk 文档类。

Overleaf 编辑器是否无障碍？

是的。作为一个 Web 应用程序，Overleaf 利用了现代 Web 浏览器的无障碍特性和功能，这些特性和功能会定期接受无障碍专家的评估。我们最新完成的自愿产品无障碍模板（VPAT）表明其符合 Web 内容无障碍指南（WCAG）2.2 AA 级标准。

Overleaf 生成的 PDF 能否满足《美国残疾人法案》（ADA）第二章以及欧洲无障碍统一标准（EN 301 549）的要求？

可以。美国和欧洲的法规要求 PDF 符合 WCAG 2.1 AA 标准。要符合 WCAG 2.1 AA，PDF 必须是带标签的 PDF。TeX Live 2025 提供了对 PDF 标签的支持。

Overleaf 生成的 PDF 能否符合 PDF/UA-1 标准？

可以。LaTeX Project 的 Tagging Project 专门用于生成 PDF/UA-1（以及即将推出的 PDF/UA-2）所需的结构标签。如果用户遵循 LaTeX Project 当前的标签建议，实际上就是在构建一个”PDF/UA-ready”的文档，这是满足美国和欧洲法规所要求的 WCAG 2.1 AA 法定要求的最有力方式。

如何将编译器切换为 LuaLaTeX？

切换到 LaTeX 标签项目团队推荐的 LaTeX 编译引擎 LuaLaTeX 非常简单。虽然 Overleaf 的默认编译器是 PDFLaTeX，但你可以在项目设置中切换为 LuaLaTeX。

在哪里可以选择最新版本的 TeX Live？

你可以在 Overleaf Labs 中获取最新版本，它提供了对 Overleaf 中”滚动 TeX Live”镜像的访问，其中包括最新的 PDF 标签支持。这个实验性的 TeX Live 版本主要用于测试 TeX Live 和宏包的更改，并在新的无障碍功能被纳入我们年度 TeX Live 发布版本之前进行预览。

大多数 PDF 标签功能都可以在标准的 TeX Live 2025 镜像中使用。