概述

Wizard 是一款開源的文檔管理系統(tǒng)，支持 Markdown 文檔，Swagger 文檔以及表格文檔，適應(yīng)于中小規(guī)模的技術(shù)團(tuán)隊(duì)文檔管理，完全免費(fèi)。Wizard 并不是一款云產(chǎn)品，不提供任何云服務(wù)，如果你的團(tuán)隊(duì)想要使用他，你必須在自己公司內(nèi)部獨(dú)立部署。正因?yàn)檫@樣，你的數(shù)據(jù)和技術(shù)文檔安全是有保障的，不會(huì)泄露給任何不信任的第三方。

Wizard-功能預(yù)覽圖

更新內(nèi)容

本次更新（1.2.5）主要包含以下內(nèi)容

• Markdown 文檔圖片支持點(diǎn)擊查看大圖，支持圖片縮放查看

• 支持文檔評(píng)價(jià)，可以對(duì)文檔按照 “很贊”、“看不懂”、“潦草” 打分

  image

• 解決歷史文檔查看不支持表格文檔的問題

• 其它 Bugfix

更多功能更新參考項(xiàng)目的 Releases 頁面。

功能概覽

項(xiàng)目的地址為

https://github.com/mylxsw/wizard

作為一款開源的文檔管理系統(tǒng)，Wizard 主要支持下面這些功能

• 文檔管理
  • Markdown 文檔管理，支持各種功能擴(kuò)展（流程圖，LaTex，數(shù)據(jù)結(jié)構(gòu)等）
  • Swagger API 文檔管理
  • 表格 文檔管理（類似于簡化版的在線 Excel)
• 用戶權(quán)限
  • 類似于 Gitlab 的權(quán)限管理體系，你可以建立用戶組，為一組用戶分配項(xiàng)目的讀寫權(quán)限
  • 基于 LDAP 的統(tǒng)一身份認(rèn)證（LDAP/活動(dòng)目錄），你可以將其接入到公司統(tǒng)一的賬戶管理體系，只需要修改幾行配置
• 文檔評(píng)論
• 文檔變更歷史，文檔變更差異對(duì)比
• 多主題自由切換
• 項(xiàng)目分組，你可以將一些相關(guān)聯(lián)的項(xiàng)目組成一個(gè)組，方便更快的檢索文檔
• 其它
  • 文檔附件
  • 文檔分享
  • 閱讀模式
  • 內(nèi)容模板
  • 文檔搜索
  • 等等

你可以訪問 http://wizard.aicode.cc/ 在線體驗(yàn) Wizard 的功能。

在線版本的 Wizard 由于服務(wù)器配置比較低，訪問可能會(huì)比較慢，而且權(quán)限比較開放，任何人都可以編輯，內(nèi)容比較亂一些。

部分功能展示

Markdown 文檔展示

image

Swagger 文檔展示

image

黑暗主題模式

-w1131

表格文檔展示

image

文檔差異對(duì)比

image

更多功能展示請(qǐng)查看項(xiàng)目的 Wiki 文檔。

關(guān)于代碼

項(xiàng)目采用了 Laravel 框架開發(fā)，目前版本已經(jīng)升級(jí)到 5.8（最開始為5.4，一路升級(jí)過來）。為了提高開發(fā)效率，保持架構(gòu)的簡潔，在開發(fā)過程中，一直避免引入過多的外部組件，盡可能的利用 Laravel 提供的各種組件，比如 Authentication，Authorization，Events，Mail，Notifications 等，非常適合用來學(xué)習(xí) Laravel 框架。

總結(jié)

如果你在為公司尋找一款開源免費(fèi)的 開發(fā)文檔/API文檔管理 工具，不妨考慮一下 Wizard 項(xiàng)目（多一個(gè)選擇，為什么不嘗試下呢），一定不會(huì)讓你失望的。如果你是一名 PHP 或者 Laravel 新手，想找個(gè)項(xiàng)目學(xué)習(xí)一下如何用 Laravel 做 Web 開發(fā)，這個(gè)項(xiàng)目更加不能錯(cuò)過！

最后，趕緊去 Star 一波，順便給我個(gè) Star ，你的支持是我堅(jiān)持下去的動(dòng)力 ！如果再能貢獻(xiàn)點(diǎn) Issues 或者 PR，那就更好啦 ??！