使用 reStructuredText、Sphinx、Calibre 和 vim 自行出版一本书

主要观点:作者受如今出版书籍简便的启发写了《Digital Superpowers》,介绍了写作及准备手稿所用的工具集,包括 reStructuredText(RST)、Sphinx、Calibre、KindleGen 等,还提及了版本控制、索引、词汇表、脚注、特殊环境、拼写语法、自定义主题、前后页及版权页、用 Vim 编辑文本、ePub 构建相关问题及最终上传步骤等。
关键信息:

  • 可通过直接出版服务出版书籍,e 书易自出版,按需印刷平装书也较简单。
  • 用 RST 写手稿,Sphinx 处理成 ePub 格式,Calibre 做最终处理,KindleGen 转换为 Amazon MOBI 格式。
  • RST 文本便于版本控制,有多种有用功能,如索引、词汇表、脚注等。
  • 多种工具用于拼写语法检查,如 LanguageTool、Diction 和 style 命令、Grammarly 等。
  • 需自定义 Sphinx 的 ePub 主题,Calibre 的检查功能很有用。
  • 为在 Kindle 中正确处理,需添加封面、标题页和版权页等。
  • Vim 用于高效编辑文本,有很多实用功能。
  • ePub 构建中存在空脚注部分和双份图像等问题。
    重要细节:
  • RST 中添加索引项的示例及生成的索引效果。
  • 各种特殊环境如 TikZ 和 Graphviz 在文本中的使用及生成的图像。
  • 不同平台和工具在拼写语法检查方面的尝试及效果。
  • 自定义主题时解决表格额外垂直填充问题的方法。
  • PDF 生成偶尔 corrupt 及解决办法。
  • 手动处理 ePub 构建中的一些问题,如删除空脚注部分和双份图像。
  • 最终用 Kindlegen 生成上传 Amazon 的文件。作者还未开始按需印刷平装书版本,需完善 PDF 格式等。
阅读 12
0 条评论