# Docsy 0.10.0 发布报告

LLMS index: [llms.txt](/oink.pgsty.com/llms.txt)

---

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

## Hugo：破坏性变更与弃用通知 {#hugo-breaking-changes-and-deprecation-notices}

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

[0.123.0]: https://github.com/gohugoio/hugo/releases/tag/v0.123.0

> [!IMPORTANT] 提醒
>
> Docsy 及其对等软件包的正式支持范围见[正式支持边界](/zh/project/about/changelog/#official-support)。

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

## 颜色主题与深色模式支持 {#color-themes-and-dark-mode-support}

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

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

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

[#331]: https://github.com/google/docsy/issues/331
[#1528]: https://github.com/google/docsy/issues/1528
[颜色模式]: https://getbootstrap.com/docs/5.3/customize/color-modes/
[深色模式]: https://getbootstrap.com/docs/5.3/customize/color-modes/#dark-mode
[浅色/深色模式菜单]: /zh/docs/content/lookandfeel/#lightdark-mode-menu
[用户指南]: /zh/docs/

> [!NOTE] 重要样式变更
>
> 为兼容浅色和深色模式，以下短代码与页面元素的样式已经调整。
>
> 如果曾定制这些短代码和元素相关的 SCSS，就需要 **重新检查项目样式**。
>
> - [`alert`][]（[#1908][]）
> - [`card`][]（[#1922][]）
> - [`pageinfo`][]（[#1915][]）
> - [标签页][]短代码（[#1920][]）
>
> [搜索框样式][#1896]与[文档页左侧导航][#1908]也已调整。
>
> [#1896]: https://github.com/google/docsy/pull/1896
> [#1908]: https://github.com/google/docsy/pull/1908
> [#1915]: https://github.com/google/docsy/pull/1915
> [#1920]: https://github.com/google/docsy/pull/1920
> [#1922]: https://github.com/google/docsy/pull/1922
> [`alert`]: /zh/docs/content/shortcodes/#alert
> [`card`]: /zh/docs/content/shortcodes/#shortcode-card-programming-code
> [`pageinfo`]: /zh/docs/content/shortcodes/#pageinfo
> [标签页]: /zh/docs/content/shortcodes/#tabbed-panes

## 发布详情 {#release-details}

本版完整变更清单——包括 Font Awesome、Mermaid、Algolia 与 KaTeX 更新——请查看
[0.10.0][] 发布条目和
[0.10.0 发布准备（#1759）](https://github.com/google/docsy/issues/1759)。

## 接下来是什么？ {#whats-next}

Docsy 后续将有哪些改进？下一版暂定工作项见
[0.11.0 发布准备（#1944）](https://github.com/google/docsy/issues/1944)。

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

[0.10.0]: https://github.com/google/docsy/releases/tag/v0.10.0