跳至主要内容

Docusaurus 2 Beta 发布公告

·阅读 4 分钟
Sébastien Lorber
Sébastien Lorber
Docusaurus 维护者，《本周 React》编辑
Joel Marcey
Joel Marcey
Meta 开发者布道师
Yangshun Tay
杨顺泰
Meta 前端工程师
Alexey Pyltsyn
Alexey Pyltsyn
开源爱好者

经过漫长的 Alpha 阶段，以确保功能齐全和质量，我们很高兴正式发布第一个Docusaurus 2 Beta 版本。

随着 Beta 版本的发布，团队更加确信 Docusaurus 2 **已准备好迎接主流采用**！

Docusaurus 采用情况​

不要害怕 Beta 标签！

Docusaurus 2 被广泛采用，并且发展迅速

Docusaurus v1 vs. v2 npm trends from 2019 to mid 2021. The installations of Docusaurus v2 is sharply rising, while v1 is mostly stable. V1 fluctuates between 10000 and 20000, while v2 starts at 0 and ends at almost 60000. The intersection happens around June 2020.

为了更全面地了解当前 Docusaurus 2 网站的质量，我们新的展示页面允许您按功能筛选 Docusaurus 网站，以便您可以从与您用例类似的真实生产网站中获得灵感！

不要错过我们的精选网站；它们都以独特之处脱颖而出

A screenshot of the showcase's favorites section, with 12 cards each displaying the information and preview of one site

为什么 Docusaurus v2 的 Alpha 阶段持续如此之久？​

很难相信第一个 Alpha 版本v2.0.0-alpha.0是在 2 年前发布的😳，对于软件 Alpha 阶段来说，时间异常长。

由于这是一次对代码库的大规模重新架构，因此我们希望确保在进入 Beta 阶段之前对 Docusaurus 2 的稳定性和功能充满信心，因为 Beta 表示高质量。我们很高兴地说，Docusaurus 2 已经实现了与 Docusaurus 1 的**功能均等**，并具有**国际化**功能，并且已被许多 Docusaurus 网站成功采用（请参阅国际化展示）。

我们现在相当有信心，Docusaurus 2 的核心功能足够稳定，可以进入 Beta 阶段。

Beta 阶段的目标是什么？​

现在 Docusaurus 2 已经稳定并且主要功能已完成，Beta 阶段的目标是让新用户相信 Docusaurus 2 已经**做好了生产准备**，将更多剩余的 Docusaurus 1 用户迁移到版本 2，并正式弃用 Docusaurus 1。当然，我们将继续解决可能发现的任何问题和错误。

此外，我们将利用 Beta 阶段来**改进我们的主题系统**。

我们希望使其

  • **更容易实现自定义主题**，包括我们自己。我们希望长期提供多个官方主题（包括Tailwind CSS）。

  • **更安全地扩展现有主题**：升级高度自定义的 Docusaurus 网站可能会很痛苦，因为自定义可能会与内部更改发生冲突。我们需要使主题公共 API 表面更加明确，并明确哪些内容可以安全地进行自定义。

我们将构建更好的**主题基础设施**，并重构经典主题以使用它。

如果您自定义了您的网站，您可能会发现这些计划的改进非常有价值。

有什么新功能？​

如果您错过了，我们最近发布了两项重大改进

接下来是什么？​

发布正式的 2.0 版本！

为了实现这一目标，我们将继续**修复错误**并实现**最受欢迎的功能**，包括

结论​

对于 Docusaurus 来说，这是一个激动人心的时刻。

我们受到关于 Docusaurus 的积极反馈的启发，并且每天都在网上发现新的网站。

我们对这个 Beta 版本感到非常兴奋。我们努力追求质量和稳定性，同时继续努力提高 Docusaurus 的采用率。对于那些一直犹豫是否将现有 Docusaurus 网站迁移到 Docusaurus 2 的用户来说，现在是升级的好时机。我们希望您在 Beta 阶段结束时我们弃用 Docusaurus 1 时使用最新的基础设施。请告诉我们如何才能提供帮助。

感谢大家的阅读，并感谢支持 Docusaurus 的整个社区。 🤗