略過至主要內容

Docusaurus 2.1

·2 分鐘閱讀時間
Sébastien Lorber
Sébastien Lorber
Docusaurus 維護者，This Week In React 編輯

我們很高兴地宣布推出Docusaurus 2.1，這是我們的首個次要版本。

升級應該是容易的事：正如我們在釋出流程文件中所說明的，次要版本符合語意化版本。

Docusaurus 2.1 social card

重點​

DocCardList 改進​

在#8008中，我們簡化了<DocCardList>元件的使用，特別是在旁側欄類別產生索引頁面上使用。

現在，items 道具為選用項目，並且會從父類邊欄類別的內容自動推斷

import DocCardList from '@theme/DocCardList';
- import {useCurrentSidebarCategory} from '@docusaurus/theme-common';

- <DocCardList items={useCurrentSidebarCategory().items}/>
+ <DocCardList/>

此外，我們讓它可以在任何文件上使用，包含未連結任何邊欄類別的常規文件。

simplified DocCardList component

noindex 改良​

我們改進支援 noindex 元 robots 指令，這是一種向搜尋引擎傳達訊號，表示你不想讓某特定頁面被編入索引。

在 #7963 中，我們允許在每個文件版本基礎上組態 noindex。

使用下列外掛模組選項告訴網路爬蟲你不想編入索引 1.0.0 版本

const options = {
  versions: {
    '1.0.0': {
      noIndex: true,
    },
  },
};

實際上，Docusaurus 會在該版本中的每個頁面中加入下列元

<meta name="robots" content="noindex, nofollow" />

在 #7964 中，我們也修復了一個錯誤，該錯誤會導致 Sitemap 外掛程式仍然包含有 noindex 指令的頁面。現在 Sitemap 外掛程式會可靠地過濾掉所有包含 noindex 指令的頁面。

覆寫預設元標籤​

在 #7952 中，可以覆寫你先前無法覆寫的預設 HTML 元標籤

<>
  {siteConfig.noIndex && <meta name="robots" content="nofollow, noindex" />}
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
</>

現在可以使用 <Head> 或 themeConfig.metadata

  • 來覆寫 viewport 元
  • 來覆寫 robots 元：你可以將你的網站標記為 noIndex，但需將應該編入索引的特定頁面排除在外

烏克蘭語翻譯​

在 #7953 中，我們為烏克蘭語加入預設的經典主題翻譯。

其他變更​

在 2.1.0 變更紀錄 中查看所有變更的完整清單。