Docsy 2024 年回顾：采用与增强

回顾 Docsy 2024 年在功能与采用方面的增长：使用量提高 57%，新增深色模式，并改进国际化支持。

撰文： Patrice Chalin（CNCF），代表 Docsy 指导委员会 | 2024年12月12日

回顾 2024 年，我们很高兴看到项目稳步实现 2024 年工作重点中提出的目标。今年，我们专注于增强稳定性、改进国际化，并交付深色模式和持续集成（CI）测试等期待已久的功能。

2024 年，Docsy 的使用量从 1,400 个项目增长到 2,200 个，增幅达到 57%！¹

下面一起回顾 2024 年的开发亮点，也展望一下后续计划。

版本亮点

今年我们发布了三个版本。每个版本都以稳定性为核心，同时至少引入一项重要功能增强：

0.9.0 增加了几项 期待已久 的能力：
- 通过 GitHub Actions 运行 CI 测试，保障 Linux 与 Windows 上的质量和可靠性；
- Footer 定制——解决 Docsy 存在时间最长的 Issue（#2）！——同时改进仓库链接、无障碍能力与外观风格。
0.10.0：
- 升级到 Bootstrap 5.3，启用颜色主题和 深色模式，标志着 2021 年启动的 Bootstrap 5 迁移正式完成；同时调整短代码与样式，以兼容深色模式；
- 处理核心 Hugo 升级到 0.123.0 带来的破坏性变更。
0.11.0：
- 利用 Bootstrap 的 RTL 能力重新引入 从右向左（RTL）语言支持，增强国际化。

除了有助于提升 Docsy 稳定性的关键开发功能 CI 测试，2024 年还引入了以下主要用户功能。

深色模式在 v0.10.0 亮相之前，是 Docsy 得票最高的功能请求。该功能以 Bootstrap 5.3 颜色主题为基础，并内置浅色/深色模式菜单选择器，便于项目启用。

我们计划在 Docsy 示例中启用深色模式，进一步降低采用成本。OpenTelemetry 等知名项目已经采用深色模式（opentelemetry.io#4023）。

RTL 语言支持（#1933）借助 Bootstrap 使用的成熟、经过充分检验的 RTLCSS 框架重新实现，取代了 Docsy 在 2023 年弃用的自定义 RTL 方案。

这项增强满足了多语言文档长期以来的需求。多个使用 Docsy 的大型站点都曾请求 RTL 支持，其中包括 CNCF 2024 年两个开发活跃度最高的项目：

Docsy 使用量持续增长，是 2024 年最令人振奋的进展之一。GitHub 分析数据显示，截至本文写作时，使用量 增长 57%，达到 2,200 个项目。

与 2023 年报告相比，CNCF 项目的采用量也有所增加。今年，Linux Foundation 导师项目学员 Sandra Dindi 与 Dariksha Ansari 使用 CNCF Docsy Starter，把以下站点迁移到 Docsy：

此外，Kubernetes 网站正在进行一次从 v0.2 起步的大规模 Docsy 升级，以对齐最新版本并减少技术债务：

升级进展顺利，可以查看正在推进的 0.3.x 升级和 0.5.x 升级。

展望未来，我们很高兴能继续支持 gRPC（grpc.io#1389）与 Jaeger（jaegertracing#746）等项目升级和采用 Docsy。

2025 年首个版本暂定功能见 0.12.0 发布准备。目前得票最高的增强请求包括：²

感谢所有贡献者和用户，让 2024 年成为 Docsy 意义非凡的一年。祝大家在 2024 年末一切顺利，并以美好开局迎接 2025 年！让我们继续共同打造卓越的文档。