Asciibook - 基于 AsciiDoc 的电子书生成工具 - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
爱意满满的作品展示区。
chloerei
V2EX    分享创造

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

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

    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
    关于 &nsp;   帮助文档     自助推广系统     博客     API     FAQ     Solana     907 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 23ms UTC 22:17 PVG 06:17 LAX 14:17 JFK 17:17
    Do have faith in what you're doing.
    ubao msn snddm index pchome yahoo rakuten mypaper meadowduck bidyahoo youbao zxmzxm asda bnvcg cvbfg dfscv mmhjk xxddc yybgb zznbn ccubao uaitu acv GXCV ET GDG YH FG BCVB FJFH CBRE CBC GDG ET54 WRWR RWER WREW WRWER RWER SDG EW SF DSFSF fbbs ubao fhd dfg ewr dg df ewwr ewwr et ruyut utut dfg fgd gdfgt etg dfgt dfgd ert4 gd fgg wr 235 wer3 we vsdf sdf gdf ert xcv sdf rwer hfd dfg cvb rwf afb dfh jgh bmn lgh rty gfds cxv xcv xcs vdas fdf fgd cv sdf tert sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf shasha9178 shasha9178 shasha9178 shasha9178 shasha9178 liflif2 liflif2 liflif2 liflif2 liflif2 liblib3 liblib3 liblib3 liblib3 liblib3 zhazha444 zhazha444 zhazha444 zhazha444 zhazha444 dende5 dende denden denden2 denden21 fenfen9 fenf619 fen619 fenfe9 fe619 sdf sdf sdf sdf sdf zhazh90 zhazh0 zhaa50 zha90 zh590 zho zhoz zhozh zhozho zhozho2 lislis lls95 lili95 lils5 liss9 sdf0ty987 sdft876 sdft9876 sdf09876 sd0t9876 sdf0ty98 sdf0976 sdf0ty986 sdf0ty96 sdf0t76 sdf0876 df0ty98 sf0t876 sd0ty76 sdy76 sdf76 sdf0t76 sdf0ty9 sdf0ty98 sdf0ty987 sdf0ty98 sdf6676 sdf876 sd876 sd876 sdf6 sdf6 sdf9876 sdf0t sdf06 sdf0ty9776 sdf0ty9776 sdf0ty76 sdf8876 sdf0t sd6 sdf06 s688876 sd688 sdf86