使用gitbook 發佈一個教程文檔網站

gitbook是一個好用的發佈電子書的項目；使用gitbook 能夠在本地寫好文檔再遠程推送到庫；也能夠在gitbook提供的在線平臺上製做電子書；要想在本身的服務器上使用gitbook 發佈一個網站；則須要相應的運行環境。本文是經過gitbook editor 軟件寫好電子書的項目；而後經過WinSCP上傳到服務器；再經過gitbook serve 解析MarkDown文檔，監聽本地4000端口實現的。

一、運行環境：

LINUX； CentOS平臺 ； nodejs；npm；

二、安裝配置：

配置很簡單；安裝nodejs：

yum install nodejs

npm 是nodejs自帶的包管理工具；使用yum安裝 nodejs 默認安裝npm；

三、安裝gitbook：

使用命令  （全局安裝）

npm install -g gitbook-cli  

四、初始化：

gitbook init

會在默認安裝gitbook的文件夾初始化一個項目；包含一個README.md 和 SUMMARY.md 兩個文件。 默認狀況下在這個目錄新建文檔便可；也能夠將寫好的整個項目上傳到服務器；最後使用gitbok解析便可；咱們選擇後者；

五、解析新項目：

新項目上傳到服務器後；找到項目路徑：

cd /usr/share/nginx/gitbook

新項目的名稱位於gitbook文件夾下；名稱爲javascript;

gitbook serve javascript

運行結果：

默認 監聽本地的4000端口；可使用服務器的ip（公網ip）訪問這個項目；gitboo會解析Markdown文檔；並返回html頁面。

由於http默認協議使用的是80端口；使用默認的url連接是沒法訪問的；必需要在後面加上端口號；相似於  http://localhost:4000/；   很是很差看； 可是咱們能夠經過web服務器Nginx、 Apache；開啓端口轉發。將80端口的請求轉發到4000端口。