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

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

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

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

相关推荐
码界筑梦坊34 分钟前
325-基于Python的校园卡消费行为数据可视化分析系统
开发语言·python·信息可视化·django·毕业设计
2501_9011478338 分钟前
面试必看:优势洗牌
笔记·学习·算法·面试·职场和发展
网安墨雨1 小时前
Python自动化一------pytes与allure结合生成测试报告
开发语言·自动化测试·软件测试·python·职场和发展·自动化
铉铉这波能秀1 小时前
LeetCode Hot100 中 enumerate 函数的妙用(2026.2月版)
数据结构·python·算法·leetcode·职场和发展·开发
南极星10051 小时前
我的创作纪念日--128天
java·python·opencv·职场和发展
码界筑梦坊1 小时前
327-基于Django的兰州空气质量大数据可视化分析系统
python·信息可视化·数据分析·django·毕业设计·数据可视化
觉醒大王14 小时前
AI写的青基中了
人工智能·笔记·深度学习·学习·职场和发展·学习方法
逍遥德14 小时前
如何学编程之01.理论篇.如何通过阅读代码来提高自己的编程能力?
前端·后端·程序人生·重构·软件构建·代码规范
程序员agions14 小时前
2026年,“配置工程师“终于死绝了
前端·程序人生
程序员敲代码吗15 小时前
面试中sessionStorage问题引发深度探讨
面试·职场和发展