·閱讀 11 分鐘
準備您的網站以使用 Docusaurus v3
·閱讀時間 14 分鐘
警告
這篇部落格文章撰寫於 Docusaurus v3 仍處於測試階段。如果您要將 Docusaurus 升級到 v3 目前穩定的版本,您應該注意相依套件版本和升級步驟中的一些變更。請使用升級指南,以取得最新版的遷移步驟。
Docusaurus v3 目前已進入測試階段,且官方版本即將發布。現在正是開始為您的網站做好準備迎接這個新版的主要版本的時候了。
Docusaurus v3 帶來了一些重大變更,其中許多變更都能在 Docusaurus v2 中立即處理。您可以逐步為您的網站做好準備,而這將讓您更容易升級到 v3。
主要的重大變更為從 MDX v1 升級到 MDX v3。請閱讀 MDX v2 和 MDX v3 發行說明,以瞭解詳細內容。MDX 現在將更嚴格且有細微差異地編譯您的 Markdown 內容。
本文將主要著重於如何為這個新版的 MDX 準備您的內容,並將列出一些您今天就能處理的其他重大變更。
放心升級前端依賴項
·閱讀時間 9 分鐘
前端開發人員時常需要升級 npm 相依套件,但這些升級可能會令人感到恐懼,並可能導致您的常規測試套件無法捕捉到的細微 UI 副作用。
升級 Docusaurus 就是一個很好的範例:如果不逐一檢視所有頁面,就難以確定沒有視覺上的錯誤。Docusaurus v3 即將推出(目前在測試階段),我們希望幫助您自信地進行這項升級。
本文介紹了一個基於GitHub Actions、Playwright和Argos的視覺回歸測試工作流程。它並非直接與 Docusaurus 或 React 結合,且可以改編為與其他前端應用程式和框架搭配使用。
Docusaurus 2.4
·閱讀時間 4 分鐘
Docusaurus 2.3
·3 分鐘閱讀時間