跳至主要内容

Docusaurus 2019 年回顾

·阅读时长 3 分钟
Yangshun Tay
Meta 前端工程师

2019 年对 Docusaurus 来说是伟大的一年,我们在 Docusaurus 2 上取得了巨大进展。目前还没有使用翻译功能的 Docusaurus 1 用户可以随意试用并 迁移 到它!否则我们将与您合作,在 2020 年实现这一点 :)

Docusaurus 2 (D2)

在 2018 年,我们提出要从头开始重建 Docusaurus。这涉及到一个重大的架构重构工作——我们从头开始创建了一个以内容为中心的 CSS 框架、一个插件系统,并从静态 HTML 页面迁移到具有预渲染路由的单页应用程序。这真是一段疯狂的冒险,而且是一项艰巨的任务,尤其是在没有专门的 FTE 从事该项目的情况下。在我们的前实习生、贡献者和维护者 @endilie 的帮助下,我们在 D2 上取得了非常好的进展,目前已经发布了 2.0.0-alpha.40 版本。除了翻译之外,Docusaurus 1 中的所有功能都已移植过来。

D2 的杀手级功能是暗黑模式及其出色的性能。D2 开箱即用地支持暗黑模式,并且创建暗黑模式友好的文档网站非常容易。Endilie 为优化网站性能付出了巨大的努力,并且默认情况下在后台进行了一系列性能优化技巧,包括优化图像、将每个路由预渲染为静态 HTML,然后进行客户端路由、在用户将鼠标悬停在导航链接上时预取未来导航所需的资产等。

最后但同样重要的是,我们实施了一个插件架构,并将仓库转换为 Lerna 单仓库。我们相信这种插件架构将有助于构建社区,并允许用户为其独特的用例构建自己的功能。

GitHub 活动

  • 星标:10050 → 14632 (+45.6% 年同比)
  • 总贡献者:182 → 303 (+66.4% 年同比)。其中大多数是非 Facebook 贡献者
  • 每日 npm 下载量:728 → 2320 (+218.7% 年同比)。峰值出现在 11 月份
  • D1 目前在 GitHub 上被 3872 个项目使用,而 D2 在 GitHub 上被 247 个项目使用
  • 我们现在有 4 位活跃的核心贡献者! (+100% 年同比)

知名用户

开源社区中很大一部分项目都在使用 Docusaurus。今年下半年,我们还将更多知名项目引入了 Docusaurus 2

并欢迎更多项目加入 Docusaurus 1

媒体

Yangshun 在 F8 上做了一次课堂讲座,内容是关于 使用 Docusaurus 创建开源网站 的。

社区

一些第三方托管/开发服务也与 Docusaurus 设置进行了无缝集成

展望未来

D2 在 开发者社区 中获得了一些关注。在 2020 年,我们希望在上半年实现与 D1 的完全功能一致,并帮助 Facebook 上剩余的 D1 项目迁移到 D2。如果我们能够将 Docusaurus 用于内部文档,那也会很棒,但这并非易事。如果您对此有需求或有任何想法,请与我们联系!

衷心感谢社区的贡献,尤其是核心团队——Endilie Yacop SuciptoAlexey PyltsynWei Gao。最后,感谢 Joel Marcey 启动 Docusaurus 并一直支持该项目。

祝大家 2020 年一切顺利!🎉