这是一个创建于 737 天前的主题，其中的信息可能已经有所发展或是发生改变。
先说下需求，做一个技术文档，硬性需求如下：
- 必须是全部内容在自己机器上，也就是要自己搭建
- 支持权限管理，打开之前要登录或者口令，登录之后才有查看权限（当然要是能分配权限组更好）
- 支持自定义主题或者修改 CSS （最好不是从源码或者源模版里面修改）
- 最好支持评论。
上面是硬需求，不管是不是伪需求总之就是最终至少要有上面三个特性。
之前有 V 友推荐语雀什么的，确实很好用，但是就是不行，因为文档可能涉及到机器密码什么的，老大不愿意放在别人现有的服务上。
我自己体验了两个框架，都有点不尽人意。
wiki.js
最接近我的需求，支持用户组权限管理，无需编译就能发布文章等。
但是其部署起来有点过于麻烦。
好吧，其实最直接让我放弃选择他的原因是，不支持修改样式。
或者说，开发者支持，但是提供的路径过于麻烦，
要进到容器里面修改模版，修改 css ，修改数据库甚至第一次见编译后还要复制文件夹的，感觉日后维护很麻烦。
bookstack
这个框架也是我体验完觉得非常好的。关键的问题在于样式太丑了，有点 10 年前页面的感觉。
或者说也不是丑，就是其设计并不是用于一个文档，更像是一个书库。
如果找不到更好的方案估计会用。
貌似常用的主流的 wiki 框架就上面两个？
Docusaurus 、docsify 等
还包括ReadtheDocs等开源框架，这些让我的感觉是样式会很好看
但是目前想在这些框架里面找个一个支持登录验证、权限管理的框架（貌似找不到）
不知道我这样的需求有没有一个合适的框架？
简单来说就是至少支持 [权限 + 样式] 两个功能，我感觉这样的框架应该很多，但实际发现好少啊，有点折磨。
 |
1
likunyan 2022-11-21 19:30:49 +08:00
MediaWiki
|
 |
2
NXzCH8fP20468ML5 2022-11-21 19:35:49 +08:00
confluence 及其各种竞品
|
 |
3
Casbin 2022-11-21 19:41:10 +08:00
Showdoc 开源文档平台 + Casdoor 开源单点登录系统： https://casdoor.org/docs/integration/php/showdoc
|
 |
4
hertzry 2022-11-21 20:09:14 +08:00
样式一般都不让改吧。
https://www.v2ex.com/t/732718 |
 |
5
jeesk 2022-11-21 20:17:27 +08:00
感觉还是 wordpress 好用。
|
 |
6
liuzhihang 2022-11-21 20:22:19 +08:00 via iPhone
halo2.0 自己写主题
|
 |
7
star7th 2022-11-21 20:53:04 +08:00
也许我孤陋寡闻，尚不提国外情况吧，毕竟国外那么多国家，也许存在一些我不知道的软件项目。
就国内而言，你如果要求必须开源自部署，要求免费，那么，showdoc 是最好的选择之一了 https://github.com/star7th/showdoc 其他的方案，可能都需要你另外付出额外很多时间精力成本。（付费或者二次开发）。 |
 |
9
proxychains 2022-11-21 21:20:18 +08:00
mm-wiki
|
 |
10
bestmos 2022-11-21 23:04:29 +08:00
zblog
|
|
11
jeesk 2022-11-22 00:54:34 +08:00  1
@Lfhsheng 我不太喜欢自己搭建博客， 折腾得太多了。 现在就免费的 wordpress 托管就行了，wordpress.com 挺好的
|
 |
12
hanxiV2EX 2022-11-22 02:36:12 +08:00 via Android
推荐试试 outline , 用这个工具搭建:
https://github.com/vicalloy/outline-docker-compose 不知道能不能改主题，反正我觉得很像语雀了，除了不能像语雀那样在文档中间画图。。。但是能插入 drawio 那种外链。 |
 |
13
ferock 2022-11-22 08:09:58 +08:00 via iPhone
dokuwiki
|
 |
14
kongkx 2022-11-22 08:54:12 +08:00 via iPhone
Drupal 算是牛刀？
|
 |
15
Jx5921 2022-11-22 09:31:26 +08:00
Ghost ?
|
 |
16
sunorg 2022-11-22 12:22:17 +08:00
@hanxiV2EX
outline 这个本机搭建本机运行可以。make install 绑了 127001 ，一开始修改相对麻烦。 要对外还要反戴， 授权这块，其实就是要官方要推他家的云， 好多修改半年都没更新上。 我用了一段时间后放弃。 --------- Confluence 部署已经没了， 已有授权只有 10 用户，关键是近期出现莫莫名其妙的问题，经常要重启才可以。官方有 bug 也不处理了。 也打算放弃掉。 ---------- mediawiki ， 准备迁移到这个来，但这个的问题是编辑器难用。 ---------- notion 问题是网络延迟，每年 10 月基本很痛苦。 --------- 国内的小鸟，小书，其实最担心的是敏感内容被查看。也是不敢用。。。 -------------- 最后摸摸口袋，午饭还没钱买，我到底该用哪个？ |
 |
18
shawndev 2022-11-22 16:30:37 +08:00
|
 |
19
hlbcpt 2022-11-22 19:37:45 +08:00 via iPhone
doukuwiki
|
 |
20
xwbx 2022-11-23 21:41:49 +08:00 via Android
wikijs 设置里面有个加全局 css 的地方。
之前在那个地方用 css 把整个目录放到了页面右边去。 |
 |
21
kice 2022-11-25 13:36:08 +08:00 via Android
gitea/gogs/gitlab
这些都是带有完整的文档 /wiki 功能。其中 gitea 和 gogs 部署异常简单，gitlab 的“完整性”比较高。 如果是要当作博客的话，这些肯定不方便。 如果是团队内部维护文档其实挺不错的。 文档语法限制于 markdown ，但是足够简单。 登录支持常见的 oauth 和 openid 服务。 权限管理相对比较局限，基本上是以仓库为单位，批量管理需要做团队（不过也不麻烦）。 单纯用来做文档管理的话，会暴露特别多细节给最终用户。不过免费附带工单功能，拿来当作看板或者 TODO 挺舒服的。 |
Select Language