gitbook 使用命令

我用的是mac pro本，由於硬盤存儲空間有限，同時gitbook的客戶端用戶交互感通常，因此我不推薦下載。

我通常是在線編寫文章後，用命令下載同步到本地，在生成html。我喜歡用離線的html文檔形式，不管是編寫api仍是技術文檔查看傳閱都很方便。

我寫這篇文章是2018年2月，引用gitbook升級版頻繁而且先後的命令和操做方式不一致，因此請慎重參考。

1. 下載gitbook

sudo npm install -g gitbook-cli

2. 建立目錄並初始化

mkdir test
cd test
git init                      #初始化git
git pull http://url.git       #將網站上的book下載同步到本地

1. 生成html文檔

gitbook build --gitbook=2.6.7

好像從 3.0.0 版起, gitbook build 生成的 website 就不支持 local 打開了（其實也能打開，會有問題如點擊左側目錄並不跳轉的問題）, 必須要 webserver 開啓;

實在要徹底靜態的, 須要以 2.6.7 版build編譯( 在有些瀏覽器下估計不太完美 )