文檔工具GitBook使用

1、登錄註冊

地址：https://www.gitbook.com/

一、gitbook可以使用github帳號登陸，若是已經註冊github能夠直接使用github帳號登陸

二、若是是github帳號登陸，在登陸成功後，點擊右上角的頭像，選擇‘account setting’去設置用戶Email信息

 

 

 

2、建立文檔

 

一、點擊右上角的‘+New’建立新的BOOk， Public表示全部人可看，Private表示指定人可看

 

二、建立完成後，能夠開始寫文檔，或者點擊Settings->Collaborators邀請其餘人一塊兒來完善文檔

 

 

3、windows客戶端

因gitbook服務器在國外，在線寫文檔速度會比較慢，使用客戶端進行編寫，速度相對會快一些

客戶端地址：http://download.csdn.net/detail/qq_16417155/9594632

使用gitbook帳號登陸後，能夠同步在線的Book進行編寫，寫完後通Sysn同步到gitbook

 

4、生成HTML

一樣的緣由，因gitbook站點在國外，閱讀起來會比較慢，能夠經過生成html部署到自有網站，加快顯示速度

參考：

 

http://www.colobu.com/2014/10/09/gitbook-quickstart/

注：安裝HTML工具前，請先安裝nodejs

安裝HTML生成工具:

1. 進入cmd

2. 執行：npm install gitbook -g

3. 執行：npm install -g gitbook-cli

生成HTML：

安裝完生成工具以後，執行如下命令進行生成.

gitbook build 所在目錄

好比個人book所在目錄是 D:\hongw\Import\docs

那麼執行 gitbook build D:\hongw\Import\docs

執行完成後，目錄下的_book裏就有咱們整本書的Html了。