跳到主要内容

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 版能更加稳定,功能也更为完善。 我们很高兴地指出,Docusaurus 2 在 国际化 方面已经达到了与 Docusaurus 1 同等特性 的水平,并且它已经被许多 Docusaurus 站点 成功采用 了 (见 国际化案例) 。

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

Beta 阶段的目标有哪些?

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

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

这是我们想要实现的:

  • 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?

以防万一你错过了它,我们最近发布了两个主要改进:

何去何从?

发布 2.0 正式版本!

为此,我们会继续修复bugs并实现最想要的功能,包括:

结语

对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. 🤗