# 使用gitbook 之前整理的習慣是使用Evernote，其實主要做的是收錄（輸入）的功能，東西多了，就難以消化掉（處理），以至于沒有總結（輸出）。Markdown格式是我很喜歡的一種書寫格式，我覺得特別適合程序員，配合gitbook，就能達到寫書的效果。 ### Version 1.x.x gitbook剛推出的時候，我就在使用，這個時候的版本都是1.x系列。安裝方式是: ~~~ npm install -g gitbook ~~~ 目錄結構上，只要有`README.md`和`SUMMARY.md`即可。 使用方式: ~~~ gitbook build ~~~ 即可完成編譯。 ### Version 2.x.x 最近再看gitbook的時候，發現它已經推出了2.x系列，安裝方式也變化了。需要先刪除之前1.x系列版本，再安裝: ~~~ npm install -g gitbook-cli ~~~ ### editor 關于editor，其實有兩種選擇: - gitbook站點上edit，線上編輯 - 下載editor，本地編輯 ### 線上編輯 先說說線上編輯，畢竟我剛剛使用了下，就是web版本的應用。有一點特別的好處是可以綁定github repo，編輯直接保存在github上。省去了本地編輯，再push的過程。 但是我也發現了一點點不方便的地方，就是無法上傳整個目錄文件，必須一個一個上傳，且無法設置目錄。。。很蛋疼。 ### 本地編輯 就是一個本地軟件，可以本地編輯，應該是通過圖形化性質整合命令行，包含了build功能。1.x版本剛推出的時候，在window平臺下體驗過，會有再次打開丟失項目的情況，每次都要重新打開項目，很麻煩。但是新版應該有所改善。 本地編輯還有另外一個方式，就是我常用的手段：使用Sublime Text進行編輯，結合Markdown插件，產生預覽。最后通過git提交到遠程。 ### 目錄結構 官方的格式說明，[Format](http://help.gitbook.com/format/README.html)。必須的文件是`README.md`和`SUMMARY.md`。 ### 使用方法 ### init `gitbook init`,根據`SUMMARY.md`生成目錄。 ### build `gitbook build`，生成`_books`目錄。 ### serve `gitbook serve`, 開啟本地預覽。 ### 參考資料 - [Gitbook主頁](https://www.gitbook.com) - [Gitbook Help](http://help.gitbook.com/) - [Version 2.0說明](https://github.com/GitbookIO/gitbook/pull/562) - [github: GitbookIO](https://github.com/GitbookIO) - [gitbook editor](https://github.com/GitbookIO/editor)