跳至主要内容

宣布 Docusaurus 3.0

·阅读时长 11 分钟
Sébastien Lorber
Docusaurus 维护者,本周 React 编辑

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

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

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

根据 语义版本控制 原则,此版本包含我们在 v3 升级指南 中详细记录的重大更改。重大更改可能很麻烦,但它们对于为我们计划实施的新一波 Docusaurus 功能奠定基础是必要的。

v3.0 social-card image

为 Docusaurus v3 准备你的网站

·阅读时长 14 分钟
Sébastien Lorber
Docusaurus 维护者,本周 React 编辑
警告

这篇文章是在 Docusaurus v3 处于 Beta 版时撰写的。如果您要升级到当前稳定的 Docusaurus v3 版本,您应该注意依赖项版本和升级步骤中的一些更改。请使用 升级指南 获取最新的迁移步骤。

Docusaurus v3 现在 处于 Beta 阶段,正式发布即将到来。现在正是开始为这个新版本准备你的网站的最佳时机。

Docusaurus v3 带来了几个重大更改,其中许多更改可以在 Docusaurus v2 下处理。提前准备你的网站可以逐步进行,并将使升级到 v3 更轻松。

主要的重大更改是从 MDX v1 升级到 MDX v3。请阅读 MDX v2MDX v3 发布说明以获取详细信息。MDX 现在将更严格地编译您的 Markdown 内容,并且存在细微的差异

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

Preparing your site for Docusaurus v3 - social card

自信地升级前端依赖项

·阅读时长 9 分钟
Sébastien Lorber
Docusaurus 维护者,本周 React 编辑

前端开发人员经常需要升级 npm 依赖项,但这些升级可能会让人感到害怕,并会导致常规测试套件无法捕获的细微 UI 副作用

升级 Docusaurus 就是一个很好的例子:如果不逐页查看所有页面,就很难确定是否存在视觉回归。Docusaurus v3 即将发布(目前处于 Beta 版),我们希望帮助你自信地进行这次升级。

本文介绍了一个基于 GitHub ActionsPlaywrightArgos视觉回归测试工作流程。它没有直接与 Docusaurus 或 React 耦合,可以适应其他前端应用程序和框架。

Upgrading frontend dependencies with confidence - social card