跳到主要内容

Docusaurus V3.0 Beta 版本发布了 🎉

· 阅读需 3 分钟
编程范儿

今天 Docusaurus v3 的 beta 版本发布了,意味着离正式版本发布不远了。很期待!

关注 Docusaurus 也快小半年了,个人体验特别好,是我目前使用过的最好的建站工具了。会一直持续下去。

下面是官方的一些 release 信息,我也没有做特别的解读,简单翻译了下,等正式版出来,我会做个升级,然后分享详细的升级指南和新版本的特性以及功能点。

Docusaurus v3 目前已经至少被3个主要的站点使用:Docusaurus (https://docusaurus.io)、Jest (https://jestjs.io) 和 React - Native (https://reactnative.dev)。

在这个过程中,我们解决了遇到的所有小问题。

现在是时候将 v3 移至 beta 阶段了!

主要变化

Docusaurus v3 主要是基础设施升级,特别是:

  • MDX 2
  • React 18
  • TS 5
  • Mermaid 10

还有其他一些”功能性“破坏性变化,应该相对容易处理。UI 基本保持和最新的 v2.x 中一致。

新功能并没有做详细介绍,而是等到最终版本发布的时候公布。

发布链接

重大变更

MDX v2 是 Docusaurus v3 中最令人困扰的重大变更:它可能需要您更新一些 md/mdx 文件,以确保它们仍然能够顺利编译。请阅读专用的 MDX v2 PR 以获取更多详细信息。

特别是,诸如 {< 等字符可能会引发新的 MDX 编译错误。MDX v2 Playground 是您解决这些问题的新帮手。

我们还创建了一个专用的支持讨论:MDX v2 - Upgrade Support

很快将会推出一个命令行工具。它应该提供一种方便的方法来检测哪些文档在 MDX v2 下无法编译。您可以运行 npx docusaurus-mdx-checker 来进行预览。

如果你想了解详细的变更,请查看 -> https://github.com/facebook/docusaurus/discussions/9312

太空编程
分享硬核的前端编程知识。
想及时了解前端相关资讯,请关注作者公众号“太空编程”,回复关键字,获取丰富的学习资料。