今天 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 中一致。
新功能并没有做详细介绍,而是等到最终版本发布的时候公布。
发布链接
- GitHub discussions: 3.0.0-beta.0
- GitHub release: https://github.com/facebook/docusaurus/releases/tag/v3.0.0-beta.0
- Docs PR: chore: v3.0.0-beta.0 release
- Tweet: https://twitter.com/sebastienlorber/status/1702742311514275978
重大变更
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