发布 Docusaurus 2 Beta
经过漫长的 alpha 阶段以确保功能完备性和质量后,我们很高兴正式发布第一个 Docusaurus 2 测试版。
随着此 beta 版本的发布,团队对 Docusaurus 2 已准备好被主流采用更加充满信心!
Docusaurus 的采用情况
不必担心 beta 标签!
Docusaurus 2 已被广泛采用并快速增长
为了更全面地了解当前 Docusaurus 2 站点的质量,我们新的 展示页面允许您按功能筛选 Docusaurus 站点,这样您就可以从与您的用例相似的真实生产站点中获得灵感!
不要错过我们精选的站点;它们都以独特的风格脱颖而出
为什么 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 表面更明确,并明确什么可以安全地自定义。
我们将构建更好的主题基础设施,并重构经典主题以使用它。
如果您自定义您的站点,您可能会发现这些计划中的改进非常有价值。
有什么新功能?
如果您错过了,我们最近发布了两项重大改进
- 自动生成侧边栏:不再需要维护
sidebars.js
文件! - Webpack 5 / PostCSS 8:持久缓存显著加快了重建时间!
接下来是什么?
发布官方 2.0 版本!
为此,我们将继续修复 bug 并实现最需要的功能,包括
- 侧边栏分类索引页
- 更好的移动导航用户体验
- 更好的警示框设计
- 支持 CSS-in-JS
- 改进构建时间性能
- 扩展 Docusaurus 插件,CMS 集成
- 修复尾随斜杠和相对链接问题
- 更好地兼容 CommonMark
- 升级到 MDX 2.0
结论
这对 Docusaurus 来说是一个激动人心的时刻。
我们受到关于 Docusaurus 的积极反馈的鼓舞,并且每天都在网上发现新的站点。
我们对本次 beta 版发布感到非常兴奋。我们力求质量和稳定性,同时继续努力提高 Docusaurus 的采用率。对于那些一直在犹豫是否将现有 Docusaurus 站点迁移到 Docusaurus 2 的用户来说,现在是升级的好时机。我们希望在本次 beta 阶段结束并弃用 Docusaurus 1 时,您能运行在最新的基础设施上。请告诉我们如何提供帮助。
感谢各位阅读,感谢所有支持 Docusaurus 的社区成员。🤗