之前因?yàn)楣ぷ鞯年P(guān)系，用 HTML 記錄文檔，實(shí)在太 low 了。之后一直想找個(gè)好用的文檔管理系統(tǒng)。要求其實(shí)也不太多，重要的就下面幾點(diǎn)。
- 文檔格式為文本格式，方便進(jìn) git，做版本管理、review 及回溯；
- 支持文本指令畫(huà) UML、流程圖、架構(gòu)圖等等圖解。圖解同樣需要進(jìn) git 管理；
- 方便上傳圖片并插入到指定位置，能簡(jiǎn)單控制圖片格式更好；
- 支持 TOC（Table Of Contents，章節(jié)目錄）；
- 支持文檔間跳轉(zhuǎn)，類(lèi)似 wiki；
- 支持搜索并跳轉(zhuǎn)，可以接受依賴(lài)于第三方搜索系統(tǒng)（如：ElasticSearch）的方案；
其中前四條可以用 markdown 類(lèi)寫(xiě)作工具來(lái)解決，很多 markdown 寫(xiě)作工作都支持上述的功能，例如：簡(jiǎn)書(shū)、作業(yè)部落、sublime text等等。倒是第五條開(kāi)始，支持得就比較少了，至于第六條，能做到的真是鳳毛麟角。
gitbook 一直是我個(gè)人比較喜歡的一個(gè)工具：支持插件，擴(kuò)展起來(lái)相對(duì)容易；基于 git + markdown，工具棧通用；支持章節(jié)管理和頁(yè)面間跳轉(zhuǎn)。雖然現(xiàn)在看起來(lái)沒(méi)有比較好用的搜索插件，但自己開(kāi)發(fā)一個(gè)也不是太難的事情。
于是最近試了試用 gitbook 來(lái)寫(xiě)一個(gè)簡(jiǎn)單的文檔。目錄中只有三個(gè)頁(yè)面。寫(xiě)作的編輯器我選擇了 gitbook 自帶的 mac 版本 editor。
可惜，用之后我真的非常惋惜和遺憾。
也許是編輯器自己的問(wèn)題，總是跳屏。在文檔最末寫(xiě)著寫(xiě)著，整個(gè)屏幕自動(dòng)翻頁(yè)到文首，看不到光標(biāo)。你接著輸入，屏幕又跳回到文末，你還能看到你輸入的內(nèi)容——光標(biāo)就沒(méi)動(dòng)過(guò)，動(dòng)的只有屏幕。
一款跳屏的軟件，還想對(duì)用戶收取月 $7 的費(fèi)用，真的也是醉了。
gitbook 是一個(gè)好的工具，同時(shí)它更是一個(gè)好的標(biāo)準(zhǔn)，借助 git + markdown 兩個(gè)開(kāi)放性的玩意，加上自己的 plugin 機(jī)制，給寫(xiě)作的人一個(gè)好的工具框架，支持全文本輸入，把諸如
word 一類(lèi)編輯器打成渣渣沒(méi)問(wèn)題。但如果不珍惜這么好的機(jī)遇，只是想著自己家賺錢(qián)，越做越小氣，這么多年了，連最基本的問(wèn)題都不能好好解決，除了『作死』，找不到更好的詞送他們。
PS：我還會(huì)繼續(xù)找這么一個(gè)好用的文檔管理系統(tǒng)。gitbook 作為一種寫(xiě)作的方式或者說(shuō)標(biāo)準(zhǔn)我也還會(huì)接著考慮。只是不會(huì)再用 gitbook 家自己的編輯器以及線上服務(wù)了。
