有没有好看一点的，支持权限管理的博客、文档或者 wiki 框架

先说下需求，做一个技术文档，硬性需求如下：

必须是全部内容在自己机器上，也就是要自己搭建
支持权限管理，打开之前要登录或者口令，登录之后才有查看权限（当然要是能分配权限组更好）
支持自定义主题或者修改 CSS （最好不是从源码或者源模版里面修改）
最好支持评论。

上面是硬需求，不管是不是伪需求总之就是最终至少要有上面三个特性。

之前有 V 友推荐语雀什么的，确实很好用，但是就是不行，因为文档可能涉及到机器密码什么的，老大不愿意放在别人现有的服务上。

我自己体验了两个框架，都有点不尽人意。

wiki.js

最接近我的需求，支持用户组权限管理，无需编译就能发布文章等。

但是其部署起来有点过于麻烦。

好吧，其实最直接让我放弃选择他的原因是，不支持修改样式。

或者说，开发者支持，但是提供的路径过于麻烦，

要进到容器里面修改模版，修改 css ，修改数据库甚至第一次见编译后还要复制文件夹的，感觉日后维护很麻烦。

bookstack

这个框架也是我体验完觉得非常好的。关键的问题在于样式太丑了，有点 10 年前页面的感觉。

或者说也不是丑，就是其设计并不是用于一个文档，更像是一个书库。

如果找不到更好的方案估计会用。

貌似常用的主流的 wiki 框架就上面两个？

Docusaurus 、docsify 等

还包括ReadtheDocs等开源框架，这些让我的感觉是样式会很好看

但是目前想在这些框架里面找个一个支持登录验证、权限管理的框架（貌似找不到）

不知道我这样的需求有没有一个合适的框架？

简单来说就是至少支持 [权限 + 样式] 两个功能，我感觉这样的框架应该很多，但实际发现好少啊，有点折磨。

kice

2022-11-25 13:36:08 +08:00

gitea/gogs/gitlab
这些都是带有完整的文档 /wiki 功能。其中 gitea 和 gogs 部署异常简单，gitlab 的“完整性”比较高。

如果是要当作博客的话，这些肯定不方便。
如果是团队内部维护文档其实挺不错的。

文档语法限制于 markdown ，但是足够简单。
登录支持常见的 oauth 和 openid 服务。

权限管理相对比较局限，基本上是以仓库为单位，批量管理需要做团队（不过也不麻烦）。

单纯用来做文档管理的话，会暴露特别多细节给最终用户。不过免费附带工单功能，拿来当作看板或者 TODO 挺舒服的。