程序員能把邏輯梳理出來，是另一大技能！

使用 gitbook

之前整理的習(xí)慣是使用 Evernote，其實(shí)主要做的是收錄（輸入）的功能，東西多了，就難以消化掉（處理），以至于沒有總結(jié)（輸出）。Markdown 格式是我很喜歡的一種書寫格式，我覺得特別適合程序員，配合 gitbook，就能達(dá)到寫書的效果。

Version 1.x.x

gitbook 剛推出的時(shí)候，我就在使用，這個(gè)時(shí)候的版本都是 1.x 系列。安裝方式是:

npm install -g gitbook

目錄結(jié)構(gòu)上，只要有 README.md和 SUMMARY.md即可。

使用方式:

gitbook build

即可完成編譯。

Version 2.x.x

最近再看 gitbook 的時(shí)候，發(fā)現(xiàn)它已經(jīng)推出了 2.x 系列，安裝方式也變化了。需要先刪除之前 1.x 系列版本，再安裝:

npm install -g gitbook-cli

editor

關(guān)于 editor，其實(shí)有兩種選擇:

• gitbook 站點(diǎn)上 edit，線上編輯
• 下載 editor，本地編輯

線上編輯

先說說線上編輯，畢竟我剛剛使用了下，就是 web 版本的應(yīng)用。有一點(diǎn)特別的好處是可以綁定 github repo，編輯直接保存在 github 上。省去了本地編輯，再 push 的過程。

但是我也發(fā)現(xiàn)了一點(diǎn)點(diǎn)不方便的地方，就是無法上傳整個(gè)目錄文件，必須一個(gè)一個(gè)上傳，且無法設(shè)置目錄。。。很蛋疼。

本地編輯

就是一個(gè)本地軟件，可以本地編輯，應(yīng)該是通過圖形化性質(zhì)整合命令行，包含了 build 功能。1.x 版本剛推出的時(shí)候，在 window 平臺下體驗(yàn)過，會有再次打開丟失項(xiàng)目的情況，每次都要重新打開項(xiàng)目，很麻煩。但是新版應(yīng)該有所改善。

本地編輯還有另外一個(gè)方式，就是我常用的手段：使用 Sublime Text 進(jìn)行編輯，結(jié)合 Markdown 插件，產(chǎn)生預(yù)覽。最后通過 git 提交到遠(yuǎn)程。

目錄結(jié)構(gòu)

官方的格式說明，Format。必須的文件是README.md 和 SUMMARY.md。

使用方法

init

gitbook init,根據(jù) SUMMARY.md生成目錄。

build

gitbook build，生成 _books 目錄。

serve

gitbook serve, 開啟本地預(yù)覽。

參考資料

• Gitbook 主頁
• Gitbook Help
• Version 2.0 說明
• github: GitbookIO
• gitbook editor