跳到主要内容

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 meta 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 更新日志条目，了解完整的更改列表。