gitbook通过markdown制作电子书

环境：

gitbook-cli: 2.3.2(2017-07-14)
gitbook:  3.2.3(2017-08-03)
Node.js: 10.24.1(2021-04-06)
npm: 6.14.12

1. 安装Node.js

略

2. 安装gitbook-cli

$ npm i -g gitbook-cli --registry https://registry.npm.taobao.org

查看版本

$ gitbook -V
CLI version: 2.3.2
GitBook version: 3.2.3

https://registry.npmmirror.com/gitbook-cli/-/gitbook-cli-2.3.2.tgz
https://registry.npmmirror.com/gitbook/-/gitbook-3.2.3.tgz

3. gitbook-cli的基本使用

• 初始化

$ gitbook init
warn: no summary file in this book
info: create README.md
info: create SUMMARY.md
info: initialization is finished

$ ls mybook/
README.md  SUMMARY.md

• web服务中浏览电子书

$ gitbook serve
Live reload server started on port: 35729
Press CTRL+C to quit ...

info: 7 plugins are installed
info: loading plugin "livereload"... OK
info: loading plugin "highlight"... OK
info: loading plugin "search"... OK
info: loading plugin "lunr"... OK
info: loading plugin "sharing"... OK
info: loading plugin "fontsettings"... OK
info: loading plugin "theme-default"... OK
info: found 1 pages
info: found 0 asset files
info: >> generation finished with success in 0.5s !

Starting server ...
Serving book on http://localhost:4000

• 生成html静态文件

可以在_book目录生成html静态文件

$ gitbook build
info: 7 plugins are installed
info: 6 explicitly listed
info: loading plugin "highlight"... OK
info: loading plugin "search"... OK
info: loading plugin "lunr"... OK
info: loading plugin "sharing"... OK
info: loading plugin "fontsettings"... OK
info: loading plugin "theme-default"... OK
info: found 1 pages
info: found 0 asset files
info: >> generation finished with success in 0.4s !

• 生成电子书(ePub Mobi PDF)

$ gitbook epub . mybook.epub

$ gitbook mobi . mybook.mobi

$ gitbook pdf . mybook.pdf
info: 7 plugins are installed
info: 6 explicitly listed
info: loading plugin "highlight"... OK
info: loading plugin "search"... OK
info: loading plugin "lunr"... OK
info: loading plugin "sharing"... OK
info: loading plugin "fontsettings"... OK
info: loading plugin "theme-default"... OK
info: found 1 pages
info: found 2 asset files
info: >> generation finished with success in 4.7s !
info: >> 1 file(s) generated

电子书的生成需要依赖ebook-convert
可安装calibre，下载地址：https://calibre-ebook.com/download

Reference:

1. https://www.gitbook.com/
2. https://github.com/GitbookIO/gitbook
3. https://www.npmjs.com/package/gitbook-cli
4. https://www.npmjs.com/package/gitbook