前言
隨著時(shí)代發(fā)展,互聯(lián)網(wǎng)上越來越多的信息,每個(gè)人都需要構(gòu)建自己的知識(shí)體系,才能將信息轉(zhuǎn)化成自己所掌握的。一個(gè)合適的工具是很重要的。
去年底我開始學(xué)習(xí)區(qū)塊鏈的相關(guān)知識(shí),也開始構(gòu)建自己知識(shí)體系的工具探索,首先確定了采用Markdown用于內(nèi)容的編寫。其次,嘗試了一系列的工具。
嘗試的各類工具體驗(yàn):
關(guān)于工具的體驗(yàn)如下:
如果用markdown, 有道體驗(yàn)不好,生成長(zhǎng)內(nèi)容的預(yù)覽總是有停頓感,很影響協(xié)作。最討厭的是在分享給別人純技術(shù)內(nèi)容筆記時(shí),不知道什么時(shí)候就提示有違禁詞停止分享。有道自己的關(guān)鍵詞過濾技術(shù)不過關(guān),國(guó)家相關(guān)部門又隨意下命令胡弄,簡(jiǎn)直了。停用。
采用gitbook,網(wǎng)速很慢;二級(jí)中文目錄非常別扭,需要來回調(diào)整中英文的名稱。
看云的二級(jí)目錄展開,讓我想起來很多年前的辦公軟件,總覺得缺乏美感;
其他的單純的mardown工具不支持貼圖,而我要貼大量的圖。采用圖床感覺又被綁定了第三方。
cmd_markdown的作業(yè)部落非常好用,用戶體驗(yàn)好,而且右側(cè)又有隨時(shí)生成的目錄結(jié)構(gòu),但是不支持大容量的書編寫,內(nèi)容非常多時(shí),達(dá)到一本書的內(nèi)容時(shí)相當(dāng)不容易維護(hù)。
我去年底寫的學(xué)習(xí)筆記如下,因?yàn)閮?nèi)容過多,不容易維護(hù),新版本已經(jīng)放棄在作業(yè)部落上編寫了。
區(qū)塊鏈設(shè)計(jì)與實(shí)現(xiàn)筆記v1 https://www.zybuluo.com/zhongdao/note/933849
有時(shí)為了實(shí)現(xiàn)目錄的序號(hào)自動(dòng)生成,我采用的是vscode以及toc的插件,序號(hào)生成的插件。cmd_markdown本身是支持自動(dòng)目錄生成的,但是不支持自動(dòng)添加序號(hào)。

在搜索工具的過程中,還發(fā)現(xiàn)了一個(gè)非常棒的在線markdown編輯器 stackedit.io,寫單篇文章非常好,遺憾的是不適合寫書和體系化的內(nèi)容。
https://stackedit.io/
R studio 提供的一個(gè)技術(shù)書籍編輯工具,還有其他類似的python技術(shù)文檔編寫工具看著頁(yè)面都很簡(jiǎn)潔,但是缺乏一些社交元素。
目前的工具平臺(tái)選擇
最后,雖然不是最滿意,我選擇了bookstack, 這是編寫書的一個(gè)開源平臺(tái)工具,用來知識(shí)體系的構(gòu)建目前也是可行的,一本書相當(dāng)于一個(gè)相對(duì)獨(dú)立的知識(shí)體系。 我也決定自己搭建。
bookstack的網(wǎng)站: https://www.bookstackapp.com/
我根據(jù)bookstack的官方文檔:https://www.bookstackapp.com/docs/admin/installation/
在阿里云上搭建了自己的bookstack, 因?yàn)閼械脗浒?,就采用?080端口,這里是我建立的平臺(tái)網(wǎng)址: http://btclearning.net:8080/books/
其中新版的區(qū)塊鏈技術(shù)學(xué)習(xí)筆記在這里:
區(qū)塊鏈學(xué)習(xí)筆記v3
在這個(gè)過程中,我發(fā)現(xiàn)我對(duì)構(gòu)建知識(shí)體系的工具需求如下:
- 一個(gè)平臺(tái),可以被瀏覽器訪問到。
- 支持markdown編輯。
- 支持圖片的Copy&Paste以及自動(dòng)上傳。
- 能比較容易地進(jìn)行章節(jié)的劃分和排序
- 比較方便地添加主題,章節(jié)。
- 能夠自動(dòng)生成目錄。
- 可以自動(dòng)增加序號(hào)。
8.社交協(xié)作寫書,用戶可以共同編輯,而且可以在內(nèi)容后面寫注釋和評(píng)價(jià)。 - 具有技術(shù)和藝術(shù)的美感。
bookstack并不完全滿足我的需要,但是這是我能找得到的最接近的能匹配需求的工具了,如果能將stackedit.io的在線markdown編輯器融入到bookstack,對(duì)目前我的需求而言就相對(duì)完美了。
如果需要對(duì)目錄章節(jié)增加序號(hào),可以先將內(nèi)容復(fù)制到 vscode 里,利用插件加上序號(hào),然后再?gòu)?fù)制和粘貼回bookstack里面。
使用bookstack的特點(diǎn)是可以添加多本書,每本書都可以成為一個(gè)知識(shí)的主題,也就意味著成為一個(gè)個(gè)相對(duì)獨(dú)立的知識(shí)體系。而書又與用戶相關(guān),所以可以多個(gè)用戶在一個(gè)平臺(tái)上編輯書的內(nèi)容,可以進(jìn)行評(píng)論。 bookstack還提供了用戶的注冊(cè),活動(dòng)記錄等功能。
下面是我建立的網(wǎng)站的首頁(yè):

