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文件,组织到这个目录文件下