搭建公司产品wiki的开源框架选型,注重介绍wikijs框架

背景

最近领导和产品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年,就以这一篇文章作为介绍吧,这一年认知提升了不少,当你认为一件事已经无法改变了,那就改变对它的看法,将它看作试炼,让自己走向更高的垫脚石。

不要过分看重某一事物,过分看重你就会被它禁锢,从而看不到周围其他有价值的东西。

想办法让自己的价值多样化,而不是片面化。

最后放上今年的博客大数据统计

相关推荐
漂视数字孪生世界2 小时前
项目案例|某水轮机数字孪生平台
运维·信息可视化·自动化·数字孪生·三维可视化
天真小巫4 小时前
2025.12.30总结
职场和发展
007php0074 小时前
Git 操作偏门指南:常用和隐藏命令与问题解决
java·git·面试·职场和发展·golang·jenkins·php
十八岁讨厌编程5 小时前
【算法训练营 · 补充】LeetCode Hot100(下)
算法·leetcode·职场和发展
元亓亓亓7 小时前
LeetCode热题100--64. 最小路径和--中等
算法·leetcode·职场和发展
hqyjzsb7 小时前
2026年AI证书选择攻略:当“平台绑定”与“能力通用”冲突,如何破局?
大数据·c语言·人工智能·信息可视化·职场和发展·excel·学习方法
有一个好名字7 小时前
力扣-递增的三元子序列
算法·leetcode·职场和发展
007php0079 小时前
通过程序对接地图api展示旅游数据列表
java·数据库·面试·职场和发展·golang·php·旅游