跳到主要内容

Docusaurus 2 Beta 发布

· 阅读需 6 分钟
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 阶段来改进主题系统

这是我们想要实现的:

  • 更容易实现自定义主题,包括为我们自己。 我们希望长期提供多个官方主题(包括Tailwind CSS)。

  • 扩展现有主题更安全: 升级高度定制的Docusaurus站点可能会很痛苦,因为定制可能会与内部更改发生冲突。 我们需要使主题的公共API表面更明确,并明确什么是安全的定制。

我们将构建一个更好的 主题基础架构 ,并重构经典主题来使用它。

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

What's new?

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

何去何从?

发布 2.0 正式版本!

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

结语

对Docusaurus来说,这是一个令人激动的时刻。

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

我们对这个测试版感到非常兴奋。 我们努力提高质量和稳定性,同时继续努力提高Docusaurus的使用率。 对于那些一直在犹豫是否要将现有的Docusaurus站点迁移到Docusaurus 2的人来说,现在是升级的好时机。 当我们在这个测试版结束时弃用Docusaurus 1时,我们希望你能在最新的基础设施上运行。 请告诉我们有什么可以帮忙的。

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