创建无障碍 PDF

随着时间的推移，PDF 创建功能的更新使 PDF 可访问性成为可能。诸多进展包括 LaTeX 标记项目 也使基于 LaTeX 的 PDF 能够实现可访问性，并且改进仍在持续。

特别是，发布了 TeX Live 2025，这使得在 Overleaf 中实现该过程成为可能。请注意 LuaLaTeX 是在使用 MathML 时推荐的编译器。

您可以通过了解如何来确保项目设置已相应配置， 更改编译器和 TeX Live 版本.

我们的做法在很大程度上参考了 LaTeX 项目的 可访问 PDF 指南，您可以参考该指南了解以下主题的更多细节。

请注意，实施这些做法并不能保证项目的每个元素都可访问——有关更多信息，请参阅本页的常见问题部分。

标记（Tagging）

本质上，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}}

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

说明（Descriptions）

除了自动标记之外，您可能还需要为元素的内容添加说明，特别是当文档包含图像和/或表格时。

图像（Images）

在 Overleaf 中为图像添加重要说明很简单，这也有助于在参考 LaTeX 代码时理解某些图像的上下文。您所要做的就是在每个 \includegraphics实例中添加相关的图像说明选项。为可访问性区分图像时需要注意三种主要类型：需要替代（alt）文本的图像、作为装饰的伪元素（artifacts）以及可转换为实际文本的图像。

替代文本（Alt text）

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

替代文本示例

\includegraphics[width=0.25\linewidth,alt={一张绿色青蛙头部和双手的微距照片}]{frog.jpg}

伪元素（Artifacts）

如果图像不需要被屏幕阅读器识别（即仅为装饰），请将图像标记为伪元素。使用 artifact 键且无需分配值。

伪元素示例

\includegraphics[artifact]{.jpg}

实际文本（Actual text）

如果图像仅仅是一个 Unicode 字符的图片，则应包含该基于文本的字符。使用 actualtext 键并为其指定单个字符（不带括号）。

实际文本示例

\includegraphics[actualtext=B]{.jpg}

表格（Tables）

尽管表格通常伴有文本，但仍然重要的是将文本与表格的正确部分关联。请在您的 \tagpdfsetup 放在 tabular 之前或放在导言区，以开始为 Overleaf 项目的表格进行设置。为可访问性区分表格时有两类主要表格：数据表和呈现表。

数据表（Data tables）

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

数据表示例

\tagpdfsetup{table/header-rows={1}}
\begin{tabular}{l|r}
项目 & 数量 \\\hline
小部件 & 42 \\
小玩意 & 13
\end{tabular}

呈现表（Presentation tables）

如果表格不应被屏幕阅读器作为表格来解释，则将其标记为呈现表。使用 table/tagging=presentation 键的值来配置文档的标记方式。

呈现表示例

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

常见问题（FAQs）

是否有任何工具可以帮助验证我的文档是否可访问？

有的，有若干外部工具，包括 veraPDF，可以验证 PDF/A 的部分和符合级别。此外，您还可以使用诸如 WebAIM 之类的工具来计算两种颜色之间的对比度比率。

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

您可以参考 LaTeX 标记项目的 宏包状态列表.

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

使用 beamer存在一定的限制；请查看试验性的 ltx-talk 类（class）.

Overleaf 编辑器是否可访问？

是的。作为一个 Web 应用，Overleaf 利用现代网络浏览器的无障碍功能与特性，这些功能会定期由无障碍专家评估。我们最近完成的 自愿产品可访问性模板（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 项目的标记项目专门用于生成 PDF/UA-1（以及即将到来的 PDF/UA-2）所需的结构化标记。如果用户遵循 LaTeX 项目当前的标记建议，他们实际上是在构建一个“PDF/UA 就绪”的文档，这是满足美国和欧洲立法所要求的 WCAG 2.1 AA 法律义务的最有力方式。

如何将我的编译器切换为 LuaLaTeX？

切换到使用 LuaLaTeX 很简单，LuaLaTeX 是 LaTeX 标记项目团队推荐的 LaTeX 编译引擎。虽然 Overleaf 的默认编译器是 PDFLaTeX，您可以 在项目设置中切换到 LuaLaTeX.

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

您可以在 Overleaf 实验室（Overleaf Labs）获得最新版本，该功能提供在 Overleaf 中访问“滚动 TeX Live”映像，包括最新的 PDF 标记支持。这个试验性的 TeX Live 版本主要用于测试对 TeX Live、宏包的更改以及在这些更改被编入我们年度 TeX Live 发布之前预览新的可访问性功能。

大多数 PDF 标记功能在标准 TeX Live 2025 映像中可用。