V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
爱意满满的作品展示区。
mylxsw
V2EX  ›  分享创造

开源文档管理系统 Wizard 1.2 发布

  •  1
     
  •   mylxsw ·
    mylxsw · 2019-12-30 09:44:02 +08:00 · 5548 次点击
    这是一个创建于 1792 天前的主题,其中的信息可能已经有所发展或是发生改变。

    前段时间阿里正式发布了语雀,不得不说,在团队文档管理方面,语雀的用户体验确实做得非常不错。趁着这个热度,当时就想给我在 2017 年开源的 Wizard 项目写一篇文章,大概介绍一下 Wizard 支持的功能。但无奈刚好那段时间工作太忙,一直没有时间来好好梳理一下。

    概述

    Wizard 是一款开源的文档管理系统,支持 Markdown 文档,Swagger 文档以及表格文档,适应于中小规模的技术团队文档管理,完全免费。Wizard 并不是一款云产品,不提供任何云服务,如果你的团队想要使用他,你必须在自己公司内部独立部署。正因为这样,你的数据和技术文档安全是有保障的,不会泄露给任何不信任的第三方。

    Wizard-功能预览图

    更新内容

    由于上次写文章来介绍 Wizard 是发布 1.0 版本,因此这里就把从 1.0 到 1.2 的所有主要更新内容都列出来了。

    • 增加 黑暗主题 的支持,你可以自由切换两款主题
    • 在 Markdown 模式下,实现了对 mermaid 绘制流程图,序列图,饼图,类图,状态图等各种图表的支持。 查看使用说明
    • 在 Markdown 模式下,增加了对数据库数据结构展示卡片的支持,现在,你可以直接将 SQL 建表语句放置在代码块中,Wizard 将会为你转换为表格展示。 查看使用说明
    • 实现跨项目移动文档功能
    • 文档导出功能,支持单个或者批量导出 PDF 或者 Markdown 文档
    • 增加“项目目录是否在首页展示”的支持,现在,你可以控制首页展示哪些项目目录了,参考 在首页隐藏项目目录
    • 表格类型文档 完善,现在作为正式功能,去掉 beta 标识
    • 文档差异对比 优化,文档差异对比更加清晰
    • Markdown 文档展示优化,展示效果更加友好,新建文档使用最新的 markdown 解释器,修复了之前的一些 bug
    • Markdown 增加 框架页展示 支持

    更多功能更新参考项目的 Releases 页面。

    功能概览

    项目的地址为

    https://github.com/mylxsw/wizard
    

    作为一款开源的文档管理系统,Wizard 主要支持下面这些功能

    • 文档管理
      • Markdown 文档管理,支持各种功能扩展(流程图,LaTex,数据结构等)
      • Swagger API 文档管理
      • 表格 文档管理(类似于简化版的在线 Excel)
    • 用户权限
      • 类似于 Gitlab 的权限管理体系,你可以建立用户组,为一组用户分配项目的读写权限
      • 基于 LDAP 的统一身份认证( LDAP/活动目录),你可以将其接入到公司统一的账户管理体系,只需要修改几行配置
    • 文档评论
    • 文档变更历史,文档变更差异对比
    • 多主题自由切换
    • 项目分组,你可以将一些相关联的项目组成一个组,方便更快的检索文档
    • 其它
      • 文档附件
      • 文档分享
      • 阅读模式
      • 内容模板
      • 文档搜索
      • 等等

    你可以访问 http://wizard.aicode.cc/ 在线体验 Wizard 的功能。

    在线版本的 Wizard 由于服务器配置比较低,访问可能会比较慢,而且权限比较开放,任何人都可以编辑,内容比较乱一些。

    部分功能展示

    Markdown 文档展示

    Swagger 文档展示

    表格文档展示

    文档差异对比

    更多功能展示请查看项目的 Wiki 文档

    关于代码

    项目采用了 Laravel 框架开发,目前版本已经升级到 5.8 (最开始为 5.4,一路升级过来)。为了提高开发效率,保持架构的简洁,在开发过程中,一直避免引入过多的外部组件,尽可能的利用 Laravel 提供的各种组件,比如 AuthenticationAuthorizationEventsMailNotifications 等,非常适合用来学习 Laravel 框架。

    总结

    如果你在为公司寻找一款开源免费的 开发文档 /API 文档管理 工具,不妨考虑一下 Wizard 项目(多一个选择,为什么不尝试下呢),一定不会让你失望的。如果你是一名 PHP 或者 Laravel 新手,想找个项目学习一下如何用 Laravel 做 Web 开发,这个项目更加不能错过!

    最后,赶紧去 Star 一波,顺便给我个 Star ,你的支持是我坚持下去的动力 !如果再能贡献点 Issues 或者 PR,那就更好啦 😄!

    21 条回复    2020-01-02 19:34:16 +08:00
    nilai
        1
    nilai  
       2019-12-30 10:02:29 +08:00
    good.good
    wingtatlee
        2
    wingtatlee  
       2019-12-30 10:26:18 +08:00
    還不如用 confluence,更成熟的商業產品,而且便宜
    qbhy
        3
    qbhy  
       2019-12-30 11:00:57 +08:00
    在用 1.0 版本,还不错
    zifangsky
        4
    zifangsky  
       2019-12-30 11:17:26 +08:00
    感觉不错,先 mark 了。
    privil
        5
    privil  
       2019-12-30 11:18:06 +08:00
    @wingtatlee #2 confluence 每年收费多少?便宜吗?
    monospace
        6
    monospace  
       2019-12-30 11:26:16 +08:00
    不错的一款开源产品
    tagtag
        7
    tagtag  
       2019-12-30 12:31:00 +08:00
    @privil 10 个用户的 10 刀,算是象征性收费吧
    privil
        8
    privil  
       2019-12-30 12:31:55 +08:00
    @tagtag #7 ……我也知道 10 个用户的 10 刀,你公司就十个人用吗?
    daozhihun
        9
    daozhihun  
       2019-12-30 12:35:03 +08:00
    看似不错,先马克一下
    huangmj1989
        10
    huangmj1989  
       2019-12-30 14:30:20 +08:00
    看上去是 layui 的风格,很清爽,多谢推荐
    psirnull
        11
    psirnull  
       2019-12-30 14:35:57 +08:00
    关注下
    gscsnm
        12
    gscsnm  
       2019-12-30 14:56:53 +08:00
    关注,点赞
    willqianji
        13
    willqianji  
       2019-12-30 19:04:14 +08:00 via iPhone
    现在在用 bookstackapp 也是用 Laravel,赞的是可以结合 drawio 画结构图,楼主可以参考下,再结合个思维导图就更完美了
    qianmeng
        14
    qianmeng  
       2019-12-30 22:30:52 +08:00 via Android
    这个我试过,很不错的东西。
    mylxsw
        15
    mylxsw  
    OP
       2019-12-30 22:52:52 +08:00
    @willqianji 非常感谢建议,一直想要找一个好用的开源画图库,这个挺不错来的
    willqianji
        16
    willqianji  
       2019-12-30 23:25:09 +08:00 via iPhone   ❤️ 1
    /t/588055 思维导图可以参考这个,或者开源百度脑图
    yafoo
        17
    yafoo  
       2019-12-30 23:56:19 +08:00 via Android
    功能做到这么复杂,也是厉害
    shadowpms
        18
    shadowpms  
       2019-12-31 13:24:44 +08:00
    已经推荐
    Sor
        19
    Sor  
       2019-12-31 17:10:49 +08:00
    感谢开源
    pythonee
        20
    pythonee  
       2020-01-01 09:42:09 +08:00
    @privil 我也好奇,如果便宜的话,我觉得商业产品似乎更加靠谱
    ivydom
        21
    ivydom  
       2020-01-02 19:34:16 +08:00
    界面太丑,不喜欢
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   3574 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 30ms · UTC 05:01 · PVG 13:01 · LAX 21:01 · JFK 00:01
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.