跳至主要内容

Docusaurus 2.1

·阅读 2 分钟
Sébastien Lorber
Sébastien Lorber
Docusaurus 维护者，《本周 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中，我们还修复了一个错误，即站点地图插件仍包含具有noindex指令的页面。现在，站点地图插件将可靠地过滤掉所有包含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 版本更新日志条目以获取完整的更改列表。