最近在北京參加轅詢老師的區(qū)塊鏈開發(fā)課程。有幸被選為班長,我就需要整理課程筆記給大家使用。
但我獨自整理了兩次課的筆記之后,發(fā)現(xiàn)如果只由我一個人來整理筆記,會有幾個問題:
錯別字。自己很難看出來,但別人其實讀一遍基本都能看出來,如果能隨手改掉就好了。
聽到同樣的課程內(nèi)容,不同知識水平的人的理解深度不同。我的知識有很多欠缺的地方,所以有部分內(nèi)容我的整理會有偏差、錯誤。比如,我對 Windows 中編程相關的操作不熟悉,就需要熟悉的同學補充。
時間問題和重復勞動:近3個小時的課程,如果只由我自己整理,最快也要課后第二天下午才能整理完,這會耽誤大家的使用。而除了我之外,肯定還有很多同學都在自己整理筆記,這其實也是某種程度上的重復勞動。
所以,我覺得應該采用一款云編輯工具,每次課程都選幾個人一起盡快整理出一個初級版筆記,先供大家學習使用。
然后大家在這個基礎上 都可以參與進來,特別是區(qū)塊鏈的概念或編程知識比較豐富的同學,可以幫助修改、優(yōu)化筆記。
可多人同時編輯,上課后當天晚上就可以整理好筆記,方便同學們使用。
所有愿意參與的人,之后都可以不斷優(yōu)化筆記。
有疑問的地方,或需要更豐富的知識才能講清楚的地方,任何人都可以直接在筆記中相關位置用3個問號來提問,看到的同學如果能回答,可以直接在筆記中回答。如果最終有大家都不能解答的問題,可以集中起來向老師提問。
對工具主要有兩個要求,最好都能滿足:
- 可以多人同時編輯
- 能用于 Markdown 格式。因為是多人協(xié)作,使用Markdown 格式能更好地保持格式一致、層次清晰。
如果實在找不到滿意的工具,只要先舍棄 Markdown 格式。
于是我開始搜尋各種工具,在這個過程中找到的比較好的工具:
石墨文檔、騰訊文檔:滿足多人同時編輯,性能很好。但不支持Markdown格式。
gitbook:支持Markdown,但二級目錄支持很差,有種想死的沖動。
HackMD: Markdown和多人同時編輯都支持,是我目前能找到的最合適我這個應用場景的工具。
去 HackMD 的GitHub地址查看,有三千多顆星,還不錯。
HackMD 的使用方式也非常簡單:先點擊 https://hackmd-ce.herokuapp.com/ ,右上角點擊登錄,通過GitHub登錄后。只需要新建文件,就會進入編輯頁面。你只需要將編輯頁面的網(wǎng)址發(fā)給協(xié)作者,他們就都可以進入編輯頁面。大家就可以同時進行協(xié)作編輯。到目前為止,我用到的Markdown語法都是支持的。
唯一的缺點是,這個項目是部署在 heroku 上面的,所以訪問速度不是那么好,且偶爾會斷掉。但因為是開源項目,如果你覺得它特別符合你的要求,你可以部署到自己的服務器上用。
如果你知道更好的工具,也請推薦給我,哈哈。