先说下需求,做一个技术文档,硬性需求如下:
- 必须是全部内容在自己机器上,也就是要自己搭建
- 支持权限管理,打开之前要登录或者口令,登录之后才有查看权限(当然要是能分配权限组更好)
- 支持自定义主题或者修改 CSS (最好不是从源码或者源模版里面修改)
- 最好支持评论。
上面是硬需求,不管是不是伪需求总之就是最终至少要有上面三个特性。
之前有 V 友推荐语雀什么的,确实很好用,但是就是不行,因为文档可能涉及到机器密码什么的,老大不愿意放在别人现有的服务上。
我自己体验了两个框架,都有点不尽人意。
wiki.js
最接近我的需求,支持用户组权限管理,无需编译就能发布文章等。
但是其部署起来有点过于麻烦。
好吧,其实最直接让我放弃选择他的原因是,不支持修改样式。
或者说,开发者支持,但是提供的路径过于麻烦,
要进到容器里面修改模版,修改 css ,修改数据库甚至第一次见编译后还要复制文件夹的,感觉日后维护很麻烦。

bookstack
这个框架也是我体验完觉得非常好的。关键的问题在于样式太丑了,有点 10 年前页面的感觉。
或者说也不是丑,就是其设计并不是用于一个文档,更像是一个书库。
如果找不到更好的方案估计会用。
貌似常用的主流的 wiki 框架就上面两个?
Docusaurus 、docsify 等
还包括ReadtheDocs等开源框架,这些让我的感觉是样式会很好看
但是目前想在这些框架里面找个一个支持登录验证、权限管理的框架(貌似找不到)
不知道我这样的需求有没有一个合适的框架?
简单来说就是至少支持 [权限 + 样式] 两个功能,我感觉这样的框架应该很多,但实际发现好少啊,有点折磨。