跳至主要內容

Docusaurus 2.3

·閱讀時間：3 分鐘
Sébastien Lorber
Sébastien Lorber
Docusaurus 維護員、This Week In React 編輯

我們很榮幸宣布Docusaurus 2.3。

升級過程應該很順利：正如我們在版本流程文件中所說明的，次要版本遵循語意版本控管。

Docusaurus 2.2 social card

重點事項​

Google 標籤管理員外掛程式​

Google 標籤管理員是一種標籤管理系統，提供極高的靈活性。它讓分析和行銷團隊可以輕鬆載入其他第三方追蹤器，並觸發分析標籤。

我們現在有一個 @docusaurus/plugin-google-tag-manager 套件，你可以與現有的 gtag.js 外掛程式 一起使用，或作為替代方案 (請參閱 這份文件 以了解何時使用哪個解決方案)。

Google 正式停止通用 Google Analytics

Google 將會在 **2023 年 7 月 1 日** 正式停止其通用 Google Analytics，並要求使用者遷移至 **Google Analytics 4**。

因此，我們也準備要逐步淘汰現有的 @docusaurus/plugin-google-analytics 套件。Docusaurus 使用者應建立一個新的 Google Analytics 4 屬性，並遷移至 gtag.js 外掛程式 或 Google 標籤管理員外掛程式。有關詳細資訊和問題，請參閱 專屬 Docusaurus 議題。

標籤查詢字串支援​

現在可以連結選定的標籤至查詢字串參數。當選擇一個標籤時，它會以 ?qs-param=tab-value 搜尋參數的方式儲存在瀏覽器的網址中。

這個功能容許深度連結至特定文件標籤，該標籤會在讀取頁面時預先選取。

當搭配 groupId prop 使用時，查詢字串標籤值優先於 localStorage 值。

請務必查看 文件 和以下示範以了解其運作方式

<Tabs groupId="current-os" queryString>
  <TabItem value="android" label="Android">
    Android
  </TabItem>
  <TabItem value="ios" label="iOS">
    iOS
  </TabItem>
</Tabs>
https://127.0.0.1:3000

Android

巢狀勸誡​

現在可以透過為外部／包含勸誡新增額外的冒號，將一個勸誡巢狀放置於另一個勸誡內

::::tip[nested admonitions]

You can now nest one admonition within another!

:::danger

Use this sparingly when it makes sense.

:::

::::
巢狀勸誡

現在可以在一個勸誡中巢狀嵌套另一個勸誡！

危險

在有意義的情況下適量使用。

網誌 createFeedItems​

新的網誌外掛選項 feedOptions.createFeedItems 提供更多 RSS/Atom 摘要產生控制權。現在可以透過新的回呼程式轉換/篩選/限制摘要項目。

docusaurus.config.js
[
  '@docusaurus/preset-classic',
  {
    blog: {
      feedOptions: {
        createFeedItems: async (params) => {
          const {blogPosts, defaultCreateFeedItems, ...rest} = params;
          return defaultCreateFeedItems({
            // keep only the 10 most recent blog posts in the feed
            blogPosts: blogPosts.filter((item, index) => index < 10),
            ...rest,
          });
        },
      },
    },
  },
];

翻譯​

已新增或補全多國語言的預設佈景主題翻譯支援

  • 🇸🇮 #8541 斯洛維尼亞語
  • 🇹🇷 #8289 土耳其語
  • 🇮🇷 #8406 波斯語
  • 🇵🇱 #8525 波蘭語
  • 🇨🇳 #8423 簡體中文
  • 🇸🇪 #8312 瑞典語
  • 🇻🇳 #8450 越南語
提示

補全佈景主題翻譯是一項 持續進行中 且為 Docusaurus 貢獻的簡便方式。我們會定期新增佈景主題功能，我們經常 需要新翻譯。

其他變更​

其他重要變更包括

  • #8463 和 #8328：修復一些令人困擾的 Docusaurus 版面問題
  • #8539：Algolia 外掛程式 options.searchPagePath 應正確套用到搜尋模式底部
  • #8462: Algolia 外掛程式現在讓自訂邏輯輕鬆轉換為顯示的搜尋結果
  • #8397: deploy CLI 現在理解 git url insteadOf 設定

查看2.3.0 變更記錄條目，取得完整變更清單。