概述
Wizard 是一款開(kāi)源的文檔管理系統(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ì)泄露給任何不信任的第三方。

更新內(nèi)容
本次更新(1.2.1)主要包含以下內(nèi)容
- 文檔預(yù)覽(Markdown/Swagger)增加了對(duì)黑暗主題模式的支持,切換到黑暗模式之后,你的文檔也將以黑暗色調(diào)展示
- Table 類型的文檔現(xiàn)在支持同一個(gè)單元格換行展示,操作方式與 Excel 相同,使用
Alt+Enter換行 - Table 類型的文檔現(xiàn)在支持從 Excel 文檔粘貼復(fù)制內(nèi)容了,感謝 x-spreadsheet 的更新支持
- Markdown 文檔中增加了對(duì)思維導(dǎo)圖嵌入的支持,該功能還不太完善,目前處于 beta 狀態(tài)
- 靜態(tài)資源 CDN 支持,靜態(tài)資源可以使用七牛云的 CDN 加速,減少應(yīng)用帶寬消耗
更多功能更新參考項(xiàng)目的 Releases 頁(yè)面。
功能概覽
項(xiàng)目的地址為
https://github.com/mylxsw/wizard
作為一款開(kāi)源的文檔管理系統(tǒng),Wizard 主要支持下面這些功能
- 文檔管理
- Markdown 文檔管理,支持各種功能擴(kuò)展(流程圖,LaTex,數(shù)據(jù)結(jié)構(gòu)等)
- Swagger API 文檔管理
- 表格 文檔管理(類似于簡(jiǎn)化版的在線 Excel)
- 用戶權(quán)限
- 類似于 Gitlab 的權(quán)限管理體系,你可以建立用戶組,為一組用戶分配項(xiàng)目的讀寫(xiě)權(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)容模板
- 文檔搜索
- 等等
你可以訪問(wèn) http://wizard.aicode.cc/ 在線體驗(yàn) Wizard 的功能。
在線版本的 Wizard 由于服務(wù)器配置比較低,訪問(wèn)可能會(huì)比較慢,而且權(quán)限比較開(kāi)放,任何人都可以編輯,內(nèi)容比較亂一些。
部分功能展示
Markdown 文檔展示

Swagger 文檔展示

黑暗主題模式

表格文檔展示

文檔差異對(duì)比

更多功能展示請(qǐng)查看項(xiàng)目的 Wiki 文檔。
關(guān)于代碼
項(xiàng)目采用了 Laravel 框架開(kāi)發(fā),目前版本已經(jīng)升級(jí)到 5.8(最開(kāi)始為5.4,一路升級(jí)過(guò)來(lái))。為了提高開(kāi)發(fā)效率,保持架構(gòu)的簡(jiǎn)潔,在開(kāi)發(fā)過(guò)程中,一直避免引入過(guò)多的外部組件,盡可能的利用 Laravel 提供的各種組件,比如 Authentication,Authorization,Events,Mail,Notifications 等,非常適合用來(lái)學(xué)習(xí) Laravel 框架。
總結(jié)
如果你在為公司尋找一款開(kāi)源免費(fèi)的 開(kāi)發(fā)文檔/API文檔管理 工具,不妨考慮一下 Wizard 項(xiàng)目(多一個(gè)選擇,為什么不嘗試下呢),一定不會(huì)讓你失望的。如果你是一名 PHP 或者 Laravel 新手,想找個(gè)項(xiàng)目學(xué)習(xí)一下如何用 Laravel 做 Web 開(kāi)發(fā),這個(gè)項(xiàng)目更加不能錯(cuò)過(guò)!
最后,趕緊去 Star 一波,順便給我個(gè) Star ,你的支持是我堅(jiān)持下去的動(dòng)力 !如果再能貢獻(xiàn)點(diǎn) Issues 或者 PR,那就更好啦 ??!