跳到主要内容

发布 Docusaurus 3.0

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

今天,我们很高兴地 宣布 Docusaurus 3.0!🥳

Meta 开源,我们相信 Docusaurus 将帮助您以最少的精力构建最佳的文档网站,让您专注于真正重要的事情:撰写内容。

这是 Docusaurus 的一个新主要版本,带来了令人兴奋的新功能和升级的依赖项。

根据 语义化版本控制 原则,此版本包含我们已在 v3 升级指南中彻底记录的重大更改。重大更改可能令人烦恼,但它们是为我们计划实现的新一波 Docusaurus 功能奠定基础所必需的。

v3.0 social-card image

为 Docusaurus v3 准备您的站点

·阅读约16分钟
Sébastien Lorber
Docusaurus 维护者,《本周 React》编辑
警告

这篇博文是在 Docusaurus v3 处于测试版时撰写的。如果您要升级到 Docusaurus v3 当前稳定版本,需要注意依赖版本和升级步骤的一些变化。请使用升级指南以获取最新的迁移步骤。

Docusaurus v3 现已 进入测试阶段,正式版即将发布。现在是开始为这个新主版本准备您的网站的最佳时机。

Docusaurus v3 带来了一些重大变更,其中许多变更可以在 Docusaurus v2 下今天就开始处理。提前准备您的网站可以逐步进行,这将使升级到 v3 更加容易。

主要的破坏性更改是将 MDX 从 v1 升级到 v3。详情请阅读 MDX v2MDX v3 的发布说明。MDX 现在将更严格地编译您的 Markdown 内容,并具有细微的差异

本文将主要关注如何为这个新的 MDX 版本准备您的内容,并列出一些您今天就可以处理的其他重大变更。

Preparing your site for Docusaurus v3 - social card