Linux教程

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

本文主要是介绍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文件,组织到这个目录文件下

这篇关于Linux上安装gitbook并拉取git项目编译的文章就介绍到这儿,希望我们推荐的文章对大家有所帮助,也希望大家多多支持为之网!