跳到主要内容

Docusaurus 2.2

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

我们很高兴地宣布 Docusaurus 2.2 的发布。

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

Docusaurus 2.2 社交卡片

亮点​

Mermaid 流程图​

在 #7490 中，我们增加了对 Mermaid 流程图的支持。这弥补了 GitHub Flavored Markdown 也 最近添加了支持 的不足。您可以使用 Markdown 代码块创建 Mermaid 流程图：

```mermaid
sequenceDiagram
    participant Alice
    participant Bob
    Alice->>John: Hello John, how are you?
    loop Health check
        John->>John: Fight against hypochondria
    end
    Note right of John: Rational thoughts <br/>prevail!
    John-->>Alice: Great!
    John->>Bob: How about you?
    Bob-->>John: Jolly good!
```
http://localhost:3000

请务必查看 文档 和更高级的示例

配置 headTags​

在 #8151 中，我们增加了对所有页面应用任意 HTML <head> 标签的功能。

docusaurus.config.js
module.exports = {
  headTags: [
    {
      tagName: 'link',
      attributes: {
        rel: 'icon',
        href: '/img/docusaurus.png',
      },
    },
  ],
};

可访问性​

我们进行了一些可访问性改进：

  • #8207 ：改进了移动抽屉汉堡按钮的键盘导航
  • #8161 ：改进了选项卡的键盘导航
  • #8204 ：使“跳至内容”按钮支持渐进增强
  • #8174 ：在切换明/暗模式时改进了屏幕阅读器公告

开发者体验​

我们加强了验证并改进了错误消息：

  • #8234 ：如果文档处理失败，则在错误消息中打印有问题的 Markdown 文件路径
  • #8192 和 #8159 ：更严格地验证 siteConfig.url，并提供更好的错误消息
  • #8066 ：使配置 url 和 baseUrl 更加安全，并且对开头或结尾斜杠的存在与否不那么敏感

翻译​

我们完成了对多种语言的默认主题翻译支持：

  • 🇹🇷 #8105 ：完成了土耳其语翻译
  • 🇷🇺 #8253 ：完成了俄语翻译
  • 🇫🇷 #8243 ：完成了法语翻译
  • 🇯🇵 #8075 ：完成了日语翻译
提示

完成主题翻译是一项 持续的工作 ，也是为 Docusaurus 做贡献的一种简单方法。我们定期添加新的主题功能，为此我们经常 需要新的翻译 。

其他更改​

其他值得注意的更改包括：

  • #8210 ：docusaurus swizzle CLI 有一个新的 --config 选项
  • #8109 ：移动导航性能优化，更早地预取资源
  • #8059 ：版本/语言环境导航栏下拉菜单在导航时保留哈希和查询字符串
  • #8227 ：客户端重定向插件在重定向时保留哈希和查询字符串

查看 2.2.0 更新日志 以获取所有更改的详尽列表。