背景
最近领导和产品wiki文档撰写员觉得有必要升级一下产品的wiki网站,之前的wiki网站是另一位同事在维护,使用的是facebook 的 docusaurus, 定制能力稍微差一点,页面没有搞的很美观,重要的是使用它 大部分时间要借助 git 与 markdown 这两个技术。撰写员并没有完全掌握这两个技术栈,所以在撰写时总是出现编译失败,无法发布文章的问题。其实这也是一些wiki框架的痛点,大部分是面向开发者,而非普通小白。为了解决这些问题,在目前wiki内容还不算多的情况下,要进行重新的选型,部署。
开源wiki框架海选
任务下达第一天 我就加班搜索了一番,开源的wiki开源项目,crm开源项目,以及建站项目。
找到了不少,以下简单列举一些。
基于公开使用,用于撰写产品文档撰写,宣传 这一目的,筛选掉了一批用于私人,企业内部知识库的框架。
为了方便撰写,要求git 提交,写文章需要流水线编译发布的框架抛弃了
页面不美观的框架,已经没有研究下的必要啦,如果页面设计的不美观,说明这个框架的UI设计,交互设计 没有投入太多资源,这会导致我们投入大量精力做定制开发。
需要投入大量开发成本的框架也Pass掉,为了就是开箱即用,不需要深度开发定制,所以筛掉了一大批CRM框架。
经过一轮搜索,发现最多的项目是应用于企业内部的知识库,或者个人私有知识库,可能这两方面比较好盈利吧。
这里介绍一下 github 搜索的技巧
- 使用topic进行搜索 如 https://github.com/topics/wiki
- 根据项目相同的topic进行搜索
- 看项目的宣传标语,面向的是谁,面向的场景是什么
吹尽黄沙始到金
经过一天的海选,最终我选定了这三个开源框架:
wikijs,wordpress 和一个国产的halo。
wikijs 看名字就知道,面向的场景就是wiki场景,基于nodejs vue,算是新起之秀,之前没接触过。生态并不算丰富。
wordpress,这个大家可能听到的比较多,php搭建的crm 内容建站平台,各种插件,主题非常丰富。生态比较完整,可以做付费知识平台,可以搭建官网,可以做外贸,反正很能打,当然功能多了,也要有人开发定制,运营。
halo,国产的,星比较高,coushude。
将这三个框架部署到公司内部服务器上,开放了体验权限,让领导和撰写员体验。
wikijs 的特性介绍
这个框架使用nodejs 和vue 来搭建,数据库推荐使用PostgreSQL,首先在UI页面上,它的排版和设计比较中规中矩,还有一个重要的是 支持的文章编辑器比较好用。

文档做的也像那一回事,还有一点是竞品也用这东西🤣。
wikijs的定制能力
在定制上面,我也查阅了一下资料,翻看了它的大部分文档和相关issues。
定制力方面,稍弱一些,不能说没有,但也不算多。
一直提的定制主题功能,两年了迟迟还没有发布。感觉目前开发进度后续乏力,其实主题这个功能做好了可以像wordpress那样形成一个小的生态圈,做付费定制化。
虽然目前还没拍板,但差不多就觉得用wiki.js 啦。
明年开始部署,配置,迁移工作。
结尾
2025年,就以这一篇文章作为介绍吧,这一年认知提升了不少,当你认为一件事已经无法改变了,那就改变对它的看法,将它看作试炼,让自己走向更高的垫脚石。
不要过分看重某一事物,过分看重你就会被它禁锢,从而看不到周围其他有价值的东西。
想办法让自己的价值多样化,而不是片面化。
最后放上今年的博客大数据统计
