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

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

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

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

相关推荐
知识分享小能手4 小时前
R语言入门学习教程,从入门到精通,R语言局部整体型数据可视化(10)
学习·信息可视化·r语言
knight_9___4 小时前
LLM工具调用面试篇6
人工智能·python·面试·职场和发展·llm·agent
人道领域5 小时前
【LeetCode刷题日记】掌握二叉树遍历:栈实现的三种绝妙方法
算法·leetcode·职场和发展
1104.北光c°6 小时前
【AI核心概念讲解】一口气搞懂 Agent:干翻传统后端!自主循环决策的秘密,ReAct 与 Plan-and-Execute 范式
java·人工智能·程序人生·ai·agent·react·智能体
郝学胜-神的一滴7 小时前
深入理解回归损失函数:MSE、L1 与 Smooth L1 的设计哲学
人工智能·python·程序人生·算法·机器学习·数据挖掘·回归
weisian1517 小时前
基础篇--概念原理-3-向量是什么?——从原理到实战,一篇讲透
面试·职场和发展·向量
逻辑驱动的ken8 小时前
Java高频面试考点场景题22
java·开发语言·jvm·面试·职场和发展·求职招聘·春招
阿Y加油吧8 小时前
二刷 LeetCode:两道经典贪心题复盘
算法·leetcode·职场和发展
枫叶丹48 小时前
【HarmonyOS 6.0】CANN Kit 新增支持获取 AI 模型 Dump 维测数据功能详解
开发语言·人工智能·华为·信息可视化·harmonyos
计算机魔术师8 小时前
【职场观察 | 技术人处境】五一假期结束,职场两边同时加速——“简历热“和“优化潮“背后的结构性逻辑
人工智能·面试·职场和发展·cot 推理·技术人求职·ai替代逻辑