Docusaurus 2021 年回顾

Docusaurus 在 2021 年取得了巨大进步！我们看到了很多关注，并且刚好在 **GitHub 上突破了 30,000 颗星**！

在 发布国际化功能 之后，我们已经 **实现了与 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 次。

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

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

GitHub

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

我们的星数趋势也十分积极。与类似项目相比，我们的 **增长速度更快**

随着星数增加了 8,400 颗，我们在今年的 JavaScript 静态网站生成器新星榜 上排名第三，仅次于 Next.js 和 Astro。

精选采用

我们的展示区迎来了几个新的 "最喜欢的网站"，这些网站展示了 Docusaurus 2 可插拔架构的真正潜力。

• IOTA-wiki

• Dyte

• Ionic

• Courier

Docusaurus 用户的创造力超乎我们的想象 🤩 我们期待着更多采用者利用 Docusaurus 的内容功能，同时探索原创主题设计！如果您网站使用了 Docusaurus，我们很乐意 将它添加到我们的展示区 中。

社区

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

我们在 Twitter 上经常被提及，并收到了鼓舞人心的反馈

**@docusaurus** 太棒了！真不敢相信它使用起来这么简单。

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

我喜欢 **@docusaurus**。如果没有 Docusaurus，我无法在自己的工作流程中高效而美观地构建网站中包含的 API、教程和博客。

并且我们把他们都放在 我们的小盒子 里 😄 如果您自己也喜欢 Docusaurus，请继续在评论中添加我们的标签！

随着我们正式发布版本的临近，我们渴望了解更多关于人们在做什么：插件作者、自定义网站的创建者 以及 所有新用户 - 请让我们了解您的成就，以便我们能够引导我们的开发工作，更好地满足您的需求。

展望未来

在过去的几个月里，我们一直在不断谈论 Docusaurus 的发布候选阶段，是的，它马上就要来了。我们创建了一个专门的 里程碑 来跟踪我们在自信地进入下一阶段之前需要解决的所有问题。简而言之，我们希望构建一个 **更强大的主题工作流程**，使富有创造力的网站创建者能够自定义我们的默认主题，而无需担心在升级时出现破坏性更改。这将包括

• 关于 **组件组织** 的指南。我们希望主题组件具有正确的粒度，以便当您想要自定义网站的一部分时，总会有一个组件可以满足您的需求。
• 对 **swizzle CLI** 的改进。我们希望用户能够愉快地使用它，并让它帮助您完成所有可能的 swizzling 场景。
• 重构我们的 **主题 API**。我们希望所有可 swizzle 的组件都真正适合 swizzling，因此非 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 年！