前言
隨著時(shí)代發(fā)展,互聯(lián)網(wǎng)上越來(lái)越多的信息吸占,每個(gè)人都需要構(gòu)建自己的知識(shí)體系晴叨,才能將信息轉(zhuǎn)化成自己所掌握的。一個(gè)合適的工具是很重要的矾屯。
去年底我開(kāi)始學(xué)習(xí)區(qū)塊鏈的相關(guān)知識(shí)兼蕊,也開(kāi)始構(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)鍵詞過(guò)濾技術(shù)不過(guò)關(guān)势似,國(guó)家相關(guān)部門又隨意下命令胡弄拌夏,簡(jiǎn)直了僧著。停用。
采用gitbook障簿,網(wǎng)速很慢盹愚;二級(jí)中文目錄非常別扭,需要來(lái)回調(diào)整中英文的名稱站故。
看云的二級(jí)目錄展開(kāi)皆怕,讓我想起來(lái)很多年前的辦公軟件,總覺(jué)得缺乏美感西篓;
其他的單純的mardown工具不支持貼圖愈腾,而我要貼大量的圖。采用圖床感覺(jué)又被綁定了第三方岂津。
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)容過(guò)多,不容易維護(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)安拟。
在搜索工具的過(guò)程中蛤吓,還發(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è)開(kāi)源平臺(tái)工具泼疑,用來(lá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è)過(guò)程中会油,我發(fā)現(xiàn)我對(duì)構(gòu)建知識(shí)體系的工具需求如下:
- 一個(gè)平臺(tái)个粱,可以被瀏覽器訪問(wèn)到。
- 支持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ó)情账千,例如通過(guò)微信的第三方賬號(hào)登錄。
我已經(jīng)在github上給作者反饋了一部分問(wèn)題哄褒,有感興趣的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)過(guò)試用發(fā)現(xiàn)不滿意的民鼓,一個(gè)是可以自己修改源碼,一個(gè)是另外再尋找合適的工具蓬抄,如果發(fā)現(xiàn)靠譜的可以推薦給我丰嘉。
其他
知識(shí)體系工具的路線
寫書,寫多本書嚷缭,其中交叉或者加上超鏈接引用饮亏,可以構(gòu)建自己的知識(shí)體系。
還有一種是通過(guò)編寫維基wiki來(lái)實(shí)現(xiàn)阅爽。 這2種思路有何異同路幸,我還沒(méi)有深入思考和分析。
一個(gè)初步的印象就是wiki是網(wǎng)狀的鏈接結(jié)構(gòu)优床,編輯難度稍高劝赔,知識(shí)是點(diǎn)狀的,跳轉(zhuǎn)的過(guò)程很方便胆敞,但是容易讓人分心和無(wú)法深入着帽;markdown編輯的書是樹(shù)形的目錄結(jié)構(gòu),編輯難度低移层,知識(shí)的分類整理形式更強(qiáng)些仍翰,更能深入介紹。
拋磚引玉观话,歡迎大家討論予借。
php開(kāi)發(fā)與開(kāi)源運(yùn)營(yíng)
如果有php程序員看到,可以根據(jù)我的需求進(jìn)行開(kāi)發(fā), 我來(lái)搭建和維護(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)起來(lái)挣跋,添加自助付費(fèi)和開(kāi)通知識(shí)體系編輯的功能,像類似 作業(yè)部落一樣的商業(yè)化運(yùn)作狞换,普通用戶免費(fèi) 使用避咆,深度用戶付費(fèi),收入用于購(gòu)買足夠的帶寬和服務(wù)器資源修噪,運(yùn)維資源查库,以及各位的開(kāi)發(fā)與維護(hù)費(fèi)用,讓 btcleanring.net (或者其他申請(qǐng)的域名) 正式運(yùn)行起來(lái)黄琼,既能Cover住服務(wù)器和帶寬的費(fèi)用樊销,又能給想建立自己知識(shí)體系卻又不想自己搭建服務(wù)器的人一個(gè)知識(shí)分享和構(gòu)建的平臺(tái)∈嗜伲或者這就是個(gè)開(kāi)源的商業(yè)服務(wù)方案现柠。
有想法的運(yùn)營(yíng)和php程序員可以聯(lián)系我, 通過(guò)簡(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è)開(kāi)源工具, Rocket.chat 以及 Mattermost, 這里是我的安裝和試用過(guò)程:
Rocket.Chat 團(tuán)隊(duì)合作聊天工具安裝配置試用
團(tuán)隊(duì)合作聊天服務(wù)Mattermost在Ubuntu 16.04下的安裝配置與試用
雖然Rocket.chat是github上最流行的團(tuán)隊(duì)合作聊天工具闰歪,但是經(jīng)過(guò)嘗試嚎研,發(fā)現(xiàn)手機(jī)端不穩(wěn)定,而且初次登錄時(shí)會(huì)下載一大堆無(wú)用的內(nèi)容库倘,能達(dá)到100M的空間占用临扮,而且由于開(kāi)發(fā)者眾多沒(méi)有人協(xié)調(diào),導(dǎo)致功能羅列太多失去易用性教翩。
最后我決定使用Mattermost杆勇,因?yàn)橛袌F(tuán)隊(duì)在維護(hù),文檔饱亿,安裝蚜退,PC端手機(jī)端的功能都比較穩(wěn)定闰靴。
Mattermost
看效果可以注冊(cè)登錄這個(gè): 用 手機(jī)app, web, pc程序都可以訪問(wèn).
團(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
訪問(wèn):
https://m.p2pnet.club/
App填寫此地址系忙,然后連接诵盼。
PC端可以通過(guò)瀏覽器訪問(wèn),或者安裝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