跳转到内容
Oleaflyv0.4.12

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

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

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

Oleafly 的预检面板。选择需要的检查项,从某一行单独运行,或用底部按钮运行所有已启用的检查。
Oleafly 的预检面板。选择需要的检查项,从某一行单独运行,或用底部按钮运行所有已启用的检查。 打开完整截图
论文发出之前,用预检运行构建、投稿和无障碍检查。
论文发出之前,用预检运行构建、投稿和无障碍检查。 打开完整截图

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

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

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

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

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

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

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 模拟能够还原出的姓名、邮箱、电话、链接和标准章节。

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

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

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

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

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

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,它会像普通编译一样提议安装该文件,然后再次运行带标签的编译。你也可以用自己最新的工具链编译准备好的源码。

TinyTeX、宏包状态以及围绕系统 TeX 的安全边界,参见 LaTeX 引擎与宏包。

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 项目。

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

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

图片预览

无法加载 AI 回答

请重试,或搜索文档。