使用Gitbook生成电子书

gitbook网站可以生成精美的电子书，既可以在线阅读又可以生成pdf，epub，mobi格式的电子书籍进行离线阅读。文档使用的markdown语法，本人使用Markdown已经有2年多的经验了，下面介绍一下gitbook使用。

安装gitbook

  1. 安装nodejs

gitbook依赖nodejs

上nodejs官方下载lts版本

1wget https://nodejs.org/dist/v12.16.0/node-v12.16.0-linux-x64.tar.xz
2tar xf node-v12.16.0-linux-x64.tar.xz -C /usr/local/

配置环境变量

1echo 'export PATH=$PATH:/usr/local/node-v12.16.0-linux-x64/bin' >> ~/.bash_profile
2source ~/.bash_profile

验证node版本

1node -v
2v12.16.0
  1. 安装gitbook-cli

官方源下载太慢，切换为国内源

1npm install -g cnpm --registry=https://registry.npm.taobao.org

安装gitbook-cli

1npm install gitbook-cli -g

查看cli版本信息，默认会安装gitbook最新版本

1gitbook --version
2CLI version: 2.3.2
3Installing GitBook 3.2.3

可以手动指定gitbook安装版本

 1# 查看所有版本信息
 2gitbook ls-remote
 3Available GitBook Versions:
 4
 5     4.0.0-alpha.6, 4.0.0-alpha.5, 4.0.0-alpha.4, 4.0.0-alpha.3, 4.0.0-alpha.2, 4.0.0-alpha.1, 3.2.3, 3.2.2, 3.2.1, 3.2.0, 3.2.0-pre.1, 3.2.0-pre.0, 3.1.1, 3.1.0, 3.0.3, 3.0.2, 3.0.1, 3.0.0, 3.0.0-pre.15, 3.0.0-pre.14, 3.0.0-pre.13, 3.0.0-pre.12, 3.0.0-pre.11, 3.0.0-pre.10, 3.0.0-pre.9, 3.0.0-pre.8, 3.0.0-pre.7, 3.0.0-pre.6, 3.0.0-pre.5, 3.0.0-pre.4, 3.0.0-pre.3, 3.0.0-pre.2, 3.0.0-pre.1, 2.6.9, 2.6.8, 2.6.7, 2.6.6, 2.6.5, 2.6.4, 2.6.3, 2.6.2, 2.6.1, 2.6.0, 2.5.2, 2.5.1, 2.5.0, 2.5.0-beta.7, 2.5.0-beta.6, 2.5.0-beta.5, 2.5.0-beta.4, 2.5.0-beta.3, 2.5.0-beta.2, 2.5.0-beta.1, 2.4.3, 2.4.2, 2.4.1, 2.4.0, 2.3.3, 2.3.2, 2.3.1, 2.3.0, 2.2.0, 2.1.0, 2.0.4, 2.0.3, 2.0.2, 2.0.1, 2.0.0, 2.0.0-beta.5, 2.0.0-beta.4, 2.0.0-beta.3, 2.0.0-beta.2, 2.0.0-beta.1, 2.0.0-alpha.9, 2.0.0-alpha.8, 2.0.0-alpha.7, 2.0.0-alpha.6, 2.0.0-alpha.5, 2.0.0-alpha.4, 2.0.0-alpha.3, 2.0.0-alpha.2, 2.0.0-alpha.1
 6
 7Tags:
 8
 9     latest : 2.6.9
10     pre : 4.0.0-alpha.6
11
12# 指定版本安装
13gitbook fetch 3.2.3

制作电子书

  1. 初始化目录
1mkdir ebook
2cd ebook
3gitbook init
4warn: no summary file in this book 
5info: create README.md 
6info: create SUMMARY.md 
7info: initialization is finished

  1. 编辑md文件，向文件添加内容

  2. 运行gitbook

 1gitbook serve
 2Live reload server started on port: 35729
 3Press CTRL+C to quit ...
 4
 5info: 7 plugins are installed 
 6info: loading plugin "livereload"... OK 
 7info: loading plugin "highlight"... OK 
 8info: loading plugin "search"... OK 
 9info: loading plugin "lunr"... OK 
10info: loading plugin "sharing"... OK 
11info: loading plugin "fontsettings"... OK 
12info: loading plugin "theme-default"... OK 
13info: found 1 pages 
14info: found 0 asset files 
15info: >> generation finished with success in 0.9s ! 
16
17Starting server ...
18Serving book on http://localhost:4000

默认监听在本地4000端口，可以进行访问和测试

  1. 构建静态web页面
1gitbook build
  1. 生成电子书

导出电子书，需要用到calibre插件，下载地址：https://calibre-ebook.com/download

安装calibre插件

1sudo -v && wget -nv -O- https://download.calibre-ebook.com/linux-installer.sh | sudo sh /dev/stdin

导出电子书

1gitbook pdf  # 生成pdf格式电子书
2gitbook modi # 生成mobi格式电子书
3gitbook epub # 生成epub格式电子书