Docusaurus 2021 回顧
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。
(啊,經典的聖誕節跌勢...)
我們發布了 18 個版本,從 2.0.0-alpha.71
到 2.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 個
- 一名新的核心團隊成員(是的,就是我 😝)
我們的星星趨勢也非常樂觀。與類似專案相比,我們的成長速度更勝一籌
隨著星星數增加了 8.4k,我們在今年的JavaScript 靜態網站產生器新星排名中位居第三,僅次於 Next.js 和 Astro。
新採用特色
我們的展示中心歡迎幾個新的 "最愛" 網站,展示出 Docusaurus 2 可插入式架構的真正潛力。
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 Pyltsyn、Sébastien Lorber、Joshua Chen,以及 Yangshun Tay,他們擔任社群管理員,宣傳 Docusaurus、分類問題,並實作新功能
- Joel Marcey,一路創造和支援 Docusaurus 的開發
- Algolia 團隊,協助 Docusaurus 使用者遷移到新的 DocSearch,並解答與搜尋相關的問題
- 所有活躍的社群成員,提供有價值的程式碼貢獻、改善我們的文件,並在 Discord 上回答問題
再見了,2021,讓我們迎接美好的 2022!