如何將gitbook和github關聯?

lt發表於2016-11-07

需要先在github上建立一個repository,例如repo.
然後在gitbook上建立一本book,例如note.
再在gitbook中選擇setting,在左側選擇github,然後選擇repo,如果兩者的登入使用者相同,系統就會自動將2者關聯.
比如我現在在gitbook中的table of contents中新增一個新檔案,命名為how_to_link_gitbook_with_github.md 儲存後就會在github的repo中多出一個同名檔案,檔案內容就是gitbook檔案的內容。 如果順序反了,先寫book,再建repo,雖然可以按幫助的提示授權,就會出問題,我是把book和repo全都刪除了才關聯好的。

如果檔案不是在gitbook中建立的,那麼它雖然出現在files tree中,但不會出現在table of contents中,也不會出現在最終的電子書(如pdf)中。

編輯器還是gitbook的功能更強,所以應該在gitbook裡編輯。需要當心,如果同時在github和gitbook中編輯一個檔案,很可能覆蓋其中一個作的修改。

相關文章