如何修复推送失败的 EPUB 格式电子书文件
书伴BookFere
Posted on
前不久，亚马逊 Kindle 个人文档服务已原生支持推送 EPUB 格式，但是很多小伙伴在尝试推送后反馈，有个别的 EPUB 格式电子书文件无法成功推送，会收到如下所示的系统退信。
书伴从几位小伙伴那里收集到一些推送失败的 EPUB 文件，并做了一些测试以找出这些“问题文件”的共通之处，发现这些问题可以通过较为便捷的方式解决，现将解决方法分享如下。
一、问题分析
亚马逊的个人文档服务对推送的 EPUB 文件有较强的容错机制，即便有些内容不符合 EPUB 规范，一般情况下也能被正常处理，但是唯独对 EPUB 2.0 的导航控制文件 toc.ncx 及 EPUB 3.0 的导航文档 nav.xhtml 比较敏感，如果这两个文件存在“错误”，就会大概率导致推送失败。
对于 EPUB 2.0 的 toc.ncx 文件，常见的错误是由于 EPUB 电子书制作不规范，导致出现了重复的 playOrder 的值，当你用 EPUBCheck 验证这样的电子书时，会看到如下所示的错误提示：
Error while parsing file: identical playOrder values for navPoint/navTarget/pageTarget that do not refer to same target
对于 EPUB 3.0 的 nav.xhtml 文件，即便是符合 EPUB 规范，Kindle 个人文档服务也无法正确处理，而违反规范删掉所有导航列表后反倒可以正确处理。这可能是因为 Kindle 个人文档服务负责格式转换的程序未能很好的支持 EPUB 3.0 导致的，今后是否会有所改进有待观察。
二、解决方法
尽管可以使用 EPUB 验证工具 EPUBCheck 找出 EPUB 文件所有不符合规范的地方，但是为了提高效率，不建议这样做，毕竟最终目的是让 EPUB 文件能被 Kindle 个人文档服务正常处理。
这里推荐使用 EPUB 编辑器 Sigil，通过其提供的一些便捷功能快速修复上面提到的那些“错误”。
通过下面的链接下载并安装 Sigil 软件（注意选择适用于你所用操作系统的版本）：
下载 Sigil：https://fere.link/ryfsr9
安装完成后，用 Sigil 打开推送失败的 EPUB 文件。这时可能会出现如下所示对话框：
提示信息的大意是：此 EPUB 中的 HTML 文件格式欠佳，或缺失了 DOCTYPE、html、head、body 元素。Sigl 会自动修复这些文件，尽管在极端情况下，这可能会导致轻微的数据丢失。
除非有特殊需要，建议点击【Yes】按钮让 Sigil 自动修复 EPUB 文件中有问题的代码。
接下来修复 EPUB 2.0 的 toc.ncx 文件或 EPUB 3.0 的 nav.xhtml 文件。依次点击菜单【Tools → Table Of Contents → Generate Table Of Contents…】（或按快捷键【Command + T】）。
最后点击左上角的软盘图标按钮（或按快捷键【Command + S】）保存修改后的文件。
至此，如果你的 EPUB 文件符合上面的问题描述，修复后的 EPUB 文件就能正常推送了。
由于受限于 EPUB 文件样本数量，以上解决方法可能无法覆盖所有情况。如果你有更好的解决方案或小技巧，也欢迎在本文下方留言分享。
三、一点补充
尝试自行修复 EPUB 文件时，你可能需要知道 EPUB 文件都存在哪些问题，书伴推荐为 Sigil 安装一款名为 EpubCheck 的插件，该插件可检测当前打开的 EPUB 文件所有违反规范的地方。
下载 EpubCheck 插件：https://fere.link/qh8snk
插件的安装方法为，下载 EpubCheck 插件压缩包，依次点击 Sigil 菜单【Plugins → Manage Plugins】，在弹出的对话框中，点击【Add Plugin】选择插件压缩包打开即可完成安装。
另外，运行 Sigil 的 EpubCheck 插件需要确保你的操作系统安装了 Java 环境，安装 JRE（Java Runtime Environment）或 JDK（Java Development Kit）均可。如果已安装可忽略此步骤，否则可在以下链接中任选其一下载安装。若非以 Java 开发为目的，推荐安装体积更小的 JRE。
下载 JRE：https://fere.link/nlfkff
下载 JDK（Standard Edition）：https://fere.link/jotkto
下载 OpenJDK：https://fere.link/iavwwt
* 提示：如果你使用的 Sigil 版本号小于 0.9.0，还需要确保你的操作系统安装了 Python 环境 https://fere.link/hbqqpi。
插件的使用方法很简单，用 Sigil 打开 EPUB 文件后，依次点击 Sigil 的菜单【Plugins → Validation → EpubCheck】，稍等片刻，就可以查看当前 EPUB 文件都存在哪些不符合规范的地方。你可以对可能对推送到 Kindle 个人文档产生影响的地方进行修改，保存后进行推送测试即可。
--------- · END · ---------
【推广】书摘服务：memo.bookfere.com