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