几个公司wiki知识库调研和感悟

wiki · 浏览次数 : 12

小编点评

## Wiki.js 使用经验与吐槽 Wiki.js 是一个功能强大的代码编辑器,但其使用体验存在一些问题。 **优点:** * 功能丰富,可以满足各种编程需求。 * 拥有丰富的插件可拓展功能。 * 提供便捷的代码编辑和代码展示功能。 **缺点:** * 工具栏功能有限,无法满足所有需求。 * 图片处理功能需要先上传再选择,体验有些缓慢。 * 用户权限分配相对繁琐,容易造成混乱。 **使用经验:** * 在创建页面时,工具栏上的功能按钮很少,难以找到一些常用功能。 * 图片处理功能需要先上传再选择,体验有些缓慢。 * 用户权限分配逻辑较为复杂,容易造成错误。 **总结:** Wiki.js 是一种功能强大的代码编辑器,但其使用体验存在一些问题。建议先使用国产项目,如果遇到致命bug无法解决,可以选择使用 confluence 等其他支持国内开源的编辑器。

正文

@

需求背景

公司准备做一个知识库,我这边调研了几个项目,也看了篇别人的经验文章传送门,如下

第一个是我们耳熟能详的confluence,但是好想要收费,先搁置

第二个是mindoc,是一个小型的开源项目,可以docker跑项目,上传文件直接映射到本地,使可以用mysql,有点简陋但也基本够用(可docker)

第三个是看很多人推的Wiki.js,怎么说呢,主要看中了他外观还有一万六千多star,毕竟建立于nodejs基础之上写的,但是有个致命bug,后面会写(可docker)

具体实现

  • mindoc
docker pull registry.cn-hangzhou.aliyuncs.com/mindoc/mindoc:v0.13
// 它容器里面有自带的mysql的其他工具,只需要对外暴露端口就行
docker run --name=mindoc --restart=always -v /data/uploads:/mindoc/uploads -v /data/database:/data/database -e MINDOC_DB_ADAPTER=sqlite3 -e MINDOC_DB_DATABASE=./database/mindoc.db -e MINDOC_CACHE=true -e MINDOC_CACHE_PROVIDER=file -e MINDOC_ENABLE_EXPORT=true -p 8181:8181 -p 3306:3306 -d registry.cn-hangzhou.aliyuncs.com/mindoc/mindoc:v0.13 
  • wiki.js
    先配置好mysql的数据库,空的即可,名字自定,然后再适当修改docker的命令参数

docker run -d -p 8080:3000 --name wiki --restart unless-stopped -e "DB_TYPE=mysql" -e "DB_HOST=你的db" -e "DB_PORT=你的prot" -e "DB_USER=你的user" -e "DB_PASS=你的password" -e "DB_NAME=你的数据库名" ghcr.io/requarks/wiki:2

经验&吐槽

在这里我要特地花点篇幅介绍下wiki.js的使用经验,因为是国外项目很多操作流程跟咱们就不大一致,可能本来思维方式就不大一样嘛,
首先是到写文章页,摸了半天原来是先进到看文章页

然后再点击右上角的+号

然后要先输入你这个新页面的地址路径

选择哪种编辑器

组织填写信息

首先要诟病的是他上方工具栏可用工具太少了,都没有代码框可以选

然后是他图片处理,都不能直接粘贴图片,非要先上传再选,上传就上传了吧,选的时候还看不到缩略图,真尬

接着是他用户权限那块,理解是好理解的,先分配用户,再给这个用户分配组,再给组分配权限
OK,那我先回管理界面分配权限去
怎么回去,如下图,点击设置

同样,怎么回到页面的界面配置界面点"退出"

怎么配置一个用户能不能看到这个页面呢,就是配置这个页面给不给这个用户组权限,如下图

然后最为致命的地方来了,我用一个用户创建A页面,添加图片,然后给另一个用户的用户组给予所有权限,但是用另一个用户访问A页面文字能出来,但图片一直就出不来,特意在网上找了这个老哥疑问看了下,还是不行,这也是我最后放弃wiki.js的原因.

小结

一开始国产项目看不上,就用用国外的,各种不适应但也算是走过来了,但最后这个致命bug很蛋疼,还有选择图片不能看缩略图很烦,最后想法是前期使用国内开源,后期使用confluence(也不算贵,一年基本一天一块钱,按我们现在规模)

