技术EPUB阅读检查:目录跳转、代码、图表与公式验收

按目录、代码、图表和公式四类内容验收技术EPUB,区分包内资源检查、静态XHTML证据与真实阅读器操作,并给出可复核记录方法和三类书籍试读重点。

技术EPUB阅读检查可以按四步完成:先看目录能否跳到正确章节,再检查代码的缩进与长行,然后检查图表的标签、图注和缩放,最后核对公式的符号、上下标或分式。每一步都要区分“资源在文件中存在”和“目标阅读器实际可用”。

本文假设 EPUB 已经成功导入。仍在处理文件打开问题时,可先看EPUB怎么打开;需要理解可重排与固定版式,可参考EPUB格式说明。代码排版本身则有单独的EPUB代码高亮检查。

技术EPUB阅读检查:先做四项试读,再定位问题

读者直接从下表右列的操作开始;中列供文件制作与问题排查时核对。是否需要查看包内文件,取决于遇到的具体问题。

检查对象 包内可核对 阅读器中要操作
目录 目录文档、目标章节和位置标识是否存在 打开目录并点按,确认落点标题与位置
代码 XHTML/CSS、代码文字与缩进是否存在 改变字号或方向,检查长行、符号与折行
图表 图片/SVG 资源、引用与替代文字是否存在 查看显示与缩放,核对图例、坐标和图注
公式 辨认是 MathML、图像还是文字等表达 检查分式、上下标、断行及相邻解释

静态检查通过,只说明资源和引用关系存在;阅读器检查通过,也只说明记录中的 App、版本、设备、主题、字号和文件副本可用。两者都不能外推成所有阅读器兼容。

电子书目录跳转要同时检查资源和落点

W3C 的 EPUB 3.3把 navigation document 规定为出版物的必要组件,目录链接应解析到内容文档或其中的片段标识(fragment,用于定位章节内部的位置)。EPUB Reading Systems 3.3进一步要求合规阅读系统提供目录链接与标题访问,并在激活出版物资源链接时移动到目标位置。

规范要求与实机证据仍是两层:包内有 chapter.xhtml#section 不等于某个 App 的目录菜单已经点按成功。验收时应保存目录项名称、目标章节、实际落点、阅读器与版本,以及失败截图或错误原文。

本站原创静态样例验证了什么

本站制作了一个包含目录、两行代码、虚构 SVG 柱图和 MathML 分式的原创 EPUB 结构样例。包内共有 9 个文件、6 个资源清单(manifest)项;三个目录 href 都解析到存在的 XHTML 与 fragment。图片资源存在且 alt 非空,包内有一个 math 公式容器,相关文档在 manifest 中声明含有 MathML。

两个构造反例也被静态检查发现:一个链接指向现有章节中不存在的 fragment,另一个引用缺失的 SVG。这个结果说明检查器能发现这两类引用问题,不等于已经运行 EPUBCheck 或完成全部 EPUB 合规验证。

原创样例的目录检查记录、虚构柱图与MathML分式静态渲染
本站原创阅读检查示意:柱图使用虚构数据,分式来自自有静态XHTML渲染;实际阅读器仍需逐项复测。

六次静态点击不是 EPUB 阅读器目录测试

同一原创内容在 Chromium 156 的 360 与 800 两种宽度中,分别点击代码、图表和公式链接,共得到 6 个静态 XHTML 用例。每次都到达预期本地资源与 #id:

  • 代码保持两行,开头缩进为 0 和 4 个空格,未执行代码;
  • SVG 原图为 600×330,在两种宽度中分别显示为 320 与 600;
  • 两处分式的分子与分母矩形在两种宽度中都垂直分离。

这些结果只证明自有静态文档中的链接、资源加载与记录的几何。它们不是 EPUB 阅读器的 TOC 菜单交互、手机或原生 App 测试,也没有验证公式数学正确性、朗读、选择或无障碍符合性。W3C 的 EPUB Accessibility 1.1还有独立的内容符合性与可发现性元数据要求,不能由一张图或一个公式显示正常来代替。

阅读器兼容性测试怎样留下可复核记录

本站准备的阅读器检查模板有 13 个字段,分为四类:

  • 对象:内容类型、章节或位置;
  • 环境:阅读器 App、版本、设备、文件校验值(hash,用于确认测试的是同一份内容)、主题和字号;
  • 动作:实际执行的点按、缩放、改字号或改方向;
  • 结果:预期、观察、判定和证据。

模板已有目录、代码、图表、公式四行,但全部是 not_tested,实际阅读器观察数为 0。静态样例的数据不会预填为通过。使用真实阅读器时,App、版本、设备或文件内容版本发生变化时,应保留新的测试记录。

一本书没有某类内容时,对应项记为“不适用”;尚未操作记为“未测试”;发现明确异常再记录具体问题。不要把未测试或不适用计为测试通过。

遇到异常时,记录具体位置和表现

目录失败要记录 href、目标 fragment 与实际落点;代码失败要记录章节、首行、字号、主题和长行行为;图表失败要记录资源、图例、缩放和图注;公式失败要记录表达类型、具体符号、行列或上下标问题。这样才能区分文件资源缺失、内容样式问题与阅读器行为。

EPUB图表阅读检查:OpenCV 书先看图像与图注

Joseph Howse、Joe Minichino 合著的《学习 OpenCV 5:Python 计算机视觉(第四版)》要求基本 Python 能力,内容包含图像/视频 I/O、识别、跟踪、AR、3D 与神经网络。试读时可从图像或视频处理章节进入,依次检查:

  • 目录是否落到预期章节;
  • 大图、截图和图注是否对应;
  • 缩放后标签与细节是否可辨;
  • 图旁代码与正文解释是否保持关联。

查看《学习 OpenCV 5:Python 计算机视觉(第四版)》目录与试读

EPUB公式显示测试:先确认书中实际表达方式

Thomas Nield 的《精通统计学:面向初学者的友好指南》定位统计入门,结合统计概念、可视化、现实问题与 Python 示例。试读时应先辨认公式在该书中是文本、图像、MathML 还是其他形式,再检查符号、分式、上下标、图例和相邻文字说明。

本站原创样例使用 MathML,只能说明该自有静态样例的两处分式几何;它不能证明这本统计书采用同样表达,也不能保证目标阅读器支持选择、复制或朗读。

查看《精通统计学:面向初学者的友好指南》目录与试读

代码书再增加一轮符号与长行检查

《Rust 编程:快速、安全的系统开发(第三版)》由 Jim Blandy、Jason Orendorff、Leonora F. S. Tindall 合著,面向有系统编程经验或任意语言资深开发者。可先跳到所有权、引用或线程等代码密集章节,检查目录落点、代码块、&/*、泛型与生命周期标记、缩进和长行。

查看《Rust 编程:快速、安全的系统开发(第三版)》目录与试读

本文核对了三本授权 EPUB 的扉页或 OPF、前言与目录,没有完整通读,也没有在手机、原生 App 或商业 EPUB Reading System 中测试商品。原创实验只覆盖自有 package 静态资源检查与 Chromium XHTML 链接/几何记录;阅读器模板仍全部为未测试状态。

延伸阅读