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

gitbook是一個好用的發佈電子書的項目;使用gitbook 可以在本地寫好文檔再遠程推送到庫;也可以在gitbook提供的在線平臺上製作電子書;要想在自己的服務器上使用gitbook 發佈一個網站;則需要相應的運行環境。本文是通過gitbook editor 軟件寫好電子書的項目;然後通過WinSCP上傳到服務器;再通過gitbook serve 解析MarkDown文檔,監聽本地4000端口實現的。

1、運行環境:

LINUX; CentOS平臺 ; nodejs;npm;

2、安裝配置:

配置很簡單;安裝nodejs:

yum install nodejs

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

3、安裝gitbook:

使用命令  (全局安裝)

npm install -g gitbook-cli  

4、初始化:

gitbook init

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

5、解析新項目:

新項目上傳到服務器後;找到項目路徑:

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端口。

 

 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章