根据 Tim O’Reilly 五年前 Rough Cuts 的数据，“绅士更喜欢 PDF”。在 OpenStack，我们也看到对 PDF 有一定的偏好，但访问我们 Compute 管理手册 的 HTML 版本的访问量是 PDF 的三倍。尽管如此，该指南的 PDF 版本 每天大约会被下载五次。我确实相信绅士更喜欢 PDF 或某种类似书籍的阅读材料。读者在被询问时，认为便携性和搜索范围是这种格式的两个优点。然而，正如我们的文档工具开发者 David Cramer 在最近的黑客马拉松中所说，“PDF 就像水泥”。随着移动和平板屏幕的普及，像 epub 这样具有弹性和灵活性的屏幕阅读格式填补了一种需求——我们需要能够在单手掌握的 200 多种设备上良好运行的内容。
因此，在 11 月 11 日，在奥斯汀 Rackspace 办公室，我们进行了一些黑客操作，以便能够从我们的 DocBook 源代码文件中创建 epub 输出。我在活动之前在 OpenStack Planet 博客上发表了博文，DocBook、ePub、黑客马拉松，你还能要求什么？，介绍了我们的一些准备工作。
我很高兴向您展示结果——我们成功输出了 epub，并在 Kindle 上测试了 Mobi 输出，所有这些都在一天内完成，团队中有大约七名黑客，包括开发者、作者和测试人员。
我们首先使用 Oxygen，我们的 XML 编辑器 提供的内置 epub 转换来测试该过程，Oxygen 通过向文档贡献者捐赠许可证来支持 OpenStack 等开源项目。感谢 Oxygen！我们能够使用该输出开始测试。这是我们的白板，上面列出了错误列表。
在作者和测试人员对输出进行黑客操作的同时，程序员正在努力确保我们能够通过 Apache Maven（我们的构建工具）获得 epub 输出。到一天结束时，我们也可以通过自动构建过程输出 epub！
就像黑客马拉松一样，还有一些清理工作要做——例如，我们漂亮的动态 SVG 封面页，它接收诸如书名之类的变量，无法为 epub 输出封面。此外，大多数“真正的” epub 输出工作流程会将表格从文本转换为图像（我知道，当你想到搜索能力的丧失时，这很疯狂），但 epub 输出中的表格在调整大小时表现得有点奇怪。此外，Kindle 格式 mobi 对列表的标记方式存在问题，但这些问题可以修复并记录在错误日志中。
我尚未决定 epub 输出的质量是否足以将其提供下载以供 OpenStack 文档网站上的每本书使用，也不知道对该输出的需求量有多大，但我希望将 OpenStack 入门指南作为 epub 下载 提供。CSS OSS 团队正在努力创建这些内容，我希望它能够传播到许多设备上。请告诉我它对您来说是否有效，以及您是否认为 epub 是否可以在 OpenStack 文档的常规输出中占据一席之地。
发表评论