跳到主要内容

发布 Docusaurus 2 Beta

·5 分钟阅读
Sébastien Lorber
Docusaurus 维护者,《本周 React》编辑
Joel Marcey
Meta 公司开发者倡导者
Yangshun Tay
Meta 前级工程师,GreatFrontEnd 联合创始人
Alexey Pyltsyn
开源爱好者

经过漫长的 alpha 阶段以确保功能完备性和质量后,我们很高兴正式发布第一个 Docusaurus 2 测试版

随着此 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 是两年前发布的 😳 ,对于软件的 alpha 阶段来说异常漫长。

由于这是对代码库的大规模重构,我们希望在进入 beta 阶段之前,确保 Docusaurus 2 的稳定性与功能性都达到我们的预期,因为 beta 意味着高水平的质量。我们很高兴地说,Docusaurus 2 已通过 i18n 实现了与 Docusaurus 1 的功能对等,并已被许多 Docusaurus 站点成功采用(请参阅 i18n 展示)。

我们现在非常有信心,Docusaurus 2 的核心功能已经足够稳定,可以进入 beta 阶段。

beta 阶段的目标是什么?

既然 Docusaurus 2 已经稳定且主要功能已完成,beta 阶段的目标是让新用户对 Docusaurus 2 的生产就绪状态充满信心,将更多剩余的 Docusaurus 1 用户迁移到版本 2,并正式弃用 Docusaurus 1。当然,我们将继续解决可能发现的任何问题和错误。

此外,我们将利用 beta 阶段改进我们的主题系统

我们希望使其

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

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

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

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

有什么新功能?

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

接下来是什么?

发布官方 2.0 版本!

为此,我们将继续修复 bug 并实现最需要的功能,包括

结论

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

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

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

感谢各位阅读,感谢所有支持 Docusaurus 的社区成员。🤗