也可以對(duì)章節(jié)進(jìn)行調(diào)整順序:

bookstack需要加強(qiáng)的部分
我認(rèn)為需要加強(qiáng)的是Markdown的編輯器,更加容易使用,符合大多數(shù)markdown編輯器的特性,例如自動(dòng)添加http鏈接,不必手工寫鏈接格式,自動(dòng)回車等。
另外就是需要加強(qiáng)其協(xié)作和社交的部分,例如每個(gè)人的頁(yè)面更加美觀一些,共同協(xié)作一本書的內(nèi)容的管理功能 ,可以作為個(gè)人的知識(shí)體系的首頁(yè)展示。
下面是目前的個(gè)人用戶所編輯的書的內(nèi)容的頁(yè)面:

最后,更符合中國(guó)的國(guó)情,例如通過微信的第三方賬號(hào)登錄。
我已經(jīng)在github上給作者反饋了一部分問題,有感興趣的php程序員可以自己進(jìn)行修改完善。 github地址: https://github.com/BookStackApp/BookStack
歡迎使用btclearning
對(duì)建立自己知識(shí)體系感興趣的朋友可以登錄 http://btclearning.net:8080 注冊(cè)一個(gè)用戶,試試編輯一本書或一個(gè)知識(shí)領(lǐng)域的內(nèi)容。
我買的阿里云服務(wù)器和相關(guān)域名,內(nèi)容也有備份機(jī)制,感興趣的可以自己搭建,怕麻煩的可以用我建立的網(wǎng)站。
備份的內(nèi)容可以很容易恢復(fù)到其他用bookstack建立的網(wǎng)站,有時(shí)間我也會(huì)把備份的內(nèi)容放在網(wǎng)上下載,所以可以放心使用。
經(jīng)過試用發(fā)現(xiàn)不滿意的,一個(gè)是可以自己修改源碼,一個(gè)是另外再尋找合適的工具,如果發(fā)現(xiàn)靠譜的可以推薦給我。
其他
知識(shí)體系工具的路線
寫書,寫多本書,其中交叉或者加上超鏈接引用,可以構(gòu)建自己的知識(shí)體系。
還有一種是通過編寫維基wiki來實(shí)現(xiàn)。 這2種思路有何異同,我還沒有深入思考和分析。
一個(gè)初步的印象就是wiki是網(wǎng)狀的鏈接結(jié)構(gòu),編輯難度稍高,知識(shí)是點(diǎn)狀的,跳轉(zhuǎn)的過程很方便,但是容易讓人分心和無(wú)法深入;markdown編輯的書是樹形的目錄結(jié)構(gòu),編輯難度低,知識(shí)的分類整理形式更強(qiáng)些,更能深入介紹。
拋磚引玉,歡迎大家討論。
php開發(fā)與開源運(yùn)營(yíng)
如果有php程序員看到,可以根據(jù)我的需求進(jìn)行開發(fā), 我來搭建和維護(hù)這個(gè)平臺(tái),或許就是一個(gè)對(duì)大家構(gòu)建各自的知識(shí)體系都有益處的事情。
若有空余時(shí)間的互聯(lián)網(wǎng)產(chǎn)品運(yùn)營(yíng)經(jīng)理,可以考慮組織一個(gè)小的團(tuán)隊(duì),把改進(jìn)后的適合中國(guó)人使用的bookstack運(yùn)營(yíng)起來,添加自助付費(fèi)和開通知識(shí)體系編輯的功能,像類似 作業(yè)部落一樣的商業(yè)化運(yùn)作,普通用戶免費(fèi) 使用,深度用戶付費(fèi),收入用于購(gòu)買足夠的帶寬和服務(wù)器資源,運(yùn)維資源,以及各位的開發(fā)與維護(hù)費(fèi)用,讓 btcleanring.net (或者其他申請(qǐng)的域名) 正式運(yùn)行起來,既能Cover住服務(wù)器和帶寬的費(fèi)用,又能給想建立自己知識(shí)體系卻又不想自己搭建服務(wù)器的人一個(gè)知識(shí)分享和構(gòu)建的平臺(tái)?;蛘哌@就是個(gè)開源的商業(yè)服務(wù)方案。
有想法的運(yùn)營(yíng)和php程序員可以聯(lián)系我, 通過簡(jiǎn)書的私信,或者注冊(cè)登錄 https://m.p2pnet.club 進(jìn)入?yún)^(qū)塊鏈學(xué)習(xí)團(tuán)隊(duì),at lijun即可。 或者郵件 junlicn (at) foxmail.com
博客:
編寫書可以構(gòu)建自己的知識(shí)體系,但是不能像博客一樣,很流暢地發(fā)布單獨(dú)的博文。 所以我也搭建了一個(gè)博客網(wǎng)站:
http://durpal.p2pnet.club
團(tuán)隊(duì)合作聊天工具:
為了方便討論書中內(nèi)容,團(tuán)隊(duì)成員共享即時(shí)信息,下載歷史資源,
試用與對(duì)比
我分別試用了網(wǎng)上最流行的2個(gè)開源工具, Rocket.chat 以及 Mattermost, 這里是我的安裝和試用過程:
Rocket.Chat 團(tuán)隊(duì)合作聊天工具安裝配置試用
團(tuán)隊(duì)合作聊天服務(wù)Mattermost在Ubuntu 16.04下的安裝配置與試用
雖然Rocket.chat是github上最流行的團(tuán)隊(duì)合作聊天工具,但是經(jīng)過嘗試,發(fā)現(xiàn)手機(jī)端不穩(wěn)定,而且初次登錄時(shí)會(huì)下載一大堆無(wú)用的內(nèi)容,能達(dá)到100M的空間占用,而且由于開發(fā)者眾多沒有人協(xié)調(diào),導(dǎo)致功能羅列太多失去易用性。
最后我決定使用Mattermost,因?yàn)橛袌F(tuán)隊(duì)在維護(hù),文檔,安裝,PC端手機(jī)端的功能都比較穩(wěn)定。
Mattermost
看效果可以注冊(cè)登錄這個(gè): 用 手機(jī)app, web, pc程序都可以訪問.
團(tuán)隊(duì)里可以建立多個(gè)頻道,例如專門建立一個(gè)頻道討論書的內(nèi)容,進(jìn)行評(píng)價(jià),一個(gè)頻道下載資源,一個(gè)頻道閑聊什么的。與微信群相比,即使是后加入的成員也可以看到之前的聊天記錄以及下載資源,比較適合課程學(xué)習(xí),或者團(tuán)隊(duì)的項(xiàng)目協(xié)作。
可以對(duì)歷史聊天記錄或者資源進(jìn)行評(píng)價(jià)。管理員可以刪除無(wú)用記錄。所有人都看到一樣的內(nèi)容,
https://about.mattermost.com/download/
手機(jī)端可以直接從github上下載:
https://github.com/mattermost/mattermost-mobile/releases
App填寫此地址,然后連接。
PC端可以通過瀏覽器訪問,或者安裝PC端軟件。
注冊(cè)也很簡(jiǎn)單,不需要登錄郵箱驗(yàn)證(后臺(tái)可以設(shè)置)。
試用賬號(hào)
賬戶名: user001
密碼: user001
如果要加入?yún)^(qū)塊鏈學(xué)習(xí)的討論群,這里是注冊(cè)邀請(qǐng)鏈接:
https://m.p2pnet.club/signup_user_complete/?id=wm9g85jtpty7zekidyw9b91pow