09月04, 2019

一行代码都不用写,我是如何基于 Github 建立知识管理系统的?

思维导图

title

私有仓库免费了

工作多年以来,做工作笔记的习惯断断续续的坚持下来,算是 10 年的工作经验的沉淀。这些记录里有各种总结、日记、知识汇总,成为我最珍贵的数据。数据是无价的,为它们找到一个安全、长久、经济的家非常必要。 作为程序员,对 github 非常熟悉,它向个人提供免费、无限的公开仓库,有些朋友很早就用 github 作为知识托管平台使用。 但是早期 github 免费账户不能建私有仓库,这阻止了我将个人知识全面迁移到 github,还是希望为自己保留一些隐私。直到 2019 年, github 的个人私有仓库服务也免费了,我便开始研究如何直接利用 github 管理知识。

我的使用习惯

我是做软件开发工作的,主要的工作环境是:

working_env = aLaptop + me

我的知识主要围绕着工作产生,在开发过程中:

  • 遇到的问题,
  • 一些 bug 讨论,
  • 临时性的需求,
  • 有趣的碎片知识,

都会被随手记录下来。北京不止是一个伟大的城市,也是一个非常“大”的城市,每天的单程通勤时间在 1 小时左右。这一段时间里,我会漫无目的的思考,产生一些有趣的想法,或者解决之前一些遗留问题。一旦有有价值的想法,我会掏出手机:

  • 翻看之前的笔记记录,
  • 将想法记录下来。

总结一下:

  • 用电脑工作时,随时笔记。
  • 通勤时,随时查看
  • 通勤时,随手记

我是怎么做的?

用电脑工作时

我找到了一款以 Github 为数据托管平台的笔记软件——GitNote,目前支持所有主流桌面系统:

  • Linux
  • Mac
  • Windows
  • 移动端支持已经提上日程。

具体方法可以参考我之前的文章:

开源笔记软件 GitNote 配置及试用

重度使用 GitNote 几天,虽有小瑕疵,但没有重大 Bug,作者近期也会放出新版本,期待中。GitNote 看起来是这样子:

title

用电脑工作时的知识记录问题算是解决了,而且使用习惯上与之前习惯的云笔记软件几乎无差异,基本上做到了无痛切换。

通勤路上

通勤路上主要解决的是在没有电脑,只有手机的时候,怎么查看笔记;有突发想法的时候,怎么迅速把灵感记录下来。

由于所有的知识都被保存在 github 上,我找到一款github 客户端:openhub, 看起来这样:

title

可以清晰的看到笔记软件创建的文件夹,文件夹里就是笔记文件,直接点开就可以查看。移动场景下笔记阅读问题——解决!

title 上图是 openhub 的 issue 编辑界面。 在通勤、室外大脑会迸发出特别好的创意,需要能随时记录下来这些思想的火花。这些创意往往又不够正式,没必要纳入正式的笔记中,我直接利用 github 的 issue,在笔记仓库中发起讨论,以此记录碎片信息。这些信息也会实时保存子 github 的项目 issue 中,非常方便。当回到电脑旁边的时候,就可以整理成完整的笔记了。整理过的 issue 直接 close 就好,万一又需要,后期还可以浏览这些 closed issue。

整个系统什么样

title

可以看到,所有的笔记、图片、讨论都在 github 上托管,只要按照规范操作,数据安全无虞。GitNote、openhub 都是围绕着 github 工作的。

所有数据都在你的控制之下,而且目前来看,不用担心 github 关掉的问题,这些数据在你有生之年都会存在吧。

本文链接:http://www.thinkinpython.com/post/github_based_knowledge_management.html

-- EOF --