思路:通過將 Wiki 文檔內(nèi)容的倉庫托管在 GitHub 之上,并且將 GitBook 框架的代碼放在倉庫中 ,然后找一臺有 Node.js 環(huán)境的服務(wù)器,通過簡單的幾行命令就能部署成功,十分鐘內(nèi)能搞定。從而具備多人協(xié)作、版本控制、Markdown 寫作、代碼高亮、實(shí)時更新的特性。
一、效果展示
1、Material Design 中文版(有側(cè)邊欄菜單)

2、GitBook Help Center(無側(cè)邊欄菜單)


二、功能特性
1、頁面美觀
主要體現(xiàn)在兩個方面:其一,頁面的外觀,請回頭看看上面的效果圖。其二,鏈接的格式,如下:
- GitBook 鏈接示例:http://zitiao.org/material-design/usability/accessibility.html
- MDwiki 鏈接示例:http://dynalon.github.io/mdwiki/#!layout.md (我個人見不得
#、!之類的字符)
2、多人協(xié)作 & 版本控制
文檔內(nèi)容托管于 GitHub 之上,GitHub 本身就具備 多人協(xié)作 和 版本控制 的功能。當(dāng)然所有的 Git 托管平臺都可以,比如說國外的 GitLab、Bitbucket,或者國內(nèi)的 git.oschina.net、coding.net 都行。
如果希望倉庫私有,國外產(chǎn)品推薦 Bitbucket,因?yàn)樗接袀}庫免費(fèi),而 GitHub 私有倉庫收費(fèi)。國內(nèi)的好像私有倉庫都免費(fèi),在安全性和穩(wěn)定性方面可能不如 Bitbucket。
3、Markdown 寫作
文檔內(nèi)容托管于 GitHub 之上,GitHub 本身就具備 Markdown 寫作 的功能。
4、代碼高亮
通過 GitBook 的插件能很容易支持代碼高亮(這就是站在巨人的肩膀上的好處)。
5、實(shí)時更新
通過給 GitHub 倉庫配置 webhook 進(jìn)行 push 時的消息推送,能觸發(fā)服務(wù)器實(shí)時更新(服務(wù)器上需要些代碼)。
6、一鍵部署
只需要簡單的幾行命令就部署完畢。
三、所需資源
唯一的一個條件就是,一臺支持 Node.js 的服務(wù)器(公網(wǎng)和內(nèi)網(wǎng)服務(wù)器都行)。
四、操作手冊
詳細(xì)的操作手冊見:http://zitiao.org/deploy/