Docusaurus 2019 年回顾
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 monorepo 。我们相信这种插件架构将有助于构建社区,并允许用户为其独特的用例构建自己的功能。
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的完全功能等同,并帮助D1上剩余的Facebook项目迁移到D2。如果我们能够将Docusaurus用于内部文档,那就太好了,但这并非易事。如果您有这方面的需求或有一些想法,请与我们联系!
非常感谢社区的贡献,尤其是核心团队—— Endilie Yacop Sucipto , Alexey Pyltsyn , Wei Gao 。最后,感谢 Joel Marcey 启动Docusaurus并一直支持该项目。
祝2020年一切顺利!🎉