跳到主要内容

Docusaurus 3.7

·3 分钟阅读
Sébastien Lorber
Sébastien Lorber
Docusaurus 维护者，《本周 React》编辑

我们很高兴宣布 Docusaurus 3.7。

Docusaurus 现在兼容 React 19。

升级应该很容易。我们的发布流程遵循语义版本控制。次要版本不包含任何重大更改。

Docusaurus blog post social card

亮点​

React 19​

在 #10763 中，我们添加了对 React 19 的支持，并且 Docusaurus 网站已经运行在 React 19 上。

从现在起，所有新初始化的站点将默认运行在 React 19 上，并且 React 19 将是 Docusaurus v4 所需的最低版本。

然而，React 18 仍然受支持，现有的 Docusaurus 站点可以选择停留在 React 18，或者将其依赖升级到 React 19

{
  "name": "my-docusaurus-site",
  "dependencies": {
-   "react": "^18.0.0",
-   "react-dom": "^18.0.0"
+   "react": "^19.0.0",
+   "react-dom": "^19.0.0"
  }
}
警告

没有必要立即升级您的站点。

React 19 比 React 18 稍重。由于我们同时支持这两个版本，因此我们尚未利用 React 19 独有的新特性。

然而，升级到 React 19 会为您的站点准备好 Docusaurus v4，届时将不再支持 React 18。

以下是 Docusaurus v4 之前升级您的站点的充分理由

  • 您有自定义的 React 代码，并希望确保它已为 React 19 做好准备
  • 您计划在自己的代码中利用全新的 React 19 特性
  • 您使用自定义或第三方插件，并希望确保它们的兼容性
  • 您有一个 Monorepo，并希望将所有包的 React 依赖对齐到 v19

在此过程中，我们修复了 React 19 报告的所有剩余水合错误，其中一些是由我们激进的 HTML 压缩器设置产生的。

SVGR 插件​

Docusaurus 内置支持 SVGR，允许您无缝导入和使用 SVG 文件作为 React 组件

import DocusaurusSvg from './docusaurus.svg';

<DocusaurusSvg />;

此内置支持一直是各种错误报告的来源，原因在于无法自定义 SVGR 选项，特别是 SVG 优化器选项。

在 #10677 中，我们提取了一个新的 @docusaurus/plugin-svgr 插件，您现在可以根据自己的需求进行配置。它默认包含在我们的经典预设中。

export default {
  presets: [
    [
      'classic',
      {
        svgr: {
          svgrConfig: {
            // Your SVGR options ...
            svgoConfig: {
              // Your SVGO options ...
              // Use "svgoConfig: undefined" to use a svgo.config.js file
            },
          },
        },
      },
    ],
  ],
};

其他更改​

其他值得注意的更改包括

  • #10768：博客作者内置了社交平台 Bluesky、Mastodon、Threads、Twitch、YouTube、Instagram 的图标。
  • #10729：博客现在支持 frontMatter.sidebar_label
  • #10803：@docusaurus/remark-plugin-npm2yarn 现在支持 Bun 转换。
  • #10672：将 Algolia DocSearch 升级到 algoliasearch v5。
  • #10800：Docusaurus Faster 默认开启 Rspack 增量模式。
  • #10783：改进荷兰语主题翻译。
  • #10760：改进韩语主题翻译。

查看 3.7.0 变更日志条目 以获取详细更改列表。