Asciibook - 基于 AsciiDoc 的电子书生成工具

2020-02-20 17:12:13 +08:00
 chloerei

Asciibook 是一个电子书生成工具,可以将 AsciiDoc 转换为 HTML/PDF/EPUB/MOBI 格式的电子书。

GitBook 曾经是最好的开源电子书制作工具,但是他们在 2018 年底放弃了这个项目。现在电子书作者要不继续使用失去维护的 GitBook,要不用自制脚本粘合各种生成工具,所以我产生想法写一个新的电子书生成工具,取代 GitBook。

官网 https://asciibook.org/
源码 https://github.com/asciibook/asciibook

它提供的特性有:

为了展示效果,我用《 Pro Git 》中文版的源码生成了一份电子书,请看 https://asciibook.org/progit2-zh/

使用方法

Asciibook 是使用 docker 分发的,这样使用者不用处理各种安装依赖。

先 pull docker 镜像(关于 Tag: https://hub.docker.com/r/asciibook/asciibook ):

$ docker pull asciibook/asciibook:0.0.2-cjk-sc

在写作的工作目录进入容器环境:

$ docker run -it -v $(pwd):/asciibook asciibook/asciibook bash
/asciibook #

构建电子书:

/asciibook # ascibook build mybook.adoc

这样就会生成四种格式的电子书。

更详细的使用方法,包括配置和主题模板等内容,请看文档 https://asciibook.org/docs/

现在这个项目已经基本可用,我还将继续优化,欢迎使用并提供意见建议。

2740 次点击
所在节点    分享创造
4 条回复
whileFalse
2020-02-20 18:38:37 +08:00
这个 pro git 的连接啥也没有啊。
chloerei
2020-02-20 18:57:35 +08:00
@whileFalse 点右边的箭头

这个主题模仿一些电子书阅读工具,看来首页内容还得改善下。
rina
2020-02-25 22:55:59 +08:00
哇卡卡,特意过来点个赞👍🏻👍🏻
MiketsuSmasher
259 天前
作者你好,刚刚试用了你的这个项目,发现有个 bug:源 AsciiDoc 文件中的 Section title 中有中文字符的话,生成的 EPUB 文件中的对应文件,在 Sigil 、Calibre 等 EPUB 工具中无法正确识别,文件名显示为乱码。
已经提交了 issue: https://github.com/asciibook/asciibook/issues/5

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/646152

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX