如何使用gitbook搭建wiki

GitBook 是使用 GitHub / Git 和 Markdown（或AsciiDoc）构建漂亮书籍的命令行工具（和Node.js库），GitBook 可以将您的内容作为网站（可定制和可扩展）或电子书（PDF，ePub或Mobi）输出，下面为大家分享一下使用gitbook搭建wiki系统具体方法。

本地编辑md文档后，通过git push到gitlab，gitlab触发webhooks后，由jenkins自动拉取后rsync推送到线上web机器，远程调用sh脚本进行一次init build即可。

web部署gitbook

安装nodejs，这里到官网https://nodejs.org/en/download/直接下载nodejs二进制安装包解压并设置环境变量即可。

mv node-v10.16.0-linux-x64  /bin/
mv /bin/node-v10.16.0-linux-x64  /bin/node
vim  /etc/profile
export  PATH=/usr/bin/node/bin:$PATHsource  /etc/profile

安装gitbook

npm install gitbook-cli -g

jenkins

rsync -avz  $WORKSPACE/ 10.1.14.17:/data/wwwroot/wiki  --exclude=".git"  --exclude="metadata" --exclude="mainlib.db"
ssh  -Tq [email protected]

配置nginx

nginx配置如下：

server {
       listen       80;
       server_name  wiki.21yunwei.com;
       access_log /logs/nginx/wiki/wiki_access.log main;
       error_log  /logs/nginx/wiki/wiki_error.log;
       root /data/wwwroot/wiki/;
       location / {
               proxy_pass http://gitbook;
           }
       location = /nginx-status  {
           stub_status   on;
           access_log   off;
}

本地编辑md文件后直接push到gitlab，触发webhook后由jenkins执行后变的推送以及远程执行sh进行init，这样web就可以直接访问静态页面了。