跳到主要内容

Docusaurus 2 Beta 发布

· 阅读需 5 分钟
Sébastien Lorber
Joel Marcey
Yangshun Tay
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 站点质量，我们的案例展示页面可以让您根据功能特性筛选网站。这样，您可以借鉴他人的生产网站来打造您专属的用例！

记得来看看我们的收藏网站，它们都有些独树一帜的特点：

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 发布于两年之前😳，我们的 Alpha 周期相比其他软件过于之长。

但因为我们对软件代码进行了大量重构，我们希望 Beta 版能更加稳定，功能也更为完善。 We are happy to say that Docusaurus 2 has reached feature parity with Docusaurus 1 with i18n, and it has been successfully adopted by many Docusaurus sites (see i18n showcase).

我们现在十分确定，Docusaurus 2 的核心功能已趋为完善，足以进入 Beta 阶段。

Beta 阶段的目标有哪些？​

目前，Docusaurus 2 已趋于稳定，主要功能也已完成。Beta 版本的目标是激励新用户在生产环境中使用 Docusaurus 2、迁移剩余的 Docusaurus 1 用户至新版，随后正式废弃 Docusaurus 1。 当然，我们也会不断解决任何新问题和漏洞。

除此之外，我们也会在 Beta 阶段来改进主题系统。

We want to make it:

  • easier to implement a custom theme, including for ourselves. We want to provide multiple official themes (including Tailwind CSS) for a long time.

  • safer to extend an existing theme: it can be painful to upgrade a highly customized Docusaurus site, as customizations can conflict with internal changes. We need to make the theme public API surface more explicit, and make it clear what is safe to customize.

We will build a better theming infrastructure and refactor the classic theme to use it.

If you customize your site, you may find these planned improvements quite valuable.

What's new?​

In case you missed it, we recently shipped two major improvements:

何去何从？​

发布 2.0 正式版本！

To get there, we will continue to fix bugs and implement the most wanted features, including:

结语​

This is an exciting time for Docusaurus.

We are inspired by the positive feedback about Docusaurus, and discover new sites online every single day.

We are so excited for this beta release. We strove for quality and stability while continuing to try to increase the adoption of Docusaurus. For those that have been on the fence from migrating an existing Docusaurus site to Docusaurus 2, it is a great time to upgrade. We want you running on the latest infrastructure when we deprecate Docusaurus 1 at the end of this beta period. Let us know how we can help.

Thank you to everyone for reading and to the entire community who supports Docusaurus. 🤗