# 预检检查

在文档离手之前，检查源码、构建日志、PDF、参考文献、无障碍信号和提交风险。

编译成功只能证明生成了一个 PDF。它不能证明每条引用都已解析、阅读顺序合理、提交用的压缩包很干净，也不能证明文件真的具备它所声称的无障碍结构。

预检把这些问题集中到一次本地审阅中。打开项目侧边栏中的**盾牌**图标，选择适合该文档的检查项。修复某个问题时可以只运行一项检查，提交前则运行全部检查。

![Oleafly 的预检面板。选择需要的检查项，从某一行单独运行，或用底部按钮运行所有已启用的检查。](https://cdn.oleafly.com/images/screenshots/desktop/docs/preflight-checks-dark-window-v2.png#view=0,45,344,689)

![论文发出之前，用预检运行构建、投稿和无障碍检查。](https://cdn.oleafly.com/images/gifs/desktop/preflight.gif?v=2)

## 六项独立检查

### 编译与排版

读取最新的构建日志和 PDF，查找构建失败、未解析的引用和交叉引用、需要重新运行的警告、缺失的字形、溢出的盒子（overfull box）、被裁切的文字、重复的 PDF 目标以及页面尺寸不一的问题。

### 提交就绪度

对项目应用所选的出版配置。它检查文档类、摘要和关键词、图片格式、嵌入字体、PDF 限制、图注、可移植的文件名，以及源码包中的多余文件等相对稳定的要求。

### ATS 就绪度

像求职者跟踪系统（ATS）那样提取简历内容。它会报告联系方式字段、应有的章节，以及可能打乱阅读顺序的版式。

### 无障碍

检查源码和 PDF 中与以下方面有关的信号：标签、替代文本、语言和标题元数据、查看器设置、标题、表格、链接、阅读顺序、可选择的文本、有用时的书签以及过小的文字。

### 参考文献与资源

查找缺失的文件、未解析的引用和交叉引用、重复的标签和 DOI、不完整的参考文献条目，并在拿到完整项目时找出未被引用的参考文献。

### 隐私与盲审

查找凭据、私钥、敏感文件、草稿笔记、内部批注、致谢、作者字段，以及可能破坏盲审的身份元数据。

## Typst 项目

Typst 源码有专门的检查。它们直接读取你的 `.typ` 文件，因此 LaTeX 的规则不会套用到 Typst 语法上。

- **参考文献与资源**会找出没有匹配标签或参考文献条目的 `@` 引用，重复的标签，与任何项目文件都不匹配的图片或 `#include` 路径，不在项目中的 `#bibliography` 文件，以及引用了文献却从未调用 `#bibliography` 的文档。引用键可以放在 `.bib` 文件或 Hayagriva `.yml` 文件中。
- **无障碍**会标出没有 `alt` 文本的图片（无论是图片本身，还是包含它的插图）、空标题，以及没有通过 `#set document(title: ...)` 或模板设置标题的文档。
- **提交就绪度**检查项目是否导入了与所选配置相符的模板、模板是否得到摘要和关键词，以及是否残留 `#lorem` 文本、占位符或待办笔记。它还会检查图注、图片尺寸和文件名。
- **隐私与盲审**会找出传给模板的作者姓名、邮箱和单位，致谢以及本地文件路径。

每条结果都会指出文件和行号，详情中会给出 Typst 的修复方式，例如 `#image("chart.png", alt: "Bar chart of yearly sales")`。

## 不只看颜色，也要看确定程度

每条结果都会说明 Oleafly 是如何得出它的：

- **已验证**表示应用在源码、日志、项目或 PDF 中观察到了直接证据。
- **建议性**表示某个有文档依据的启发式规则发现了值得人工检查的内容。
- **需人工**指的是仅凭文件无法安全判定的检查项。

缺少输入永远不会被算作通过。在拿到最新的 PDF 之前，只基于源码的结果始终是部分结果。

## 选择出版配置

选择与投稿目标最匹配的通用出版、arXiv、IEEE、ACM、期刊或学位论文配置。配置涵盖的是足够稳定、可以自动检查的要求。在 Typst 项目中，配置还要求使用匹配的 Typst 模板，检查结果会列出它接受的模板。

之后请打开最新的投稿须知。页数限制、页边距、文件大小上限、匿名化规则和命名约定变化太频繁，通用配置无法替你判断。

## 查看另一位读者收到的内容

在预检面板中选择**屏幕阅读器**，打开**读者所见**，它会逐页提取 PDF 的文本。用它可以发现双栏论文被跨栏横向阅读、用图标字体写的电话号码丢失、图注位置不对，或某一页没有可选择的文本。

对于简历，**解析器提取的内容**会显示 ATS 模拟能够还原出的姓名、邮箱、电话、链接和标准章节。

这些视图只是证据，不能替代用你的目标读者实际使用的投稿门户、屏幕阅读器或解析器进行测试。

## PDF/UA 与无障碍：坦率的边界

Oleafly 检查 PDF/UA-1 中它能从文件里读出的那一部分。结果会引用 PDF/UA-1（PDF/UA-2 有差异时也引用它）、Matterhorn Protocol 检查点以及 WCAG 2.2 的 PDF 技术。

报告涵盖这些机器可读的信号：

- 包含真实内容的标签树；
- 图形和公式上的替代文本；
- 表格中的表头单元格；
- 标题层级的递进；
- 文档语言和 XMP 标题；
- 显示标题的查看器首选项；
- 链接描述和可疑的未加标签内容；
- 声明的 PDF/UA-1 是否有文件内容作为依据。

面板会报告 106 条可机器检查的 PDF/UA-1 规则中有多少条已验证。当某条规则无法读取或不适用时，它也会告诉你。未检查的规则不会被算作通过。

:::caution[预检不提供 PDF/UA 认证]
这是子集检查，不是合规声明。Oleafly 无法判断替代文本是否有意义、阅读顺序对人来说是否合理、颜色对比度是否足够，也无法判断文档与读者的辅助技术配合得好不好。如需正式的合规结果，请用 veraPDF 或 PAC 2024 验证最终文件，并完成人工审阅。
:::

## 从 LaTeX 准备带标签的 PDF

LaTeX 的标签功能取决于文档类、宏包、引擎和 TeX Live 版本。预检在给出准备方案之前，会检查实际生效的主文档及其加载的导言区文件。

1. 对当前 PDF 运行**无障碍**检查，并阅读检查结果。
2. 打开**无障碍导出**。
3. 查看文档类和宏包的兼容性报告。不兼容的文档类会阻止准备；部分兼容或未知的宏包会以警告显示。
4. 选择**准备无障碍导出**，并审阅每一处建议的源码改动。
5. 把每个生成的替代文本占位符替换为有意义的描述，并在被要求时补上文档标题。
6. 使用 TeX Live 2026，或 2025 年 11 月之后更新过的 TeX Live 中的 pdfLaTeX 或 LuaLaTeX 编译。无障碍数学公式需要 LuaLaTeX。
7. 再次运行无障碍检查，查看阅读视图，然后在需要合规时用 Oleafly 之外的工具验证最终的 PDF。

准备工作可以添加或更新 `\DocumentMetadata`（包含语言、PDF/UA-2 意图和标签设置）；声明第一行为表头行；为缺少替代文本的图片添加可见的占位符；并在所选引擎需要时添加 `unicode-math`。应用改动之前，它会先显示这些改动。

`\DocumentMetadata` 这一行放在版本检查之内。早于 2025 年 11 月的 LaTeX，例如内置引擎的那个，会跳过它，构建出没有标签的文档而不是失败，PDF 也不会声称符合 PDF/UA。预检随后会报告**由于此 LaTeX 版本过旧，已跳过加标签**，并指明构建所用的 LaTeX。

内置的 Tectonic 引擎无法创建标签树。**编译带标签版本并验证**会使用可用的系统 TeX 发行版或 Oleafly 管理的 TinyTeX，并且始终运行 LuaLaTeX，即使在 Tectonic 项目中也是如此。如果带标签的编译因缺少文件而停止，例如 TinyTeX 上的 `tagpdf-base.sty`，它会像普通编译一样提议安装该文件，然后再次运行带标签的编译。你也可以用自己最新的工具链编译准备好的源码。

:::note[兼容性可能成为障碍]
预检使用 LaTeX Project 发布的标签支持状态数据。不受支持的文档类会被阻止，部分支持的文档类会标上警示，数据中没有的宏包会被视为未知，而不是默认安全。`enumitem` 目前被阻止，因为它无法在带标签的工作流中加载。
:::

TinyTeX、宏包状态以及围绕系统 TeX 的安全边界，参见 [LaTeX 引擎与宏包](/docs/latex-engines/)。

## 用 Typst 生成 PDF 标准文件

Typst 项目没有需要准备的源码。Typst 自己就能写出归档用和无障碍的 PDF，所以**无障碍**检查会显示 **PDF 标准**，而不是**无障碍导出**。

1. 运行**无障碍**检查，修复缺失的替代文本和缺失的文档标题。PDF/UA-1 两者都需要。
2. 在 **PDF 标准**下选择一个**标准**，例如 PDF/UA-1 或 PDF/A-2b。
3. 选择**导出 PDF**并保存文件。
4. 需要合规时，在 Oleafly 之外验证导出的 PDF。

Typst 0.14 及更高版本会为每个 PDF 添加标签，所以没有单独的带标签编译。较旧的版本支持的标准较少，Typst 0.11 则一个也不支持；面板会说明属于哪种情况。要使用较新的版本，请在编译菜单中更改 **Typst 版本（本项目）**。参见 [Typst 项目](/docs/typst/#what-each-version-can-do)。

## 实用的最后一轮检查

1. 编译你打算提交的那份源码。
2. 运行所有相关的预检检查。
3. 修复已验证的结果，并调查建议性的结果。
4. 对照当前的投稿须知，完成每一个需人工的项目。
5. 从第一页读到最后一页，包括参考文献和附录。
6. 从保存的位置打开导出的文件和源码压缩包。
7. 在截止日期之前，使用投稿目标自带的验证工具。

预检能减少可以避免的意外。录用、无障碍和科学上的正确性，仍然需要作者、期刊或会议，以及将使用这份文档的人来把关。
