概述
Wizard 是一款开源的文档管理系统,支持 Markdown 文档,Swagger 文档以及表格文档,适应于中小规模的技术团队文档管理,完全免费。Wizard 并不是一款云产品,不提供任何云服务,如果你的团队想要使用他,你必须在自己公司内部独立部署。正因为这样,你的数据和技术文档安全是有保障的,不会泄露给任何不信任的第三方。
更新内容
本次更新(1.2.6)主要包含以下内容
-
支持文档批量导入,现在你可以通过通过文件上传的方式批量导入文件了
-
支持用户扮演功能,管理员可以扮演为其它用户,以其它普通用户的视角进行操作
-
增加将文档标记为已过时的功能,过时的文档可以通过颜色和文字与其他文档区分出来
- Markdown 图片上传现在支持 SVG 格式的文件上传和展示了
-
文档点赞功能用户为文档点赞后,显示点赞用户的用户名
更多功能更新参考项目的 Releases 页面。
功能概览
项目的地址为
https://github.com/mylxsw/wizard
作为一款开源的文档管理系统,Wizard 主要支持下面这些功能
-
文档管理
- Markdown 文档管理,支持各种功能扩展(流程图,LaTex,数据结构等)
- Swagger API 文档管理
- 表格 文档管理(类似于简化版的在线 Excel)
-
用户权限
- 类似于 Gitlab 的权限管理体系,你可以建立用户组,为一组用户分配项目的读写权限
- 基于 LDAP 的统一身份认证(LDAP/活动目录),你可以将其接入到公司统一的账户管理体系,只需要修改几行配置
- 文档评论
- 文档变更历史,文档变更差异对比
- 多主题自由切换
- 项目分组,你可以将一些相关联的项目组成一个组,方便更快的检索文档
-
其它
- 文档附件
- 文档分享
- 阅读模式
- 内容模板
- 文档搜索
- 等等
部分功能展示
Markdown 文档展示
Swagger 文档展示
黑暗主题模式
表格文档展示
文档差异对比
更多功能展示请查看项目的 Wiki 文档 。
关于代码
项目采用了 Laravel 框架开发,目前版本已经升级到 5.8(最开始为5.4,一路升级过来)。为了提高开发效率,保持架构的简洁,在开发过程中,一直避免引入过多的外部组件,尽可能的利用 Laravel 提供的各种组件,比如 Authentication , Authorization , Events , Mail , Notifications 等,非常适合用来学习 Laravel 框架。
总结
如果你在为公司寻找一款开源免费的 开发文档/API文档管理 工具,不妨考虑一下 Wizard 项目(多一个选择,为什么不尝试下呢),一定不会让你失望的。如果你是一名 PHP 或者 Laravel 新手,想找个项目学习一下如何用 Laravel 做 Web 开发,这个项目更加不能错过!
最后,赶紧去 Star 一波,顺便给我个 Star ,你的支持是我坚持下去的动力 !如果再能贡献点 Issues 或者 PR,那就更好啦 😄!