最近领导让搭建一个wiki系统用来作知识管理和api信息管理,通过一番查找,最终选择了wikijs。选择wikijs有如下几点缘由:html
- 易部署,易管理
- 权限管理功能丰富,
- 搜索功能强大,支持全局、按关键字搜索
- 支持标签功能,可按标签浏览
- 简洁的web页面
- 支持多语言,支持中文
- 拥有多种编辑器,目前有code(可编写html页面),markdown(在编辑页面可看到页面效果),visual editor(功能强大的文本编辑器,所见即所得)
- 有团队在维护更新(这里有个小故事,一开始我对wikijs的功能作测试的时候,由于导航功能差点放弃了wikijs,由于每次新增的页面没有入口,要编辑导航增长新增页面,这对管理员来讲太痛苦了,可是就在次日,恰好官网更新了新版本,支持树导航,解决了这个问题)
下面是官网对wikijs的特性介绍

当前版本(2.3.77)wikijs的效果图以下(此图是wikijs官方的文档,官方使用了wikijs管理文档)

关于wikijs的安装,这里就不写出具体步骤了,由于wikijs的安装部署真的很简单,参考官方文档便可 传送门
我对wikijs(2.3.77)的功能进行测试的时候,发现了两个问题:web
- 在建立页面输入中文文件名或输入中文文章标题时,存在没法建立页面或者保存标题的状况,不过在中文名字最后加一个空格能够解决问题
- 在作权限控制时,我自己的想法是让游客能看到首页,可是我让游客看到首页的时候,图片都没法加载,就算我把全部权限给游客都同样,最后只能关闭游客访问,直接跳到登陆页。
不过这些问题都是能够在giuhub上反馈的,期待官方后续修复。api