gitbook安裝與使用
本文主要介紹了在windown上通過gitbook editor編輯電子書並通過linux系統gitbook進行靜態頁面訪問的方法。
1. gitbook簡介:
GitBook 是一個基於 Node.js 的命令行工具,可使用 Github/Git 和 Markdown 來制作精美的電子書。GitBook支持輸出以下幾種文檔格式:
靜態站點:GitBook默認輸出該種格式
PDF:需要安裝gitbook-pdf依賴
eBook:需要安裝ebook-convert
2. windows上gitbook editor安裝:
官網https://www.gitbook.com/editor/下載安裝
安裝完成之後,如果有github賬號直接登錄。
登錄後選擇本地文檔保存路徑如下圖,然後就可以愉快的編寫電子書了。
3. linux環境搭建gitbook:
a.安裝Nodejs (npm)
官網 https://nodejs.org/en/ 下載nodejs源碼,采用源碼編譯安裝。
tar xvf node-v4.2.4-linux-x64.tar.gz
cd node-v.2.4-linux-x64/lib/node_modules/npm
./configure
make
make install
b. 配置nodejs鏡像
nodejs 鏡像配置
nodejs 安裝完成後,我們就可以開始安裝 gitbook 了。但是在安裝之前,我們還需要配置一下 nodejs 插件安裝的下載鏡像地址。因為默認的鏡像地址是在國外,需要FQ才可以訪問,
因此我們需要設置國內的鏡像地址。國內的我推薦大家使用阿裏巴巴的鏡像地址 http://registry.npm.taobao.org 。執行下面的命令,進行配置。
npm config set registry http://registry.npm.taobao.org
c.gitbook 安裝
npm install -g gitbook-cli
gitbook -V
查看gitbook是否安裝成功。
4.生成靜態頁面並遠程訪問
使用gitbook editor在本地編輯電子書,然後將其上傳到gitbookserver()上(或者直接samba映射到linux系統上)。
然後gitbook serve 上傳上來的目錄
然後瀏覽器訪問即可 (http://XXXXX:4000)
5.end
gitbook安裝與使用