前段時間阿里正式釋出了語雀,不得不說,在團隊文件管理方面,語雀的使用者體驗確實做得非常不錯。趁著這個熱度,當時就想給我在2017年開源的 Wizard 專案寫一篇文章,大概介紹一下 Wizard 支援的功能。但無奈剛好那段時間工作太忙,一直沒有時間來好好梳理一下。
概述
Wizard 是一款開源的文件管理系統,支援 Markdown 文件,Swagger 文件以及表格文件,適應於中小規模的技術團隊文件管理,完全免費。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 提供的各種元件,比如 Authentication,Authorization,Events,Mail,Notifications 等,非常適合用來學習 Laravel 框架。
總結
如果你在為公司尋找一款開源免費的 開發文件/API文件管理 工具,不妨考慮一下 Wizard 專案(多一個選擇,為什麼不嘗試下呢),一定不會讓你失望的。如果你是一名 PHP 或者 Laravel 新手,想找個專案學習一下如何用 Laravel 做 Web 開發,這個專案更加不能錯過!
最後,趕緊去 Star 一波,順便給我個 Star ,你的支援是我堅持下去的動力 !如果再能貢獻點 Issues 或者 PR,那就更好啦 ?!
本作品採用《CC 協議》,轉載必須註明作者和本文連結