V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
爱意满满的作品展示区。
chloerei
V2EX  ›  分享创造

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

  •  1
     
  •   chloerei ·
    chloerei · 2020-02-20 17:12:13 +08:00 · 2961 次点击
    这是一个创建于 1762 天前的主题,其中的信息可能已经有所发展或是发生改变。

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

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

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

    它提供的特性有:

    • 支持生成 HTML/PDF/EPUB/MOBI。
    • 基于命令行,通过 docker 分发,跟 CI/CD 协作良好。
    • 基于 HTML/CSS/JavaScript 的主题系统。
    • 支持 latexmath。

    为了展示效果,我用《 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/

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

    4 条回复    2023-08-13 01:43:41 +08:00
    whileFalse
        1
    whileFalse  
       2020-02-20 18:38:37 +08:00
    这个 pro git 的连接啥也没有啊。
    chloerei
        2
    chloerei  
    OP
       2020-02-20 18:57:35 +08:00 via iPhone
    @whileFalse 点右边的箭头

    这个主题模仿一些电子书阅读工具,看来首页内容还得改善下。
    rina
        3
    rina  
       2020-02-25 22:55:59 +08:00
    哇卡卡,特意过来点个赞👍🏻👍🏻
    MiketsuSmasher
        4
    MiketsuSmasher  
       2023-08-13 01:43:41 +08:00
    作者你好,刚刚试用了你的这个项目,发现有个 bug:源 AsciiDoc 文件中的 Section title 中有中文字符的话,生成的 EPUB 文件中的对应文件,在 Sigil 、Calibre 等 EPUB 工具中无法正确识别,文件名显示为乱码。
    已经提交了 issue: https://github.com/asciibook/asciibook/issues/5
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   3999 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 23ms · UTC 04:12 · PVG 12:12 · LAX 20:12 · JFK 23:12
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.