用Gitbook快速搭建Wiki

本文展示如何用Gitbook快速搭建一套wiki

 

必備環境

1、gitbook(如何安裝gitbook自行百度)

2、nginx(或其他的能當作靜態http服務器的)

3、gitlab(或者svn，需要能觸發CI/CD的。我這里只展示用gitlab的.gitlab-ci.yml配置CI/CD，svn可以用post-trigger)

 

一、創建git庫

二、初始化gitbook目錄(可以用gitbook init，這里我采用手動)

根目錄分別創建3個文件book.json,README.md,SUMMARY.md

1. book.json(我給加入了一些常用插件)，注意"Home": "http://xxx.com/wiki"，也可以不配

{
    "gitbook": "3.x.x",
    "title": "我的Wiki",
    "description": "我的Wiki",
    "author": "我的Wiki",
    "language": "zh-hans",
    "root": ".",
    
    "links": {
        "sidebar": {
            "Home": "http://xxx.com/wiki"
        }
    },
    "plugins": ["chapter-fold","expandable-chapters","tbfed-pagefooter","prism", "-highlight", "splitter", "mermaid-gb3"],
    "pluginsConfig": {
        "theme-default": {
            "showLevel": true
        },
        "prism": {
            "css": [
                "prismjs/themes/prism-tomorrow.css"
            ]
        },
        "tbfed-pagefooter": {
            "copyright": "Copyright &copy <a href='http://xxx.com/wiki' target='_blank'>我的Wiki</a> 2019",
            "modify_label": "修訂時間：",
            "modify_format": "YYYY-MM-DD HH:mm:ss"
        }
       
    }
    
}

 

2. README.md（md語法隨便寫點什么）

<center><font color=0099ff size=72 face="黑體">隨便寫點什么Wiki</font></center>

 

3. SUMMARY.md

* [首頁](README.md)

---

* 第一章
    * [第一節](1.1.md)
    * [第二節](1.2.md)
        * [第一篇](1.2.1.md)

---

* 第二章
    * [第一節](2.1.md)
    * [第二節](2.2.md)
    

 

三、持續集成

1、在nginx所在的web服務器上clone這個git庫（比方我的目錄是/www/wiki）

2、編寫.gitlab-ci.yml

stages:
  - deploy

deploy_wiki:
  stage: deploy
  script:
    - cd /www/wiki
    - git pull
    - gitbook install
    - gitbook build

　　

四、配置nginx（不會配置nginx的可以參考我之前發的幾個配置模板 點這里）

1、在/etc/nginx/conf.d/default.conf中加入

# WIKI
    location /wiki {
         alias  /www/wiki/_book/;
         index  index.html index.htm index.jsp;
    }

2、nginx重載配置

nginx -s reload

 

五、看效果瀏覽器打開 http://{nginx_server_ip}/wiki