一直都在用这套东西,却没有自己动手搭建过,今天自己用了2小时时间摸索搭建了一套文档在线观看,意见发布文档的东西,仅供大家参考:
首先在linux上搭建一个gitbook的环境:
1.安装git
在CentOS6及以上的yum源中已经有git版本,可以直接用yum源安装,安装命令:sudo yum install git
2.安装Node.js和NPM
到node官网下载node.js(https://nodejs.org/en/download/)
因为我用的系统是64位,所以下载了linux环境64位的安装包
copy到linux要安装的目录下
使用命令解压: tar zxvf node-v8.2-linux-x64.tar.gz
cd node-v8.2.1-linux-x64
#设置为全局,由于node自带npm,所以无需安装
查看node版本: node -v
查看npm版本:npm -v
2.安装gitbook工具
npm install gitbook-cli -g
sudo ln -s /home/node-v8.2-linux-x64/bin/gitbook /usr/local/bin/gitbook
查看版本:gitbook -V 注意:V大写
mkdir demo
cd demo
初始化:gitbook init (会生成README.md和SUMMARY.md两个文件)
生成web静态站点:gitbook build ./ (会生成_book目录,也就是静态站点,也就是编译好的html文件)
启动站点:gitbook serve ./ (默认地址:http://localhost:4000)
3.配置gitbook和jenkins部署
在jenkins客户端创建一个*风格的软件项目
因为我们源码都放在云端git上面,这里源码管理选择git,填写具体项目地址:
然后构建环境执行shell脚本:
我这里写的脚本意思是,创建并编译_book下的文件,使之生成静态html文件,copy到我的home下的xx目录下
点击保存,点击立即构建按钮,即可把git上的文件编译后copy到我们指定home目录下
这里我们用到了nginx,做路径跳转
最下面的是我们cp过去的文件路径
这里我们访问对应的服务器ip或者域名加上我们对应的指向路径即可访问gitbook文档连接
比如我们服务器ip是139.196.111.222,我们nginx配置路径是 /aa/bb,端口默认是80,那么我们访问139.196.111.222/aa/bb
如下所示即可: