GitBook关联GitHub
想用GitBook的客戶端寫文檔,但是發(fā)現(xiàn)不能登錄GitBook的帳號,主要目的是想把工作成果保存到網(wǎng)絡(luò)上避免放在自己電腦上丟失。于是我采用折衷的辦法,用GitBook在本機寫作,然后把文章保存在GitHub。
1. 下載安裝GitBook Editor
鏈接:https://www.gitbook.com/editor/
安裝后打開,客戶端提示登錄GitBook帳號。由于我值需要用GitBook Editor做編輯工具,不需要把文章存在GitBook上(根本原因是登錄不了,原因你懂)。選Do that later:
由于沒有登錄,創(chuàng)建的圖書都會在存儲在本地,而不會傳到GitBook網(wǎng)上。GitBook Editor創(chuàng)建的圖書默認(rèn)是在C:\Users\用戶名\GitBook目錄下,我習(xí)慣把資料存在D盤,于是選擇菜單欄GitBook Editor - Change Library Path,把目錄改成D:\GitBook:
2. 在本地創(chuàng)建圖書
點擊New Book創(chuàng)建圖書,填寫書名,點擊確定,創(chuàng)建后圖書相關(guān)的文件會存儲在D:\GitBook\Import目錄下。相關(guān)截圖:
注意:由于我在創(chuàng)建圖書前將Library Path改成了D:\GitBook,所以我新建的圖書的文件才會存儲在D:\GitBook\Import目錄下。而Import目錄是對應(yīng)GitBook Editor菜單欄的Import命令。經(jīng)我測試,如果再創(chuàng)建一個D:\GitBook\Open目錄,對應(yīng)的就是GitBook Editor菜單欄的Open命令。Import和Open的區(qū)別是:
- Import可以將從本地其它目錄的圖書(用gitbook init命令創(chuàng)建的圖書目錄)導(dǎo)入到Library Path,導(dǎo)入后修改的文件內(nèi)容會保存在Library Path。比如:在D:\test\hello目錄通過gitbook init創(chuàng)建了一本書,然后打開GitBook Editor Import,選擇D:\test\hello,然后D:\test\hello目錄的文件就會復(fù)制到D:\GitBook\Import\hello。而在GitBook Editor中修改了內(nèi)容后,這些內(nèi)容會保存在D:\GitBook\Import\hello目錄下。
- Open就是直接打開一個gitbook init的圖書。經(jīng)測試,只有在Library Path下的Open目錄下使用gitbook init命令創(chuàng)建的圖書,才會正常在GitBook Editor中顯示。
3. 關(guān)聯(lián)GitHub
在GitBook打開新創(chuàng)建的圖書,點擊Add an article隨便輸入點東西。
注意右上角有兩個按鈕:Save和Publish。當(dāng)點擊Save的時候,GitBook Editor會把編輯的內(nèi)容保存在Library Path。而當(dāng)點擊Publish的時候,就會把編輯的內(nèi)容保存到Git倉庫(可以是任意的Git倉庫:GitHub、碼云、oschina...)。如果當(dāng)前這本存儲在本地的圖書沒有關(guān)聯(lián)Git倉庫,GitBook Editor會彈出提示:
那么這時候就需要創(chuàng)建一個Git倉庫了。到GitHub創(chuàng)建一個空白的倉庫,并復(fù)制https的git倉庫地址。注意必須使用https的因為GitBook Editor暫時不支持SSH,相關(guān)截圖:
然后把git倉庫地址復(fù)制到GitBook Editor,點擊Sync,再輸入GitHub的帳號密碼就OK了,相關(guān)截圖:
最后檢查一下GitHub上時候已經(jīng)有剛同步上去的文件,如果有就OK了。
接下來就可以開始編輯自己的圖書,編輯后記得要點擊右上角Publish同步到GitHub。
總結(jié)
以上是生活随笔為你收集整理的GitBook关联GitHub的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 物联网时代如何管理上百万设备?找风河DL
- 下一篇: SDN和物联网促使网络产生巨大结构性变革