使用Gitbook生成电子书

《Google工程实践文档》相对原文Google's Engineering Practices documentation ，部分内容过时了。需要更新中文版，并使用Gitbook把Markdown文件转换成对应的PDF电子书。

上一次生成PDF电子书是5年前，当时生成电子书的环境早已不在。此次重新搭建环境，以备忘。

需要安装3个工具：Calibre、nvm 和nodejs。

Calibre
使用Gitbook生成PDF文件时，底层会调用Calibre生成PDF文件。
nvm
用于管理nodejs版本。
本机已经是最新版本的nodejs（版本号20.11.0）。由于gitbook官方长期未更新，与最新版本的nodejs不兼容。为了让其正常运行，本机只能安装较老版本（10.22.0）的nodejs。
安装nvm的目的是为了随时能在不同的nodejs版本间切换。当需要使用gitbook时，使用10.22.0，否则，其他场合使用最新版本。
Nodejs和gitbook
Gitbook命令基于nodejs（版本号10.22.0）运行。

1. 安装Calibre

Calibre 必须使用3.48版本。

最新版本的Calibre虽然也能生成PDF文件，但兼容性不好，生成的PDF文件比较大，而且会内嵌很多字体。除此之外，在生成的PDF文件中，电子目录（左边的书签）无法正确定位到文档中正确的位置。

在官网：Previous calibre releases 可以找到 3.48 版本。

下载后，双击安装。

2. 安装nvm

1) 从Github上下载windows版安装文件 nvm-setup.exe 。

安装过程中，会提示找到已安装的版本，是否要纳入版本管理，点击"是"。

2) 安装nvm之后，到命令行中执行

3) 安装 10.22.0 版本的nodejs，运行

$ nvm install 10.22.0

4) 切换到版本 10.22.0，运行

$ nvm use 10.22.0

5) 运行 node -v，运行结果显示

$ node --v
　　v10.22.0

3. 安装gitbook并验证版本为3.2.3
　　$ npm install gitbook-cli --g
　　$ gitbook --v
　　CLI version: 2.3.2
　　GitBook version: 3.2.3

Gitbook生成电子书的流程如下图所示：

运行help命令可以查询gitbook的用法。

$ gitbook help

build [book] [output] build a book

--log Minimum log level to display (Default is info; Values are debug, info, warn, error, disabled)

--format Format to build to (Default is website; Values are

......