搭建公司产品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 小时前
day61(1.20)——leetcode面试经典150
面试·职场和发展
夏鹏今天学习了吗2 小时前
【LeetCode热题100(87/100)】最小路径和
算法·leetcode·职场和发展
一条咸鱼_SaltyFish4 小时前
远程鉴权中心设计:HTTP 与 gRPC 的技术决策与实践
开发语言·网络·网络协议·程序人生·http·开源软件·个人开发
踢足球09297 小时前
寒假打卡:2026-01-20
职场和发展·学习方法
武清伯MVP7 小时前
聊聊最近的一些面试体验
面试·职场和发展
a努力。8 小时前
字节Java面试被问:TCP的BBR拥塞控制算法原理
java·开发语言·python·tcp/ip·elasticsearch·面试·职场和发展
重生之后端学习9 小时前
19. 删除链表的倒数第 N 个结点
java·数据结构·算法·leetcode·职场和发展
weixin_457297109 小时前
大数据面试常见问题
大数据·面试·职场和发展
普贤莲花11 小时前
新生2026年1月20日---星期二(大寒)
程序人生·算法·leetcode
Access开发易登软件12 小时前
数据处理中的两大基石:何时选择Excel,何时考虑Access
数据库·信息可视化·excel·vba·access