前言
随着时代发展,互联网上越来越多的信息,每个人都需要构建自己的知识体系,才能将信息转化成自己所掌握的。一个合适的工具是很重要的。
去年底我开始学习区块链的相关知识,也开始构建自己知识体系的工具探索,首先确定了采用Markdown用于内容的编写。其次,尝试了一系列的工具。
尝试的各类工具体验:
关于工具的体验如下:
如果用markdown, 有道体验不好,生成长内容的预览总是有停顿感,很影响协作。最讨厌的是在分享给别人纯技术内容笔记时,不知道什么时候就提示有违禁词停止分享。有道自己的关键词过滤技术不过关,国家相关部门又随意下命令胡弄,简直了。停用。
采用gitbook,网速很慢;二级中文目录非常别扭,需要来回调整中英文的名称。
看云的二级目录展开,让我想起来很多年前的办公软件,总觉得缺乏美感;
其他的单纯的mardown工具不支持贴图,而我要贴大量的图。采用图床感觉又被绑定了第三方。
cmd_markdown的作业部落非常好用,用户体验好,而且右侧又有随时生成的目录结构,但是不支持大容量的书编写,内容非常多时,达到一本书的内容时相当不容易维护。
我去年底写的学习笔记如下,因为内容过多,不容易维护,新版本已经放弃在作业部落上编写了。
区块链设计与实现笔记v1 https://www.zybuluo.com/zhongdao/note/933849
有时为了实现目录的序号自动生成,我采用的是vscode以及toc的插件,序号生成的插件。cmd_markdown本身是支持自动目录生成的,但是不支持自动添加序号。
在搜索工具的过程中,还发现了一个非常棒的在线markdown编辑器 stackedit.io,写单篇文章非常好,遗憾的是不适合写书和体系化的内容。
https://stackedit.io/
R studio 提供的一个技术书籍编辑工具,还有其他类似的python技术文档编写工具看着页面都很简洁,但是缺乏一些社交元素。
目前的工具平台选择
最后,虽然不是最满意,我选择了bookstack, 这是编写书的一个开源平台工具,用来知识体系的构建目前也是可行的,一本书相当于一个相对独立的知识体系。 我也决定自己搭建。
bookstack的网站: https://www.bookstackapp.com/
我根据bookstack的官方文档:https://www.bookstackapp.com/docs/admin/installation/
在阿里云上搭建了自己的bookstack, 因为懒得备案,就采用了8080端口,这里是我建立的平台网址: http://btclearning.net:8080/books/
其中新版的区块链技术学习笔记在这里:
区块链学习笔记v3
在这个过程中,我发现我对构建知识体系的工具需求如下:
- 一个平台,可以被浏览器访问到。
- 支持markdown编辑。
- 支持图片的Copy&Paste以及自动上传。
- 能比较容易地进行章节的划分和排序
- 比较方便地添加主题,章节。
- 能够自动生成目录。
- 可以自动增加序号。
8.社交协作写书,用户可以共同编辑,而且可以在内容后面写注释和评价。 - 具有技术和艺术的美感。
bookstack并不完全满足我的需要,但是这是我能找得到的最接近的能匹配需求的工具了,如果能将stackedit.io的在线markdown编辑器融入到bookstack,对目前我的需求而言就相对完美了。
如果需要对目录章节增加序号,可以先将内容复制到 vscode 里,利用插件加上序号,然后再复制和粘贴回bookstack里面。
使用bookstack的特点是可以添加多本书,每本书都可以成为一个知识的主题,也就意味着成为一个个相对独立的知识体系。而书又与用户相关,所以可以多个用户在一个平台上编辑书的内容,可以进行评论。 bookstack还提供了用户的注册,活动记录等功能。
下面是我建立的网站的首页:
也可以对章节进行调整顺序:
bookstack需要加强的部分
我认为需要加强的是Markdown的编辑器,更加容易使用,符合大多数markdown编辑器的特性,例如自动添加http链接,不必手工写链接格式,自动回车等。
另外就是需要加强其协作和社交的部分,例如每个人的页面更加美观一些,共同协作一本书的内容的管理功能 ,可以作为个人的知识体系的首页展示。
下面是目前的个人用户所编辑的书的内容的页面:
最后,更符合中国的国情,例如通过微信的第三方账号登录。
我已经在github上给作者反馈了一部分问题,有感兴趣的php程序员可以自己进行修改完善。 github地址: https://github.com/BookStackApp/BookStack
欢迎使用btclearning
对建立自己知识体系感兴趣的朋友可以登录 http://btclearning.net:8080 注册一个用户,试试编辑一本书或一个知识领域的内容。
我买的阿里云服务器和相关域名,内容也有备份机制,感兴趣的可以自己搭建,怕麻烦的可以用我建立的网站。
备份的内容可以很容易恢复到其他用bookstack建立的网站,有时间我也会把备份的内容放在网上下载,所以可以放心使用。
经过试用发现不满意的,一个是可以自己修改源码,一个是另外再寻找合适的工具,如果发现靠谱的可以推荐给我。
其他
知识体系工具的路线
写书,写多本书,其中交叉或者加上超链接引用,可以构建自己的知识体系。
还有一种是通过编写维基wiki来实现。 这2种思路有何异同,我还没有深入思考和分析。
一个初步的印象就是wiki是网状的链接结构,编辑难度稍高,知识是点状的,跳转的过程很方便,但是容易让人分心和无法深入;markdown编辑的书是树形的目录结构,编辑难度低,知识的分类整理形式更强些,更能深入介绍。
抛砖引玉,欢迎大家讨论。
php开发与开源运营
如果有php程序员看到,可以根据我的需求进行开发, 我来搭建和维护这个平台,或许就是一个对大家构建各自的知识体系都有益处的事情。
若有空余时间的互联网产品运营经理,可以考虑组织一个小的团队,把改进后的适合中国人使用的bookstack运营起来,添加自助付费和开通知识体系编辑的功能,像类似 作业部落一样的商业化运作,普通用户免费 使用,深度用户付费,收入用于购买足够的带宽和服务器资源,运维资源,以及各位的开发与维护费用,让 btcleanring.net (或者其他申请的域名) 正式运行起来,既能Cover住服务器和带宽的费用,又能给想建立自己知识体系却又不想自己搭建服务器的人一个知识分享和构建的平台。或者这就是个开源的商业服务方案。
有想法的运营和php程序员可以联系我, 通过简书的私信,或者注册登录 https://m.p2pnet.club 进入区块链学习团队,at lijun即可。 或者邮件 junlicn (at) foxmail.com
博客:
编写书可以构建自己的知识体系,但是不能像博客一样,很流畅地发布单独的博文。 所以我也搭建了一个博客网站:
http://durpal.p2pnet.club
团队合作聊天工具:
为了方便讨论书中内容,团队成员共享即时信息,下载历史资源,
试用与对比
我分别试用了网上最流行的2个开源工具, Rocket.chat 以及 Mattermost, 这里是我的安装和试用过程:
团队合作聊天服务Mattermost在Ubuntu 16.04下的安装配置与试用
虽然Rocket.chat是github上最流行的团队合作聊天工具,但是经过尝试,发现手机端不稳定,而且初次登录时会下载一大堆无用的内容,能达到100M的空间占用,而且由于开发者众多没有人协调,导致功能罗列太多失去易用性。
最后我决定使用Mattermost,因为有团队在维护,文档,安装,PC端手机端的功能都比较稳定。
Mattermost
看效果可以注册登录这个: 用 手机app, web, pc程序都可以访问.
团队里可以建立多个频道,例如专门建立一个频道讨论书的内容,进行评价,一个频道下载资源,一个频道闲聊什么的。与微信群相比,即使是后加入的成员也可以看到之前的聊天记录以及下载资源,比较适合课程学习,或者团队的项目协作。
可以对历史聊天记录或者资源进行评价。管理员可以删除无用记录。所有人都看到一样的内容,
https://about.mattermost.com/download/
手机端可以直接从github上下载:
https://github.com/mattermost/mattermost-mobile/releases
App填写此地址,然后连接。
PC端可以通过浏览器访问,或者安装PC端软件。
注册也很简单,不需要登录邮箱验证(后台可以设置)。
试用账号
账户名: user001
密码: user001
如果要加入区块链学习的讨论群,这里是注册邀请链接:
https://m.p2pnet.club/signup_user_complete/?id=wm9g85jtpty7zekidyw9b91pow