标签: 升级
0.16.0 发布报告与升级指南
2026年7月29日 在 博客
亮点 一等 npm 支持：从 Registry 安装 Docsy，以及更多变化 Favicon：把图标放进 static/，其余工作交给 Docsy 共享页面框架（实验性）：大幅加速大型站点链接检查的构建模式 面向智能体的升级指南：可以直接交给 AI 助手 发布摘要 现代化打包： 移动主题目录：每种安装方式只需修改一行路径； Hugo Module 现在通过 npm 获取 Bootstrap 与 Font Awesome； 非 RTL 站点的 PostCSS 改为按需启用； Docsy 发布到 …
亮点 一等 npm 支持：从 Registry 安装 Docsy，以及更多变化 Favicon：把图标放进 static/，其余工作交给 Docsy 共享页面框架（实验性）：大幅加速大型站点链接检查的构建模式 面向智能体的升级指南：可以直接交给 AI 助手 发布摘要 现代化打包： 移动主题目录：每种安装方式只需修改一行路径； Hugo Module 现在通过 npm 获取 Bootstrap 与 Font Awesome； 非 RTL 站点的 PostCSS 改为按需启用； Docsy 发布到 …
Hugo 0.158.0–0.164.x 升级指南
2026年7月28日 在 博客
本文是 Docsy 0.16.0 发布文章的配套指南；后者说明了 0.16.0 要求并验证过的 Hugo 版本。 升级摘要 以下情况适合阅读本指南： 升级到 Docsy 0.16.0； 只升级 Hugo。 审阅 BREAKING 变更： 由 Hugo 管理的 Node 工具要求 Node 22+； HTML 内容与符号链接的安全规则发生变化。 审阅 弃用项： 语言配置与模板 API； 图片处理配置与模板 API。 可以快速浏览： Markdown 链接转义； 图片 URL 变动； 模板与 …
本文是 Docsy 0.16.0 发布文章的配套指南；后者说明了 0.16.0 要求并验证过的 Hugo 版本。 升级摘要 以下情况适合阅读本指南： 升级到 Docsy 0.16.0； 只升级 Hugo。 审阅 BREAKING 变更： 由 Hugo 管理的 Node 工具要求 Node 22+； HTML 内容与符号链接的安全规则发生变化。 审阅 弃用项： 语言配置与模板 API； 图片处理配置与模板 API。 可以快速浏览： Markdown 链接转义； 图片 URL 变动； 模板与 …
0.15.0 发布报告与升级指南
2026年5月1日 在 博客
亮点 智能体支持：llms.txt、Markdown 页面输出，以及“查看 Markdown”页面元数据链接 文档根站点：改进把文档发布到站点根路径的支持 版本菜单：更丰富的条目与更新后的导航栏渲染 发布摘要 智能体支持（实验性）： 生成 llms.txt； 为首页、分区和页面内容生成 Markdown 备用输出； 页面存在 Markdown 备用版本时显示“查看 Markdown”页面元数据链接。 文档根站点（实验性）：记录将 docs 分区发布到站点根路径的模式，并提供对应样例变体； 版本 …
亮点 智能体支持：llms.txt、Markdown 页面输出，以及“查看 Markdown”页面元数据链接 文档根站点：改进把文档发布到站点根路径的支持 版本菜单：更丰富的条目与更新后的导航栏渲染 发布摘要 智能体支持（实验性）： 生成 llms.txt； 为首页、分区和页面内容生成 Markdown 备用输出； 页面存在 Markdown 备用版本时显示“查看 Markdown”页面元数据链接。 文档根站点（实验性）：记录将 docs 分区发布到站点根路径的模式，并提供对应样例变体； 版本 …
0.14.0 发布报告与升级指南
2026年2月10日 在 博客
0.14.1 至 0.14.3 补丁更新 这些补丁版本的关键修复见 0.14.1、0.14.2 与 0.14.3。0.14.2 的其他变化见补丁更新 0.14.2。如果现在升级，请按照本指南操作，并在文中提到 0.14.0 的地方使用 0.14.3。 亮点 样式与定制：改进导航栏，重新组织 SCSS 文件 内容与本地化：新增 Markdown 告警语法并改进国际化 要求 Hugo 0.155.0，以及 0.153+ 的破坏性与重要变化 发布摘要 样式与定制： 导航栏改进，包括可配置浅色/深色主题 …
0.14.1 至 0.14.3 补丁更新 这些补丁版本的关键修复见 0.14.1、0.14.2 与 0.14.3。0.14.2 的其他变化见补丁更新 0.14.2。如果现在升级，请按照本指南操作，并在文中提到 0.14.0 的地方使用 0.14.3。 亮点 样式与定制：改进导航栏，重新组织 SCSS 文件 内容与本地化：新增 Markdown 告警语法并改进国际化 要求 Hugo 0.155.0，以及 0.153+ 的破坏性与重要变化 发布摘要 样式与定制： 导航栏改进，包括可配置浅色/深色主题 …
Hugo 0.152.0–0.155.x 升级指南
2026年2月9日 在 博客
本文总结 Hugo 0.152.0 至 0.155.3 的破坏性变更与重要变化，是 Docsy 0.14.0 与 0.13.0 发布和升级指南的配套文章。 升级摘要 本指南重点说明 Hugo 0.152.0–0.155.x 的破坏性变更，以及可能需要执行的操作。 审阅 BREAKING 变更： YAML yes/no Token 变为字符串 多维站点的构建顺序发生变化 审阅 弃用项（不具破坏性，但建议处理）： Mount 的 lang 选项已弃用 …
本文总结 Hugo 0.152.0 至 0.155.3 的破坏性变更与重要变化，是 Docsy 0.14.0 与 0.13.0 发布和升级指南的配套文章。 升级摘要 本指南重点说明 Hugo 0.152.0–0.155.x 的破坏性变更，以及可能需要执行的操作。 审阅 BREAKING 变更： YAML yes/no Token 变为字符串 多维站点的构建顺序发生变化 审阅 弃用项（不具破坏性，但建议处理）： Mount 的 lang 选项已弃用 …
0.13.0 发布报告与升级指南
2025年11月24日 在 博客
亮点 Docsy 0.13.0 包含 2025 年得票最高的功能请求，以及更多改进。 本版带来新功能，而且只有少量破坏性变更。1 阅读我们使用 AI 升级 Docsy 项目的实践经验。 发布摘要 Docsy 0.13.0 包含以下重要功能与修复： 导航与用户体验改进，包括 2025 年 得票最高 的功能请求：目录活动项跟踪（#349、#2289）； 重写告警短代码，更好地支持 Markdown； 改进无障碍能力，增强颜色对比度和深色模式支持。 准备升级？ 审阅 BREAKING 变更： 告警短 …
亮点 Docsy 0.13.0 包含 2025 年得票最高的功能请求，以及更多改进。 本版带来新功能，而且只有少量破坏性变更。1 阅读我们使用 AI 升级 Docsy 项目的实践经验。 发布摘要 Docsy 0.13.0 包含以下重要功能与修复： 导航与用户体验改进，包括 2025 年 得票最高 的功能请求：目录活动项跟踪（#349、#2289）； 重写告警短代码，更好地支持 Markdown； 改进无障碍能力，增强颜色对比度和深色模式支持。 准备升级？ 审阅 BREAKING 变更： 告警短 …
从 Docsy 0.11.0 升级到 0.12.0
2025年11月11日 在 博客
我们没有为 0.12.0 发布版本公告，因此借此机会完整介绍从 0.11.0 升级到 0.12.0 的过程。 摘要：Docsy 0.12.0 的主要破坏性变更来自 Hugo 的新模板系统，它改变了 layouts 子目录和文件名。 本文将依次完成以下升级： Docsy：0.11.0 → 0.12.0 Hugo：0.136.2 → 0.147.51 Node：LTS 20 → LTS 221 说明 本文覆盖最常见的升级步骤。项目定制项可能还需要额外调整。建议在 独立分支 中完成这些变更，并在部署到 …
我们没有为 0.12.0 发布版本公告，因此借此机会完整介绍从 0.11.0 升级到 0.12.0 的过程。 摘要：Docsy 0.12.0 的主要破坏性变更来自 Hugo 的新模板系统，它改变了 layouts 子目录和文件名。 本文将依次完成以下升级： Docsy：0.11.0 → 0.12.0 Hugo：0.136.2 → 0.147.51 Node：LTS 20 → LTS 221 说明 本文覆盖最常见的升级步骤。项目定制项可能还需要额外调整。建议在 独立分支 中完成这些变更，并在部署到 …