GitBook關聯GitHub

想用GitBook的客戶端寫文檔，可是發現不能登陸GitBook的賬號，主要目的是想把工做成果保存到網絡上避免放在本身電腦上丟失。因而我採用折衷的辦法，用GitBook在本機寫做，而後把文章保存在GitHub。

1. 下載安裝GitBook Editor

連接：https://www.gitbook.com/editor/

安裝後打開，客戶端提示登陸GitBook賬號。因爲我值須要用GitBook Editor作編輯工具，不須要把文章存在GitBook上（根本緣由是登陸不了，緣由你懂）。選Do that later：

因爲沒有登陸，建立的圖書都會在存儲在本地，而不會傳到GitBook網上。GitBook Editor建立的圖書默認是在C:\Users\用戶名\GitBook目錄下，我習慣把資料存在D盤，因而選擇菜單欄GitBook Editor - Change Library Path，把目錄改爲D:\GitBook：

2. 在本地建立圖書

點擊New Book建立圖書，填寫書名，點擊肯定，建立後圖書相關的文件會存儲在D:\GitBook\Import目錄下。相關截圖：

注意：因爲我在建立圖書前將Library Path改爲了D:\GitBook，因此我新建的圖書的文件纔會存儲在D:\GitBook\Import目錄下。而Import目錄是對應GitBook Editor菜單欄的Import命令。經我測試，若是再建立一個D:\GitBook\Open目錄，對應的就是GitBook Editor菜單欄的Open命令。Import和Open的區別是：

• Import能夠將從本地其它目錄的圖書（用gitbook init命令建立的圖書目錄）導入到Library Path，導入後修改的文件內容會保存在Library Path。好比：在D:\test\hello目錄經過gitbook init建立了一本書，而後打開GitBook Editor Import，選擇D:\test\hello，而後D:\test\hello目錄的文件就會複製到D:\GitBook\Import\hello。而在GitBook Editor中修改了內容後，這些內容會保存在D:\GitBook\Import\hello目錄下。
• Open就是直接打開一個gitbook init的圖書。經測試，只有在Library Path下的Open目錄下使用gitbook init命令建立的圖書，纔會正常在GitBook Editor中顯示。

3. 關聯GitHub

在GitBook打開新建立的圖書，點擊Add an article隨便輸入點東西。

注意右上角有兩個按鈕：Save和Publish。當點擊Save的時候，GitBook Editor會把編輯的內容保存在Library Path。而當點擊Publish的時候，就會把編輯的內容保存到Git倉庫（能夠是任意的Git倉庫：GitHub、碼雲、oschina...）。若是當前這本存儲在本地的圖書沒有關聯Git倉庫，GitBook Editor會彈出提示：

那麼這時候就須要建立一個Git倉庫了。到GitHub建立一個空白的倉庫，並複製https的git倉庫地址。注意必須使用https的由於GitBook Editor暫時不支持SSH，相關截圖：

而後把git倉庫地址複製到GitBook Editor，點擊Sync，再輸入GitHub的賬號密碼就OK了，相關截圖：

最後檢查一下GitHub上時候已經有剛同步上去的文件，若是有就OK了。

接下來就能夠開始編輯本身的圖書，編輯後記得要點擊右上角Publish同步到GitHub。