跳到主要内容

Docusaurus 2.1

· 阅读需 3 分钟
Sébastien Lorber
Sébastien Lorber
Docusaurus maintainer, This Week In React editor

我们很高兴宣布 Docusaurus 2.1 ，这是我们的第一个次要版本发布。

升级应该很容易：正如我们的 发布流程文档 中所解释的，次要版本遵循 语义化版本 。

Docusaurus 2.1 社交卡片

亮点​

DocCardList 改进​

在 #8008 中，我们简化了<DocCardList>组件的使用，该组件尤其用于侧边栏类别生成的索引页面。

items 属性现在是可选的，并将自动从父侧边栏类别的内容中推断出来：

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

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

此外，我们使其能够在任何文档中使用它，包括与任何侧边栏类别无关的常规文档。

简化的 DocCardList 组件

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 更新日志 以获取所有更改的详尽列表。