跳到主要内容
Sébastien Lorber
Docusaurus 维护者、React 周刊编者

一个自由职业者,React/React-Native 开发者和 Docusaurus 维护者,生活在巴黎附近。同时在维护一个网站,ThisWeekInReact.com 。它是有关于 React 生态最新动态的通讯简报。

查看所有作者

Announcing Docusaurus 3.0

· 阅读需 13 分钟
Sébastien Lorber
Docusaurus 维护者、React 周刊编者

Today, we are happy to announce Docusaurus 3.0! 🥳

At Meta Open Source, we believe Docusaurus will help you build the best documentation websites with minimal effort, letting you focus on what really matters: writing the content.

This is a new major version of Docusaurus, coming with new exciting features and upgraded dependencies.

In line with the Semantic Versioning principles, this release includes breaking changes we documented thoroughly in the v3 upgrade guide. Breaking changes can be bothersome, but they are necessary to set the ground for a new wave of Docusaurus features we plan to implement.

v3.0 social-card image

Preparing your site for Docusaurus v3

· 阅读需 16 分钟
Sébastien Lorber
Docusaurus 维护者、React 周刊编者
警告

这篇博文是在 Docusaurus v3 还处于测试时写的。 在升级到 Docusaurus v3 当前稳定版本时,请留意依赖项版本的变更以及相应的升级步骤。 请使用升级指南了解最新的迁移步骤。

Docusaurus v3 is now in beta and the official release is around the corner. This is the perfect time to start preparing your site for this new major version.

Docusaurus v3 comes with a few breaking changes, many of which can be handled today under Docusaurus v2. Preparing your site ahead of time can be done incrementally, and will make it easier to upgrade to v3.

主要的突破变化是从 MDX v1 升级到 MDX v3 。 请阅读 MDX v2MDX v3 的版本说明获取更详细的信息。 MDX will now compile your Markdown content more strictly and with subtle differences.

This article will mostly focus on how to prepare your content for this new MDX version, and will also list a few other breaking changes that you can handle today.

Preparing your site for Docusaurus v3 - social card