Wiki系列(一):Wiki系统选择
  分类: 佳软推荐   评论: 8 条

Wiki系列(一):Wiki系统选择

in 佳软推荐 with 8 comment

随着工作和项目经验的积累,有很多知识点需要整理,其中有关开发或者技术方面的,我想搭建一个 Wiki 系统,既可以方便自己查询,也给有需要的人参考,工欲善其事必先利其器,所以这篇就来写下 Wiki 系统的选择。

待选

首先,我结合已知的第三方 Wiki 系统,以及网上搜索的比较火的开源项目,整理出以下的待选列表。

筛选

接下来从不同方面对上面的待选列表进行逐一筛选。

自定义程度

语雀

看云

第三方 Wiki 系统,如「语雀」和「看云」,我在使用过程中发现以下几点不足:

基于以上问题,我选择放弃第三方的 Wiki 系统,转而使用开源项目搭建自己的 Wiki。

产品定位

Notion

Notion」从去年开始在国内逐渐变得很火,虽然可以用来做 Wiki,但是比 Wiki 更全,更强大,但仅仅作为 Wiki 又显得不够简洁,不太像一个 Wiki,这是我放弃 Notion 的一个原因。

可以看下少数派的这篇文章「想要玩转 Notion?你需要这份快速上手指南」,就能理解我说的不简洁的意思了,当然并不是说 Notion 不好,只是在我看来做 Wiki 可能过于「重」了。

访问速度

Notion」官网目前访问速度还可以,但是之前一直都很慢,基于国内网络的情况,说不准什么时候又会给屏蔽了,所以这是放弃 Notion 的另一个原因。

部署复杂度

既然要使用开源项目部署 Wiki,那「GitBook」和「VuePress」是一定要考虑的。

GitBook

VuePress

客观来讲,GitBook 和 VuePress 界面相对简洁美观,部署及页面编写并不复杂,具体部署可参考下方链接。

但是相较于「docsify」来说,简直是小巫见大巫,docsify 作为 Wiki 系统应该是我见过最轻量级的,而且界面美观,自定义程度很高。

找到「docsify」的时候,我觉得就是它了。

docsify

docsify

docsify」有多轻量级呢?虽然官方提供了构建工具,但你完全可以不使用构建工具,直接使用一个 index.html 就可以开始 Wiki 的内容制作了,详细内容可以查看「快速开始」。

当然,docsify 并不只是轻量,还包含以下特性(官方说法):

在我看来,docsify 的特点如下:

要说唯一的不足之处,可能就是对 SEO 的支持不太好,这点看个人取舍吧,就我个人而言,主要还是用于记录和查询技术知识,所以 SEO 对我而言并不重要。

以上就是我选择 Wiki 的全部内容了,综合各方面因素,最后选择了接近完美的极轻量级的「docsify」,下一篇就来写一下 docsify 的搭建及各项设置。

相关阅读:

Wiki系列(二):docsify部署及配置

欢迎关注我的公众号,及时获取最新文章推送。