開源文件管理系統 Wizard 1.2 釋出

mylxsw發表於2019-12-29

前段時間阿里正式釋出了語雀,不得不說,在團隊文件管理方面,語雀的使用者體驗確實做得非常不錯。趁著這個熱度,當時就想給我在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,那就更好啦 ?!

相關文章