2.2.1. 安装

Gitbook 的 安装指引

环境要求

• NodeJS (v4.0.0 and above is recommended)
• Windows, Linux, Unix, or Mac OS X

Node.js 官方下载及安装教程

这里只记录下 Ubuntu Debain 系的安装过程。

2.2.1.1. 安装 Node.js

2.2.1.1.1. 法一 标准库安装（不推荐）

sudo apt update
sudo apt install nodejs npm
# 查看版本
node -v
v10.21.0
npm -v
5.8.0

看似安装顺利，实际 npm 版本低，安装 gitbook 时会报错 npm does not support Node.js v10.21.0

2.2.1.1.2. 法二 从 NodeSource 储存库安装

# 长期支持版本12.x，不要使用最新版本14.x
# 切换到root
curl -sL https://deb.nodesource.com/setup_lts.x | bash -
apt-get install -y nodejs
# 查看版本
node -v
v12.18.3
node -v
6.14.6
# 安裝 development tools
apt-get install gcc g++ make

2.2.1.1.3. 法三 Node Version Manager

Node Version Manager 即 nvm 是一个bash脚本，用于管理多个已发布的 Node.js 版本。它允许您执行安装，卸载，切换版本等操作。

2.2.1.2. 安装 Gitbook

npm install gitbook-cli -g
# 輸出如下表示成功
root@debian:~# npm install gitbook-cli -g
/usr/bin/gitbook -> /usr/lib/node_modules/gitbook-cli/bin/gitbook.js
+ [email protected]
updated 3 packages in 16.865s

2.2.1.2.1. 错误汇总

報錯如下：
Installing GitBook 3.2.3
/usr/lib/node_modules/gitbook-cli/node_modules/npm/node_modules/graceful-fs/polyfills.js:287
      if (cb) cb.apply(this, arguments)
                 ^

TypeError: cb.apply is not a function
    at /usr/lib/node_modules/gitbook-cli/node_modules/npm/node_modules/graceful-fs/polyfills.js:287:18
    at FSReqCallback.oncomplete (fs.js:177:5)

解決方法：

sudo vi /usr/lib/node_modules/gitbook-cli/node_modules/npm/node_modules/graceful-fs/polyfills.js
# 一般模式下輸入
 :set nu
# 注釋掉62-64
// fs.stat = statFix(fs.stat)
// fs.fstat = statFix(fs.fstat)
// fs.lstat = statFix(fs.lstat)