宣佈 Docusaurus 2 Beta

在漫長的 Alpha 階段中，為了確保功能對等性與品質，我們很高興正式發佈首個Docusaurus 2 beta。

隨著此 Beta 版的宣佈，團隊更加確信 Docusaurus 2 已準備好主流採用！

Docusaurus 採用

不要害怕 beta 標籤！

Docusaurus 2 廣泛採用且快速成長

若要更深入地了解目前的 Docusaurus 2 網站品質，我們的全新展示頁面可讓您按功能篩選 Docusaurus 網站，以便您可以從與您有類似用例的真實運作網站中獲得靈感！

別錯過我們的最愛網站；它們全都具有獨特的特色

為何 Docusaurus v2 在 Alpha 版中停留這麼久時間？

令人難以置信的是，第一個 Alpha 版本v2.0.0-alpha.0是在兩年前發布的 😳 ，對軟體 Alpha 版而言異乎尋常地長。

由於這是對程式碼庫的徹底重新建構，因此在進入 Beta 階段之前，我們希望確保對 Docusaurus 2 的穩定性和功能有信心，因為 Beta 意味著高品質。我們很高兴地宣布 Docusaurus 2 已達到功能平價，就像 Docusaurus 1 的I18N一樣，並且已被許多 Docusaurus 網站成功採用（請參閱I18N 展示）。

我們現在非常有信心，Docusaurus 2 的核心功能已夠穩定，可以進入 Beta 版。

Beta 版的目標是什麼？

現在 Docusaurus 2 已穩定且主要的建置功能齊全，Beta 版的目標是讓新使用者對 Docusaurus 2 的生產就緒狀態有信心，促使其他 Docusaurus 1 使用者移轉到版本 2，並正式淘汰 Docusaurus 1。當然我們會持續解決已發現的任何問題及錯誤。

此外，我們會利用 Beta 階段來改善我們的佈景主題系統。

我們希望做到的有：

• 更容易建置自訂佈景主題，包括我們自己的。我們希望提供多個官方佈景主題（包括Tailwind CSS），並持續很長一段時間。

• 更安全地延伸現有佈景主題：升級高度自訂的 Docusaurus 網站可能會很痛苦，因為自訂內容可能會與內部變更衝突。我們需要公佈佈景主題的公開 API 介面，並且明確說明哪些地方可以安全地進行自訂。

我們將建置更好的佈景主題基礎架構，並修改經典佈景主題以使用該基礎架構。

如果您自訂自己的網站，您可能會發現這些計畫的改良非常有價值。

有哪些新功能？

如果您錯過了，我們最近發佈了兩項重大改進

• 自動生成的側邊欄：不必再維護 sidebars.js 檔案!
• Webpack 5 / PostCSS 8：持續快取大幅加快了重新建置時間！

接下來是什麼？

發佈官方 2.0 版本！

為了完成這個目標，我們將繼續修正錯誤並實作最需要的功能，包含

• 側邊欄分類索引頁面
• 更好的行動裝置導覽 UX
• 更好的警告設計
• CSS-in-JS 支援
• 改善建置時間效能
• 延伸 Docusaurus 外掛程式、CMS 整合
• 修正尾隨斜線和相對連結問題
• 與 CommonMark 更好的相容性
• 升級到 MDX 2.0

結論

對 Docusaurus 來說，這是一個令人振奮的時刻。

Docusaurus 收到的正面回饋讓我們備受鼓舞，並每天都發現新的線上網站。

對於這個 Beta 版本，我們感到非常興奮。我們努力追求品質和穩定度，同時持續嘗試提高 Docusaurus 的採用率。對於從現有的 Docusaurus 網站遷移到 Docusaurus 2、一直猶豫不決的人來說，現在是升級的好時機。在我們在本 Beta 周期結束時不再支援 Docusaurus 1 時，希望您已經在最新的基礎架構上執行。如果您有任何問題，請告訴我們如何提供協助。

感謝每一位讀者和整個 Docusaurus 支援社群。🤗