跳到主要內容

Docusaurus 2021 回顧

·7 分鐘閱讀
Joshua Chen
努力使用 Docusaurus

Docusaurus 在 2021 年有長足進展!我們見證了高度關注,並在**GitHub 上獲得了 3 萬顆星**!

發佈國際化後,我們**達到了與 v1 完全相同的功能**,宣佈我們的**第一個 beta 版本**,並在今年迎來了**更多使用者**。

**官方 v2 版本**即將推出!請追蹤進度歷程,以取得最新消息。

重點

讓我們開始討論一下今年的一些重點。還記得半年前的待辦事項清單嗎?現在拿出來看看我們達到了哪些目標!

  • 國際化:於 2020 年底首次登陸後,已於四個月後正式發布。許多專案中都獲得極佳的成功許多專案
  • 自動產生的側邊欄:不再需要維護龐大的 sidebars.js
  • Webpack 5:大幅提升建置效能
  • 尾端斜線設定:與任何內容託管供應商都能無縫整合
  • 重新設計行動裝置導覽:行動裝置使用者現在可以享有與桌面裝置相同的所有導覽功能
  • 使用者介面改善:更易於取得的引號、更棒的警告訊息、回到頂端的按鈕...
  • 部落格作者:讓所有在單篇部落格文章上合作的優秀貢獻者都能獲得感謝!
  • 更多部落格功能:檔案頁面、SEO 的結構化資料、供應中所有文章內容 — 讓您可以在短時間內提供功能齊全的部落格
  • 資產配置:不再需要過於龐大的靜態資料夾:將您的圖片與 Markdown 檔案並置
  • 側邊欄類別索引頁面:類別標籤現在可以與頁面相關聯,讓文件組織變得更好

我們的程式碼庫也經過長時間的改進。我們改進了測試範圍,將所有套件遷移至 TypeScript,並將已發佈的套件大小減少了最高達 60%!

npm

Docusaurus v2 持續穩定成長。V2 的安裝量現在是 v1 的 8 倍。在每週下載量方面,我們見證到三倍的增長(+209.4%),從 1 月初的 28,066 增加到 12 月中旬的最高峰 86,846。

Docusaurus v1 vs. v2 npm trends of the year 2021. The installations of Docusaurus v2 is constantly rising, while v1 is almost constant. V1 stays at 10000, while v2 grows from 30000 to almost 90000. There's a sharp drop from 90000 to 40000 just before the Jan 2022 line.

(啊,經典的聖誕節跌勢...)

我們發布了 18 個版本,從 2.0.0-alpha.712.0.0-beta.14。這代表每 20 天就會發布一個版本!

GitHub

  • 星星數:20,460 → 29,679(年增 +45.1%)。而且,就在這篇部落格文章發佈前,我們已經達到 30k 顆星星!
  • 貢獻者總數:512 → 773(年增 +51.0%)
  • 依賴項:v2 為 5,039 → 14,579(年增 +189.3%),v1 為 6,311 → 7,581(年增 +20.1%)
  • 提交:過去一年有 1,187 次提交,平均每週 23 次提交
  • 問題:開啟了 619 個問題,最終解決了其中 505 個
  • 一名新的核心團隊成員(是的,就是我 😝)

我們的星星趨勢也非常樂觀。與類似專案相比,我們的成長速度更勝一籌

Stars trend by year of 9 static site generators. Next.js grows the fastest, with Docusaurus at the 4th place in terms of growth rate.

隨著星星數增加了 8.4k,我們在今年的JavaScript 靜態網站產生器新星排名中位居第三,僅次於 Next.js 和 Astro。

Docusaurus placing 3rd in the "Static Sites" ranking list

我們的展示中心歡迎幾個新的 "最愛" 網站,展示出 Docusaurus 2 可插入式架構的真正潛力。

Iota wiki light modeIota wiki dark mode

Dyte light modeDyte dark mode

Ionic light modeIonic dark mode

Courier

Docusaurus 使用者的創意超乎我們的想像 🤩 我們期待更多採用者善用 Docusaurus 的內容功能,同時探索原始佈景主題設計!如果你的網站使用 Docusaurus,我們非常希望 將其納入我們的展示

社群

身為 Discord 的積極版主,我明顯看到社群蓬勃發展。許多常見問題現已整合到我們的文件,而某些功能要求也已實施。專案和社群相互受益 — 重點例子,我之前是一名社群貢獻者,後來才成為維護者。

我們在 Twitter 上經常收到帶有鼓舞回饋的提及

@docusaurus 太棒了!難以置信它用起來那麼簡單。

沒有額外的外掛程式、工具或編譯步驟。它開箱即用。

我熱愛 @docusaurus。沒有 Docusaurus,我無法在我的工作流程中有效率且美觀地建置我的網站中所包含的 API、教學課程和部落格。

我們將它們全部儲存在 小方塊中 😄 如果你也喜歡 Docusaurus,請繼續以你的留言標記我們!

當我們接近正式發布時,我們很想更進一步了解使用者在做什麼:外掛程式作者自訂網站創作者,以及 所有新使用者 — 請持續讓我們知道你的成就,這樣我們就可以調整我們的開發,以更好地滿足你的需求。

前進

在過去幾個月,我們一直在討論 Docusaurus 的候選版本階段,是的,它即將到來。我們建立一個專門的 里程碑,追蹤我們在能夠自信地進行到下一階段之前必須解決的所有問題。簡而言之,我們希望建置一個更穩健的主題作業流程,讓有創意的網站創作者自訂我們的預設主題,在升級時無須擔心重大變更。這將包括

  • 關於元件組織的指南。我們希望主題元件具有正確的細緻度,因此當你想要自訂你的網站部分時,總有一個元件可以執行你需要的功能。
  • swizzle CLI 的改進。我們希望使用者使用它時感到滿意,並讓它協助你進行所有可能的 swizzling 情境。
  • 重新設計我們的主題 API。我們希望所有可 Swizzlable 組件實際上都適合 Swizzling,因此非 UI 組件將會重新配置。
  • 文件。我們希望我們的文件能讓所有人盡量存取,從初次編寫程式碼者到經驗豐富的網路開發人員。我們將以更循序漸進的方式編排它,以便於各個技能水準皆可受益。

在本路線圖議題中進一步了解 Docusaurus 2.0 的計畫。2.0 會在社群的協助下成為一個更棒的版本,因此請在任何里程碑議題下分享你的意見和建議!

由於核心團隊正努力推出一般可用版本,我們計畫在推出 2.0 之後,以小版本的方式推出其他有用功能。我們甚至還進一步規劃了3.0 的架構變更

隨著 Docusaurus 2.0 的正式發布,我們有信心看到更多新的採用和從 v1 的遷移。

我們要感謝 所有 2021 年的貢獻者,包括

  • 核心團隊:Alexey PyltsynSébastien LorberJoshua Chen,以及 Yangshun Tay,他們擔任社群管理員,宣傳 Docusaurus、分類問題,並實作新功能
  • Joel Marcey,一路創造和支援 Docusaurus 的開發
  • Algolia 團隊,協助 Docusaurus 使用者遷移到新的 DocSearch,並解答與搜尋相關的問題
  • 所有活躍的社群成員,提供有價值的程式碼貢獻、改善我們的文件,並在 Discord 上回答問題

再見了,2021,讓我們迎接美好的 2022!