与几个公司wiki知识库调研和感悟相似的内容:

几个公司wiki知识库调研和感悟

@目录需求背景具体实现经验&吐槽小结 需求背景 公司准备做一个知识库,我这边调研了几个项目,也看了篇别人的经验文章传送门,如下 第一个是我们耳熟能详的confluence,但是好想要收费,先搁置 第二个是mindoc,是一个小型的开源项目,可以docker跑项目,上传文件直接映射到本地,使可以用my

devops|中小公司不要做研发效能度量

我特别反感那些不顾公司现状一上来就想要做研发效能度量的人,尤其是想把研发效能度量当成锤子四处去敲打螺丝钉的人。 没几个人的小公司上来就做研发效能度量,就如同普通人一上来直接问媒婆怎么能娶到迪丽热巴。解决办法无非把大象装冰箱里的那三步。套用一下,公司想要做好研发效能度量也有标准的三步:长时间对研发效能

[转帖]Linux内存占用常用的几个分析方法,你确定都知道?

https://cloud.tencent.com/developer/article/2168100 0. 引言: 系统内存是硬件系统中必不可少的部分,定时查看系统内存资源运行情况,可以帮助我们及时发现内存资源是否存在异常占用,确保业务的稳定运行。 例如:定期查看公司的网站服务器内存使用情况,可以

Core 文件的简单学习

背景 最近公司内经常出现jvm进程宕机的情况. 宕机之后没有产生jvm的dump文件.比如xxx.hprof 但是产生了 core.$pid的文件. 曾经在aarch64架构上宕机时曾经想学习一下core文件的解析 但是当时因为比较懒(现在也是) 没有深入下去. 这次简单学习几个命令. 想着能够慢慢

[转帖]一文解决内核是如何给容器中的进程分配CPU资源的?

https://zhuanlan.zhihu.com/p/615570804 现在很多公司的服务都是跑在容器下,我来问几个容器 CPU 相关的问题,看大家对天天在用的技术是否熟悉。 容器中的核是真的逻辑核吗? Linux 是如何对容器下的进程进行 CPU 限制的,底层是如何工作的? 容器中的 thr

离职攻略

# 离职攻略 ## 背景 ``` 因为一些原因, 离开了工作十五年的公司. 想着能够总结一下离职的过程,以及注意事项. 以及自己犯得几个错误. 希望其他人如果有类似的需求时别像我一样做出一些比较错误的步骤. 钱重要, 开心也很重要, 获得认可做出贡献也挺重要的. ``` ## 提离职之前 ``` 1

.NET周刊【9月第1期 2023-09-03】

## 国内文章 ### 如何正确实现一个自定义 Exception https://www.cnblogs.com/kklldog/p/how-to-design-exception.html 最近在公司的项目中,编写了几个自定义的 Exception 类。提交 PR 的时候,sonarqube 提

程序员转做产品第一试--供应链计划

一:供应链开发的背景 1、作者就职的公司在某行业迅猛的发展,为了实现价值链的目标,公司提出了数字化,智能化,智慧化的IT,OT规划。 主线围绕着《基础信息领域》,《产品研发领域》,《供应链领域》,《智能制造领域》四个方面开展。 其中每个领域下有相当多的子系统支撑,我枚举几个主要的系统。 基础信息领域

[转帖]websocket消息推送设计

https://cloud.tencent.com/developer/article/2168088?areaSource=&traceId= 1. 背景 公司内目前有几个项目都有消息推送的功能,例如:某个业务操作之后需要推送消息给前端页面,让用户实时感知。 但是目前公司内的消息推送实现分散在在各

[转帖]云数据库是杀猪盘么,去掉中间商赚差价,aws数据库性能提升 10 倍!价格便宜十倍。

https://tidb.net/blog/021059f1 于是乎dba中的冯大嘴喊出了云数据库就是杀猪盘。让每个公司自建数据库。 那么有没有一种数据库又便宜又好用呢。有 哪就是tidb数据库。 之前一个dba工程师的工作内容可能包括以下几个方面: 监控带宽、流量、并发、业务接口等关键资源及访问信