用 Hexo 做个人 Wiki 知识管理系统

2017-03-13 19:56:03 +08:00
 zthxxx

起始

知识是自己构建出来的,不是别人灌输的,也不是看了各种资料背住就完了。所谓构建,是指接受信息输入之后,通过信息整理加工,消化转变为自己理解的内容,并分类记录在脑部对应类别的不同层次区域。

就像一个帝国的建立和发展过程,不断的累积资本,转化为力量。通过知识加工这个二次学习的过程,能让我们更加牢固的记住关键知识和产生更加深入的理解。

一直希望寻找一种相对优雅、我比较喜欢的方式来做知识管理,帮助知识积累构建;经过尝试了手写笔记本、 OneNote 、 Evernote 、为知笔记等之后,最终选择用 个人 Wiki 系统 来做自己的知识管理。然而天下 Wiki 千千万,选择困难症患者到底该选哪一种呢?

我试了时下好几个流行的、推荐者比较多的 Wiki 系统,但是多少都有些小细节让我不是很满意。在我的 Wiki 首页 可以看到我对知识管理和这几个 Wiki 系统的一些简单的看法,以及为此自己开坑了个 Wiki 的轮子

轮子

先放上上我经过了这些使用之后,整理出自己对 个人 Wiki 系统的需求:

嗯,所以以上这些也是我自己 Wiki 系统的特性了吧~~

借用 Hexo 博客系统的框架,仿照 Wikitten 的样式,写了一个针对于个人 Wiki 的主题 ** [hexo-theme-Wikitten] **。

先放上两个链接:

我的个人 Wiki 地址:https://wiki.zthxxx.me/

Wikitten 主题地址:https://github.com/zthxxx/hexo-theme-Wikitten

再放一个预览的截图:

嘛,样式是跟 victorstanciuWikitten 一样的(人家有 MIT LICENSE 的,并且我提到时也都有注明出处),之所以选择 Wikitten ,是因为我觉得这个 Wiki 系统最接近我自己对个人 Wiki 的需求,并且样式也很简洁。不过相比起来,代码就完全不一样了;人家是 PHP ,我这是 Hexo 的主题,不需要后台,可以直接挂在 Github Pages 上,省去了服务器;原本只支持搜索标题的,我也给改到支持全文搜索了。

浅谈个人 Wiki 系统

个人 Wiki 对我的意义大概就是 知识的消化、积累、归类整理,于是我也总结了一套觉得比较合理和适用于自己的简单知识管理流程:

  1. 通过网页、 RSS 、微信等网络渠道作为知识获取来源。
  2. 通过笔记系统(手写笔记、 OneNote 、 Evernote )初步筛选有价值有针对性的信息,收藏信息,分类整理,做读后要点笔记记录。
  3. 自己平时突然想到或总结的一两句话,或很零碎的点子、灵感,初步消化的内容,则用 Wiki 记录。
  4. 最后当 Wiki 在某版块有一定量后,将这方面笔记和 Wiki 中的内容重读,整理和提炼,二次消化精炼再加上自己的感悟和理解,写成文章发表在 博客 上。

在使用中,笔记系统 主大块信息的分类和整理Wiki 主零碎知识的积累,而 博客 只在于

Wiki 中某一版块刚建时,可能只有很少内容或者就一句话,但是通过这种使用流程,日积月累,这方面的事物接触得多了,零散的知识也就多了,那么 Wiki 中这个版块记录的内容也就会变多了,也就是通过积累,把原本大量碎片化的知识结构化整理起来了

汇总参考

顺便也汇总说一下我用过一些 Wiki 系统的特点,与其跟我自身需求的差异吧。

[注:以下仅代表个人观点,所述特点因个人关注点而带有严重的片面性,轻喷,希望有不同意见的朋友也来补充一些自己的观点。]

00 - Wikitten

01 - TiddlyWiki

02 - MediaWiki

03 - Wiko

04 - MDwiki

05 - VimWiki

06 - DokuWiki

07 - Simiki


后续

嘛,看了这么多,总的来说,hexo-theme-Wikitten 的轮子还是很符合我自己的使用习惯;希望在用 Hexo 的朋友,有需要个人 Wiki 系统的,也来试一下下这个主题;后续一堆 Bug 和 TODO List 正在维护,欢迎有兴趣的来提提 Pull request 。

42273 次点击
所在节点    分享创造
135 条回复
nicoljiang
2017-03-14 20:08:09 +08:00
TankyWoo
2017-03-14 20:49:16 +08:00
@zthxxx 👍

