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

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

  •  1
     
  •   mylxsw · 94 天前 · 3831 次点击
    这是一个创建于 94 天前的主题,其中的信息可能已经有所发展或是发生改变。

    前段时间阿里正式发布了语雀,不得不说,在团队文档管理方面,语雀的用户体验确实做得非常不错。趁着这个热度,当时就想给我在 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   94 天前
    good.good
    wingtatlee
        2
    wingtatlee   94 天前
    還不如用 confluence,更成熟的商業產品,而且便宜
    qbhy
        3
    qbhy   94 天前
    在用 1.0 版本,还不错
    zifangsky
        4
    zifangsky   94 天前
    感觉不错,先 mark 了。
    privil
        5
    privil   94 天前
    @wingtatlee #2 confluence 每年收费多少?便宜吗?
    monospace
        6
    monospace   94 天前
    不错的一款开源产品
    tagtag
        7
    tagtag   94 天前
    @privil 10 个用户的 10 刀,算是象征性收费吧
    privil
        8
    privil   94 天前
    @tagtag #7 ……我也知道 10 个用户的 10 刀,你公司就十个人用吗?
    daozhihun
        9
    daozhihun   94 天前
    看似不错,先马克一下
    huangmj1989
        10
    huangmj1989   94 天前
    看上去是 layui 的风格,很清爽,多谢推荐
    psirnull
        11
    psirnull   94 天前
    关注下
    gscsnm
        12
    gscsnm   94 天前
    关注,点赞
    willqianji
        13
    willqianji   94 天前 via iPhone
    现在在用 bookstackapp 也是用 Laravel,赞的是可以结合 drawio 画结构图,楼主可以参考下,再结合个思维导图就更完美了
    qianmeng
        14
    qianmeng   94 天前 via Android
    这个我试过,很不错的东西。
    mylxsw
        15
    mylxsw   94 天前
    @willqianji 非常感谢建议,一直想要找一个好用的开源画图库,这个挺不错来的
    willqianji
        16
    willqianji   94 天前 via iPhone   ❤️ 1
    /t/588055 思维导图可以参考这个,或者开源百度脑图
    yafoo
        17
    yafoo   94 天前 via Android
    功能做到这么复杂,也是厉害
    shadowpms
        18
    shadowpms   93 天前
    已经推荐
    Sor
        19
    Sor   93 天前
    感谢开源
    pythonee
        20
    pythonee   92 天前
    @privil 我也好奇,如果便宜的话,我觉得商业产品似乎更加靠谱
    ivydom
        21
    ivydom   91 天前
    界面太丑,不喜欢
    关于   ·   FAQ   ·   API   ·   我们的愿景   ·   广告投放   ·   感谢   ·   实用小工具   ·   1090 人在线   最高记录 5168   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 22ms · UTC 22:09 · PVG 06:09 · LAX 15:09 · JFK 18:09
    ♥ Do have faith in what you're doing.