跳轉至主要內容

宣佈推出 Docusaurus 3.0

·閱讀 11 分鐘
Sébastien Lorber
Docusaurus 維護人員、《This Week In React》編輯

今天,我們很高兴地宣佈推出 Docusaurus 3.0! 🥳

Meta 開源,我们相信 Docusaurus 会助您以最低成本建置出最佳說明文件網站,让您專注於真正重要的事情:撰寫內容。

這是 Docusaurus 的新主要版本,隨附令人振奮的新功能和升級的依賴項。

依據 語義化版本 原則,此版本包含重大變更,我們已在 v3 升級指南 中詳細記錄。重大變更是很麻煩,但有必要為我們計畫實作的新一波 Docusaurus 功能奠定基礎。

v3.0 social-card image

準備您的網站以使用 Docusaurus v3

·閱讀時間 14 分鐘
Sébastien Lorber
Docusaurus 維護人員、《This Week In React》編輯
警告

這篇部落格文章撰寫於 Docusaurus v3 仍處於測試階段。如果您要將 Docusaurus 升級到 v3 目前穩定的版本,您應該注意相依套件版本和升級步驟中的一些變更。請使用升級指南,以取得最新版的遷移步驟。

Docusaurus v3 目前已進入測試階段,且官方版本即將發布。現在正是開始為您的網站做好準備迎接這個新版的主要版本的時候了。

Docusaurus v3 帶來了一些重大變更,其中許多變更都能在 Docusaurus v2 中立即處理。您可以逐步為您的網站做好準備,而這將讓您更容易升級到 v3。

主要的重大變更為從 MDX v1 升級到 MDX v3。請閱讀 MDX v2MDX v3 發行說明,以瞭解詳細內容。MDX 現在將更嚴格有細微差異地編譯您的 Markdown 內容。

本文將主要著重於如何為這個新版的 MDX 準備您的內容,並將列出一些您今天就能處理的其他重大變更。

Preparing your site for Docusaurus v3 - social card

放心升級前端依賴項

·閱讀時間 9 分鐘
Sébastien Lorber
Docusaurus 維護人員、《This Week In React》編輯

前端開發人員時常需要升級 npm 相依套件,但這些升級可能會令人感到恐懼,並可能導致您的常規測試套件無法捕捉到的細微 UI 副作用

升級 Docusaurus 就是一個很好的範例:如果不逐一檢視所有頁面,就難以確定沒有視覺上的錯誤。Docusaurus v3 即將推出(目前在測試階段),我們希望幫助您自信地進行這項升級。

本文介紹了一個基於GitHub ActionsPlaywrightArgos視覺回歸測試工作流程。它並非直接與 Docusaurus 或 React 結合,且可以改編為與其他前端應用程式和框架搭配使用。

Upgrading frontend dependencies with confidence - social card