每个人都有自己的理解,实现自己最满意的成果,就是最好的。这个侧边栏主要和主题的实现有关,或许之后我写新的主题,也会借鉴你得 :)

另外,关于这个:

> 搜索功能用 python 整合资源应该也算容易吧,难道是因为没想到优雅的展示形式?

不知具体如何弄?目前来看,必须前端支持才能动态搜索,比如检索站点 xml 文件等。
TankyWoo
2017-03-14 20:51:38 +08:00
@nicoljiang hello ,发生啥了?
zthxxx
2017-03-14 21:00:15 +08:00
@nicoljiang
@TankyWoo www.tankywoo.com 怎么啦?四川联通网打不开啊, blog 和 wiki 的二级域名能打开,猜测是不是根本没有 www 的二级域名?[手动 doge]
nicoljiang
2017-03-14 21:06:34 +08:00
@TankyWoo
@zthxxx

Hello Gay! (要加 https ,虽然证书不可信)
zthxxx
2017-03-14 21:10:33 +08:00
@TankyWoo 同为静态页面,关于搜索,我没有特别优雅的实现,只有能用的,要么用第三方搜索,要么 python 生成时生成一个含所有 wiki 条目文本内容的文件,前端 ajax 固定请求这个文件,然后正则字符串搜索。。。。
nicoljiang
2017-03-14 21:13:27 +08:00
@zthxxx 一直以来很想问一个问题,程序员嘴里的优雅是什么意思?
zthxxx
2017-03-14 21:29:07 +08:00
@nicoljiang 无代码高亮请见谅
C style:
// exchange
int a = 1, b = 2, tmp = 0;
tmp = a;
a = b;
b = tmp;

pythonic:
# exchange
a, b = b, a
TankyWoo
2017-03-14 22:08:20 +08:00
@zthxxx 是啊,目前考虑到的就是类似的方式。之前我还想更简单点,类似 V2EX ,丢给 google 去搜索……但是这个又涉及到一个收录的问题,毕竟个人小站不易被收录全。

@nicoljiang www 域名没配 https ,跳转到一个测试页面去了,忽略……
nicoljiang
2017-03-14 22:32:28 +08:00
@TankyWoo 嗯,就是无意中看到亮点的感觉。

@zthxxx 就是语法灵活咯。
jwangkun
2017-03-14 22:44:54 +08:00
为什么我用 Travis 构建完后,生成 index.html 值空白的
zthxxx
2017-03-14 22:47:51 +08:00
@nicoljiang 之前看到过一篇文章大概讲了下优雅的定义,刚刚翻了下没找到;肯定不止是语法灵活啦,用我的话说,大概是 [在完成同样功能时,两种方法其中一种更简单、更高效、易于扩展,冗余量低,实现方式更符合现代软件工程流程、更符合人的思维方式而不是机器的工作方式] ,就称这种方法比另一种更优雅。
zthxxx
2017-03-14 22:49:13 +08:00
@jwangkun 看看 Travis 的日志吧,这种情况应该是报错了
lhw45202
2017-03-14 22:58:43 +08:00
看起来不错
jwangkun
2017-03-14 23:01:58 +08:00
@zthxxx 关键是没报错,各个文件夹何页面都生成了只是 HTML 的内容为空
zthxxx
2017-03-14 23:17:19 +08:00
@jwangkun 如果你改过主题模板的话,可能是 layout 模板的语法出错了导致的生成空文件。没改过的话,可能跟 node Hexo 版本有关,再不是就在本地生成一下,正常的话就应该是 travis 构建脚本出错了;总之你的问题不在于为什么 HTML 为空,而是你应该自己学着排查问题,一步步缩小范围,跟踪确定 Bug 具体引发位置。
nicoljiang
2017-03-14 23:30:58 +08:00
@zthxxx 了解。。。
yangxuan8282
2017-03-15 00:27:30 +08:00
@zthxxx gogs 其实本来不是干这个的,不过有 wiki 功能,类似 github 的 wiki ,官方有 docker 镜像,搭建方便,详情见其 README: https://github.com/gogits/gogs/blob/master/README_ZH.md
wolffn
2017-03-15 02:48:38 +08:00
我也是试了一堆之后,还是绕回来有道笔记了。。。
mudan
2017-03-15 06:32:16 +08:00
相比 wiki 还是觉得 emacs org mode 必须适合我,因为根本不需要管部署或者其他依赖软件支持,另外关于知识管理我以为最好办法就是每天写日记,需要的不是管理摘录了多少网页,而只是需要管理写了几篇日记。

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/347176

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX