私有GitBook服務(wù)部署說明

20170125 創(chuàng)建說明

使用Gitbook生成在線文檔的流程：

  1. 本機安裝Node.js環(huán)境；
  2. 安裝GitBook；
  3. 生成本地文檔文件；
  4. 編輯本地文檔；
  5. 構(gòu)建靜態(tài)頁面；
  6. 將靜態(tài)頁面推送到GitHub Pages服務(wù)；
  7. 訪問對應(yīng)url。

注：Node.js環(huán)境只用于本機生成&編譯App和靜態(tài)頁面，如果使用服務(wù)端自建git，服務(wù)端無需安裝Node.js環(huán)境，只需同步靜態(tài)頁面后，用其他web容器訪問靜態(tài)頁面即可。

配置流程

  1. 在 https://nodejs.org/ 下載并安裝Node.js

  2. 安裝GitBook，終端輸入

npm install gitbook-cli -g
  1. 創(chuàng)建書本文件夾，初始化文件目錄
gitbook init
  1. 編輯SUMMARY.md文件，生成目錄結(jié)構(gòu)
  2. 再次執(zhí)行gitbook init生成文件目錄
  3. 編輯其他.md文件，并在編輯結(jié)束后，執(zhí)行gitbook init
  4. 編輯中預(yù)覽效果，執(zhí)行
gitbook serve

瀏覽器訪問http://localhost:4000

  1. 創(chuàng)建靜態(tài)頁
gitbook build

生成_book目錄

  1. 使用git將所有文件夾/僅_book文件夾同步至網(wǎng)絡(luò)服務(wù)
  2. 訪問對應(yīng)url。

注：推薦使用類GitHub Pages服務(wù)。

GitBook開源地址：https://github.com/GitbookIO/gitbook

GitBook安裝說明：https://github.com/GitbookIO/gitbook/blob/master/docs/setup.md

最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
平臺聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點，簡書系信息發(fā)布平臺，僅提供信息存儲服務(wù)。

推薦閱讀更多精彩內(nèi)容