在 Alpha 阶段把关软件质量许久后,我们终于能很高兴地发布 Docusaurus 2 的**首个 Beta 测试版本**。
Beta 版本的发布,意味着开发团队更加确信 Docusaurus 2 已适合大众使用!
使用 Docusaurus
别害怕 Beta 标签!
Docusaurus 2 被广泛使用,用户数量飞增:
要深入了解当前的 Docusaurus 2 站点质量,我们的案例展示页面可以让您根据功能特性筛选网站。这样,您可以借鉴他人的生产网站来打造您专属的用例!
记得来看看我们的收藏网站,它们都有些独树一帜的特点:
为何 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?
以防万一你错过了它,我们最近发布了两个主要改进:
- 自动生成侧边栏:不再需要维护一个
sidebars.js
文件。 - Webpack 5 / PostCSS 8: persistent caching significantly speeds up rebuild time!
何去何从?
发布 2.0 正式版本!
为此,我们会继续修复bugs并实现最想要的功能,包括:
- 侧边栏类别索引页
- 更好的移动导航用户体验
- Better admonition design
- CSS-in-JS support
- Improve build time performance
- Extend Docusaurus plugins, CMS integration
- 修复尾随斜杠和相对链接问题
- Better compatibility with CommonMark
- Upgrade to MDX 2.0
结语
对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. 🤗