跳至主要内容

Docusaurus 2.2

·阅读时长 3 分钟
Sébastien Lorber
Sébastien Lorber
Docusaurus 维护者，This Week In React 编辑

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

升级应该很简单：正如我们在 发布流程文档 中解释的那样，次要版本尊重 语义版本控制。

Docusaurus 2.2 social card

亮点​

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 版本变更日志条目 以获取所有更改的详尽列表。