跳到主要内容

Docusaurus 2021 回顾

·阅读时长7分钟
Joshua Chen
Joshua Chen
为 Docusaurus 努力工作

Docusaurus 在2021年取得了巨大进展！我们获得了大量关注，并且在 GitHub 上刚刚突破了 3 万颗星！

在国际化功能发布后，我们与 v1 实现了完整的功能对等，发布了我们的首个 beta 版本，并在今年迎来了显著增长的用户。

v2 正式版即将发布！请关注路线图议题以获取最新消息。

亮点​

让我们先回顾一下今年的几个亮点。还记得半年前的待办事项列表吗？是时候再次回顾，看看我们已经取得了多大进展了！

  • 国际化：在2020年末首次发布后四个月正式发布。已在许多项目中取得巨大成功
  • 自动生成侧边栏：不再需要维护庞大的sidebars.js文件
  • Webpack 5：显著提升构建性能
  • 末尾斜杠配置：与任何内容托管提供商无缝集成
  • 重新设计的移动导航：移动用户现在可以享受到与桌面端相同的所有导航功能
  • UI 改进：更易访问的引用、更好的提示框、返回顶部按钮...
  • 博客多作者支持：感谢所有共同撰写博客文章的杰出贡献者！
  • 更多博客功能：归档页面、SEO 结构化数据、feed 中完整的文章内容——助您快速发布功能齐全的博客
  • 资产共置：不再需要臃肿的静态文件夹：将图片与 Markdown 文件放在一起
  • 侧边栏类别索引页面：类别标签现在可以与页面关联，从而更好地组织文档

我们的代码库也随着时间的推移得到了完善。我们改进了测试覆盖率，将所有包迁移到 TypeScript，并将发布的捆绑包大小最大减少了60%！

npm​

Docusaurus v2 持续稳定增长。v2 的安装量现在是 v1 的8倍。在周下载量方面，我们又看到了三倍的增长（+209.4%），从1月初的28,066次增长到12月中旬的峰值86,846次。

Docusaurus v1 vs. v2 npm trends of the year 2021. The installations of Docusaurus v2 is constantly rising, while v1 is almost constant. V1 stays at 10000, while v2 grows from 30000 to almost 90000. There's a sharp drop from 90000 to 40000 just before the Jan 2022 line.

（啊，经典的圣诞节下滑...）

我们发布了18个版本，从2.0.0-alpha.71到2.0.0-beta.14。这意味着每20天发布一个版本！

GitHub​

  • 星标：20,460 → 29,679（同比增长 +45.1%）。就在这篇博客文章发布前，我们已经达到了3万颗星！
  • 总贡献者人数：512 → 773（同比增长 +51.0%）
  • 依赖项目数：v2 为 5,039 → 14,579（同比增长 +189.3%），v1 为 6,311 → 7,581（同比增长 +20.1%）
  • 提交：去年共提交1,187次，平均每周23次提交
  • 议题：共开启619个议题，其中505个最终得到解决
  • 一位新的核心团队成员（没错，就是我😝）

我们的星标趋势也非常积极。与同类项目相比，我们增长速度更快

Stars trend by year of 9 static site generators. Next.js grows the fastest, with Docusaurus at the 4th place in terms of growth rate.

星标增加了8.4k，在今年的JavaScript 静态站点生成器新星榜中，我们排名第三，仅次于 Next.js 和 Astro。

Docusaurus placing 3rd in the "Static Sites" ranking list

我们的展示区迎来了一些新的“精选”网站，它们展示了 Docusaurus 2 可插拔架构的真正潜力。

Iota wiki light modeIota wiki dark mode

Dyte light modeDyte dark mode

Ionic light modeIonic dark mode

Courier

Docusaurus 用户的创造力超乎我们的想象 🤩 我们期待越来越多的采用者利用 Docusaurus 的内容特性，同时探索原创主题设计！如果您的网站使用了 Docusaurus，我们非常乐意将其纳入我们的展示区。

社区​

作为 Discord 上的一名活跃版主，我清楚地看到社区蓬勃发展。许多常见问题现在已集成到我们的文档中，一些功能请求也已实现。项目和社区相互受益——举例来说，我在成为维护者之前曾是一名社区贡献者。

我们经常在 X 上收到鼓舞人心的反馈

@docusaurus 太棒了！简直不敢相信它用起来如此简单。

无需额外的插件、工具或编译步骤。开箱即用。

我爱 @docusaurus。没有 Docusaurus，我无法在我的工作流程中如此高效、美观地构建我的网站中所包含的 API 文档、教程和博客。

我们将这些都保存在我们的小盒子里 😄 如果您也喜欢 Docusaurus，请继续在您的评论中标记我们！

随着正式发布的临近，我们有兴趣了解更多大家正在做的事情：插件开发者、定制网站的创建者，以及所有新用户——请随时告知我们您的成就，以便我们能更好地调整开发方向，满足您的需求。

展望未来​

在过去的几个月里，我们一直在讨论 Docusaurus 的发布候选阶段，是的，它即将到来。我们已经创建了一个专门的里程碑，以跟踪所有需要解决的问题，以便我们能够自信地进入下一阶段。简而言之，我们希望构建一个更强大的主题工作流，让有创意的网站创建者可以自定义我们的默认主题，而无需担心升级时出现破坏性更改。这将包括

  • 关于组件组织的指导方针。我们希望主题组件具有适当的粒度，这样当您想自定义网站的某个部分时，总会有一个组件能满足您的需求。
  • 对 swizzle CLI 的改进。我们希望用户能愉快地使用它，并让它在所有可能的 swizzle 场景中助您一臂之力。
  • 重构我们的主题 API。我们希望所有可 swizzle 的组件都真正适合 swizzle，因此非 UI 组件将被重新定位。
  • 文档。我们希望我们的文档对所有人都能最大限度地易于访问——从初学者到经验丰富的 Web 开发人员。我们将它组织成一个更具渐进性的教程，对所有技能水平都有益。

在此路线图议题中阅读更多关于 Docusaurus 2.0 的计划。在社区的帮助下，2.0 将会是一个更棒的版本，因此请在任何里程碑议题下分享您的意见和建议！

核心团队正在努力发布通用版本，我们计划在2.0之后以小版本发布其他有用的功能。我们甚至为3.0中的架构更改制定了进一步的计划！

随着 Docusaurus 2.0 的正式发布，我们有信心看到更多新的采用和从 v1 的迁移。

我们要向2021年的所有贡献者表示感谢，包括

  • 核心团队：Alexey Pyltsyn、Sébastien Lorber、Joshua Chen 和 Yangshun Tay，他们负责社区管理、宣传 Docusaurus、分类处理议题以及实现新功能
  • Joel Marcey，他创建了 Docusaurus 并一直支持其开发
  • Algolia 团队，他们帮助 Docusaurus 用户迁移到新的 DocSearch 并回答了与搜索相关的问题
  • 所有活跃的社区成员，他们贡献了宝贵的代码，改进了我们的文档，并在 Discord 上回答了问题

再见了，2021！让我们迎接一个美好的2022！