在 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 阶段来改进主题系统。
这是我们想要实现的:
-
更容易实现自定义主题,包括为我们自己。 我们希望长期提供多个官方主题(包括Tailwind CSS)。
-
扩展现有主题更安全: 升级高度定制的Docusaurus站点可能会很痛苦,因为定制可能会与内部更改发生冲突。 我们需要使主题的公共API表面更明确,并明确什么是安全的定制。
我们将构建一个更好的 主题基础架构 ,并重构经典主题来使用它。
如果您自定义您的网站,您可能会发现这些计划的改进非常有价值。
What's new?
以防万一你错过了它,我们最近发布了两个主要改进:
- 自动生成侧边栏:不再需要维护一个
sidebars.js
文件。 - Webpack 5 / PostCSS 8: persistent caching significantly speeds up rebuild time!
何去何从?
发布 2.0 正式版本!
为此,我们会继续修复bugs并实现最想要的功能,包括:
- 侧边栏类别索引页
- 更好的移动导航用户体验
- 更好的警告设计
- CSS-in-JS support
- Improve build time performance
- Extend Docusaurus plugins, CMS integration
- 修复尾随斜杠和相对链接问题
- 与CommonMark更好的兼容性
- Upgrade to MDX 2.0
结语
对Docusaurus来说,这是一个令人激动的时刻。
我们受到关于Docusaurus的积极反馈的启发,每天都在网上发现新的网站。
我们对这个测试版感到非常兴奋。 我们努力提高质量和稳定性,同时继续努力提高Docusaurus的使用率。 对于那些一直在犹豫是否要将现有的Docusaurus站点迁移到Docusaurus 2的人来说,现在是升级的好时机。 当我们在这个测试版结束时弃用Docusaurus 1时,我们希望你能在最新的基础设施上运行。 请告诉我们有什么可以帮忙的。
感谢大家的阅读和整个支持Docusaurus的社区。 🤗