·阅读时长 11 分钟
为 Docusaurus v3 准备你的网站
·阅读时长 14 分钟
警告
这篇文章是在 Docusaurus v3 处于 Beta 版时撰写的。如果您要升级到当前稳定的 Docusaurus v3 版本,您应该注意依赖项版本和升级步骤中的一些更改。请使用 升级指南 获取最新的迁移步骤。
Docusaurus v3 现在 处于 Beta 阶段,正式发布即将到来。现在正是开始为这个新版本准备你的网站的最佳时机。
Docusaurus v3 带来了几个重大更改,其中许多更改可以在 Docusaurus v2 下处理。提前准备你的网站可以逐步进行,并将使升级到 v3 更轻松。
主要的重大更改是从 MDX v1 升级到 MDX v3。请阅读 MDX v2 和 MDX v3 发布说明以获取详细信息。MDX 现在将更严格地编译您的 Markdown 内容,并且存在细微的差异。
本文将主要关注如何为这个新的 MDX 版本准备你的内容,并将列出一些你今天可以处理的其他重大更改。
自信地升级前端依赖项
·阅读时长 9 分钟
前端开发人员经常需要升级 npm 依赖项,但这些升级可能会让人感到害怕,并会导致常规测试套件无法捕获的细微 UI 副作用。
升级 Docusaurus 就是一个很好的例子:如果不逐页查看所有页面,就很难确定是否存在视觉回归。Docusaurus v3 即将发布(目前处于 Beta 版),我们希望帮助你自信地进行这次升级。
本文介绍了一个基于 GitHub Actions、Playwright 和 Argos 的视觉回归测试工作流程。它没有直接与 Docusaurus 或 React 耦合,可以适应其他前端应用程序和框架。
Docusaurus 2.4
·阅读时长 4 分钟
Docusaurus 2.3
·阅读时长 3 分钟