之前因?yàn)楣ぷ鞯年P(guān)系毡熏，用 HTML 記錄文檔坦敌，實(shí)在太 low 了。之后一直想找個(gè)好用的文檔管理系統(tǒng)痢法。要求其實(shí)也不太多狱窘，重要的就下面幾點(diǎn)。
- 文檔格式為文本格式财搁，方便進(jìn) git蘸炸，做版本管理、review 及回溯妇拯；
- 支持文本指令畫 UML幻馁、流程圖、架構(gòu)圖等等圖解越锈。圖解同樣需要進(jìn) git 管理仗嗦；
- 方便上傳圖片并插入到指定位置，能簡(jiǎn)單控制圖片格式更好甘凭；
- 支持 TOC（Table Of Contents稀拐，章節(jié)目錄）；
- 支持文檔間跳轉(zhuǎn)丹弱，類似 wiki德撬；
- 支持搜索并跳轉(zhuǎn)铲咨，可以接受依賴于第三方搜索系統(tǒng)（如：ElasticSearch）的方案；
其中前四條可以用 markdown 類寫作工具來(lái)解決蜓洪，很多 markdown 寫作工作都支持上述的功能纤勒，例如：簡(jiǎn)書、作業(yè)部落隆檀、sublime text等等摇天。倒是第五條開始，支持得就比較少了恐仑，至于第六條泉坐，能做到的真是鳳毛麟角。
gitbook 一直是我個(gè)人比較喜歡的一個(gè)工具：支持插件裳仆，擴(kuò)展起來(lái)相對(duì)容易腕让；基于 git + markdown，工具棧通用歧斟；支持章節(jié)管理和頁(yè)面間跳轉(zhuǎn)纯丸。雖然現(xiàn)在看起來(lái)沒有比較好用的搜索插件，但自己開發(fā)一個(gè)也不是太難的事情构捡。
于是最近試了試用 gitbook 來(lái)寫一個(gè)簡(jiǎn)單的文檔液南。目錄中只有三個(gè)頁(yè)面。寫作的編輯器我選擇了 gitbook 自帶的 mac 版本 editor勾徽。
可惜滑凉，用之后我真的非常惋惜和遺憾。
也許是編輯器自己的問(wèn)題喘帚，總是跳屏畅姊。在文檔最末寫著寫著，整個(gè)屏幕自動(dòng)翻頁(yè)到文首吹由，看不到光標(biāo)若未。你接著輸入，屏幕又跳回到文末倾鲫，你還能看到你輸入的內(nèi)容——光標(biāo)就沒動(dòng)過(guò)粗合，動(dòng)的只有屏幕。
一款跳屏的軟件乌昔，還想對(duì)用戶收取月 $7 的費(fèi)用隙疚，真的也是醉了。
gitbook 是一個(gè)好的工具磕道，同時(shí)它更是一個(gè)好的標(biāo)準(zhǔn)供屉，借助 git + markdown 兩個(gè)開放性的玩意，加上自己的 plugin 機(jī)制，給寫作的人一個(gè)好的工具框架伶丐，支持全文本輸入悼做，把諸如
word 一類編輯器打成渣渣沒問(wèn)題。但如果不珍惜這么好的機(jī)遇哗魂，只是想著自己家賺錢肛走，越做越小氣，這么多年了录别，連最基本的問(wèn)題都不能好好解決羹与，除了『作死』，找不到更好的詞送他們庶灿。
PS：我還會(huì)繼續(xù)找這么一個(gè)好用的文檔管理系統(tǒng)。gitbook 作為一種寫作的方式或者說(shuō)標(biāo)準(zhǔn)我也還會(huì)接著考慮吃衅。只是不會(huì)再用 gitbook 家自己的編輯器以及線上服務(wù)了往踢。
