跳到主要内容

Docusaurus 2019 回顾

·4分钟阅读
Yangshun Tay
Meta 前级工程师,GreatFrontEnd 联合创始人

2019年对Docusaurus来说是伟大的一年——我们在Docusaurus 2上取得了巨大进展。目前未使用翻译功能的Docusaurus 1用户可以自由地尝试并迁移到Docusaurus 2!否则我们将在2020年与您合作实现这一目标 : )

Docusaurus 2 (D2)

2018年,我们提议从头开始重建Docusaurus。这涉及一项重大的架构重建工作——我们从零开始创建了一个以内容为中心的CSS框架,一个插件系统,并从静态HTML页面转变为一个带预渲染路由的单页应用。这是一次大胆的冒险和一项艰巨的任务,尤其是在没有专职全职员工(FTE)参与项目的情况下。在我们的前实习生、现贡献者兼维护者@endilie的帮助下,我们在D2上取得了非常好的进展,目前版本是2.0.0-alpha.40。Docusaurus 1中的所有功能,除了翻译功能外,都已经移植过来。

D2的杀手级功能是深色模式及其卓越的性能。D2开箱即用支持深色模式,创建深色模式友好的文档网站几乎不费吹灰之力。Endilie在优化网站性能方面投入了巨大努力,默认情况下,幕后已完成了许多性能优化技巧——优化图像、将每个路由预渲染为静态HTML并随后进行客户端路由、当用户悬停在导航链接上时预取未来导航所需的资产等。

最后但同样重要的是,我们实现了插件架构,并将仓库变成了Lerna monorepo。我们相信这种插件架构将有助于构建社区,并允许用户根据其独特的使用场景构建自己的功能。

GitHub 活动

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

知名用户

开源社区中的很大一部分项目都使用Docusaurus。本半年我们也将更多知名项目引入了Docusaurus 2。

并欢迎更多项目加入Docusaurus 1

媒体报道

Yangshun在F8会议期间进行了一场关于如何使用Docusaurus创建开源网站的课堂分享。

社区

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

展望未来

D2在开发者社区中获得了一定的关注。2020年,我们希望在上半年实现与D1的全部功能对等,并帮助D1上剩余的Facebook项目迁移到D2。如果能将Docusaurus用于内部文档也将非常棒,但这并非易事。如果您有此需求或有一些想法,欢迎与我们交流!

非常感谢社区的贡献,特别是核心团队——Endilie Yacop SuciptoAlexey PyltsynWei Gao。最后,感谢Joel Marcey启动Docusaurus并一直以来支持这个项目。

祝愿2020年一切顺利!🎉