跳到主旨

金絲雀版本

Docusaurus 有金絲雀版本系統。

它允許你在拉取要求合併到 Docusaurus 下一個版本 後測試新的未發布功能。

這是回饋給維護者的好方法，確保新實作的功能如預期般運作。

備註

在生產環境中使用金絲雀版本可能看起來有風險，但實際上並非如此。

金絲雀版本通過所有自動測試，並且 Docusaurus 網站本身在生產環境中使用。

警告

下面顯示的金絲雀版本可能並非最新版本。請前往 npm 頁面 找出實際版本名稱。

金絲雀 npm dist 標籤​

針對 main 上的任何程式碼相關提交，持續整合將在 @canary npm dist 標籤下發佈金絲雀版本。一般需要 10 分鐘的時間。

您可以在 npm 上看到目前的 dist 標籤

  • latest：穩定版本（目前：3.5.2
  • canary：金絲雀版本（例如：0.0.0-4922）
提示

務必使用最新的金絲雀版本並查看發布日期（有時發布程序可能會失敗）。

備註

金絲雀版本遵循命名慣例 0.0.0-提交編號。

使用金絲雀版本​

採用 金絲雀 npm dist 標籤 下發布的最新版本（例如：0.0.0-4922）。

將其用於 package.json 中的所有 @docusaurus/* 相依項目。

-  "@docusaurus/core": "^3.5.2",
-  "@docusaurus/preset-classic": "^3.5.2",
+  "@docusaurus/core": "0.0.0-4922",
+  "@docusaurus/preset-classic": "0.0.0-4922",

接著，重新安裝相依項目並啟動您的網站。

npm install
npm start

您也可以使用命令列升級 @docusaurus/* 套件。

npm install --save-exact @docusaurus/core@canary @docusaurus/preset-classic@canary
警告

務必包含所有 @docusaurus/* 套件。

對於金絲雀版本，建議使用明確版本，而非語意版本範圍（避免 ^ 前綴）。