跳到主要內容

2019 年 Docusaurus 回顧

·3 分鐘閱讀
Yangshun Tay
Meta 的前端工程師

2019 年對 Docusaurus 來說是很棒的一年 - 我們在Docusaurus 2 上取得了巨大的進展。目前 Docusaurus 1 的使用,尚未使用翻譯功能的用戶,可以隨時查看並遷移到 D2。否則,我們將會在 2020 年協助您完成遷移 :)

Docusaurus 2 (D2)

2018 年,我們建議將 Docusaurus 從頭開始重建。它包括一項主要重新架構工作,我們從頭開始建立了一個以內容為中心的 CSS 架構和一個外掛程式系統,並從靜態 HTML 頁面轉移到擁有預渲染路由的單頁應用程式。這是一次充滿冒險精神的旅程,也是一項艱鉅的壯舉,尤其是專門負責這個項目的員工並不存在。在 @endilie 的幫助下,我們前實習生兼現任貢獻者兼維護者,我們在 D2 上取得了非常好的進展,目前為版本 2.0.0-alpha.40。Docusaurus 1 中的完整功能已全部移植,唯翻譯例外。

D2 的殺手級功能包括黑暗模式和它的絕佳效能。D2 本機支援黑暗模式,而且建立黑暗模式友善的說明文件網站非常輕鬆。Endilie 投入大量心力在最佳化網站效能,而引擎蓋下已經透過預設進行了多項效能最佳化秘訣,包括最佳化圖片、預渲染每個路由並在之後進行靜態 HTML 和用戶端路由、在使用者滑鼠指到導覽連結時預先擷取未來導覽所需要的項目。

最後但同樣重要的是,我們實作了外掛程式架構,並將回存庫轉換成 Lerna 獨佔回存庫。我們相信這個外掛程式架構將有助於建立一個社群,並允許使用者根據其獨特的應用案例來建構自己的功能。

GitHub 活動

  • 星號:10050 → 14632 (+45.6% y/y)
  • 貢獻者總數:182 → 303 (+66.4% y/y)。其中大部分是非 Facebook 貢獻者
  • 每日 npm 下載量:728 → 2320 (+218.7% y/y)。高峰出現在 11 月
  • D1 目前用於 GitHub 上的 3872 個專案,而 D2 用於 GitHub 上的 247 個專案
  • 我們現在擁有 4 位活躍的核心貢獻者!(+100% y/y)

知名使用者

開放原始碼社群中相當大量的專案使用 Docusaurus。在這一個半年,我們也將更多的知名專案整合至 Docusaurus 2

並歡迎更多專案使用 Docusaurus 1

媒體

在 F8 期間,Yangshun 在課堂上講述 使用 Docusaurus 建立開放原始碼網站

社群

少數第三方主機/開發服務也與 Docusaurus 設定具有一流的整合

展望

D2 已在開發人員社群中獲得一些認可。我們希望在 2020 年的上半年與 D1 達到完整的功能對等,並協助 D1 上其餘的 Facebook 專案轉移至 D2。若我們能將 Docusaurus 用於內部文件,那將會很棒,但這項任務並不容易。如果您有此需求或有任何想法,請來與我們討論!

特別感謝核心團隊為社群所做的貢獻,包括Endilie Yacop SuciptoAlexey PyltsynWei Gao。最後,感謝 Joel Marcey 啟動 Docusaurus 並長期支援這個專案。

向美好的 2020 年乾杯!🎉