Linux上安装gitbook并拉取git项目编译

1、下载node

注意：我尝试了用 node 14.x，gitbook会报莫名其妙的错误，这里推荐安装 node 12.x

下载地址：

https://nodejs.org/dist/latest-v12.x

我下载的是：

node-v12.22.1-linux-x64.tar.xz

 

2、上传到Linux服务器，解压

# 解压
tar -xvf node-v12.22.1-linux-x64.tar.xz
# 修改文件名
mv node-v12.22.1-linux-x64 nodejs

 

3、建立软连接到 /usr/local/bin/ ，方便使用 node 和 npm 命令

# 建立软连接
ln -s /usr/local/nodejs/bin/npm /usr/local/bin/
ln -s /usr/local/nodejs/bin/node /usr/local/bin/

# 测试
npm -v
node -v

 

4、安装gitbook

先安装一些环境：

yum -y install gcc openssl-devel gcc-c++ compat-gcc-34 compat-gcc-34-c++

4.1 安装 gitbook-cli：

npm install -g gitbook-cli
# 建立软连接
ln -s /usr/local/nodejs/bin/* /usr/sbin/

4.2 安装 gitbook：

gitbook -V

这一步会报如下错误：

/usr/local/lib/node_modules/gitbook-cli/node_modules/npm/node_modules/graceful-fs/polyfills.js:287
      if (cb) cb.apply(this, arguments)

修改 polyfills.js 文件，注释（62至64行）：

// fs.stat = statFix(fs.stat)
// fs.fstat = statFix(fs.fstat)
// fs.lstat = statFix(fs.lstat)

 

5、安装 git 

yum -y install git

拉取项目，然后执行如下命令，会把 md 文件编译到一个 _book 文件夹，用 nginx 转发到这个目录即可

# gitbook编译
gitbook build

 

6、gitbook关键文件说明：

gitbook要求有两个文件，一个是 README.md，一个是 SUMMARY.md

README.md：介绍文件

SUMMARY.md： 目录文件，需要把你所有的 md文件，组织到这个目录文件下