Docsy 0.10.0 发布报告

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

Docsy 0.10.0 最大的新闻，是颜色主题与深色模式！

Hugo：破坏性变更与弃用通知

这个版本把 Docsy 的 Hugo 依赖从 0.122.0 升级到 0.125.4。需要特别注意：Hugo 0.123.0 是一次重大升级，包含若干 破坏性变更。升级到本版 Docsy 前，请审阅 Hugo 自 0.122.0 以来的弃用通知与破坏性变化。

提醒

Docsy 及其对等软件包的正式支持范围见正式支持边界。

本次发布的许多更新用于处理 Hugo 弃用通知。完整清单可在 0.10.0 版本变更中搜索标题含有“deprecat”的条目。

本版最主要的功能，是通过升级到 Bootstrap 5.3（#1528）从 5.2 迁移到 5.3。这个 Bootstrap 次要版本引入了颜色模式，也称颜色主题。

作为升级验证，Docsy 新增了深色模式支持；在本版发布前，这是 Docsy 得票最高的功能请求（#331）。

如何为项目启用 浅色/深色模式下拉菜单，请参阅浅色/深色模式菜单。Docsy 用户指南已经启用该菜单；如果你正在在线阅读本文，不妨切换到深色模式试试看。

重要样式变更

为兼容浅色和深色模式，以下短代码与页面元素的样式已经调整。

如果曾定制这些短代码和元素相关的 SCSS，就需要 重新检查项目样式。

本版完整变更清单——包括 Font Awesome、Mermaid、Algolia 与 KaTeX 更新——请查看 0.10.0 发布条目和 0.10.0 发布准备（#1759）。

Docsy 后续将有哪些改进？下一版暂定工作项见 0.11.0 发布准备（#1944）。

投票

如果希望某项功能或修复进入后续版本，请记得为相关 Issue 或 PR 点赞投票。