标签: Docsy

亮点 一等 npm 支持：从 Registry 安装 Docsy，以及更多变化 Favicon：把图标放进 static/，其余工作交给 Docsy 共享页面框架（实验性）：大幅加速大型站点链接检查的构建模式 面向智能体的升级指南：可以直接交给 AI 助手 发布摘要 现代化打包： 移动主题目录：每种安装方式只需修改一行路径； Hugo Module 现在通过 npm 获取 Bootstrap 与 Font Awesome； 非 RTL 站点的 PostCSS 改为按需启用； Docsy 发布到 …

本文是 Docsy 0.16.0 发布文章的配套指南；后者说明了 0.16.0 要求并验证过的 Hugo 版本。 升级摘要 以下情况适合阅读本指南： 升级到 Docsy 0.16.0； 只升级 Hugo。 审阅 BREAKING 变更： 由 Hugo 管理的 Node 工具要求 Node 22+； HTML 内容与符号链接的安全规则发生变化。 审阅 弃用项： 语言配置与模板 API； 图片处理配置与模板 API。 可以快速浏览： Markdown 链接转义； 图片 URL 变动； 模板与 …

亮点 智能体支持：llms.txt、Markdown 页面输出，以及“查看 Markdown”页面元数据链接 文档根站点：改进把文档发布到站点根路径的支持 版本菜单：更丰富的条目与更新后的导航栏渲染 发布摘要 智能体支持（实验性）： 生成 llms.txt； 为首页、分区和页面内容生成 Markdown 备用输出； 页面存在 Markdown 备用版本时显示“查看 Markdown”页面元数据链接。 文档根站点（实验性）：记录将 docs 分区发布到站点根路径的模式，并提供对应样例变体； 版本 …

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.3 的破坏性变更与重要变化，是 Docsy 0.14.0 与 0.13.0 发布和升级指南的配套文章。 升级摘要 本指南重点说明 Hugo 0.152.0–0.155.x 的破坏性变更，以及可能需要执行的操作。 审阅 BREAKING 变更： YAML yes/no Token 变为字符串 多维站点的构建顺序发生变化 审阅 弃用项（不具破坏性，但建议处理）： Mount 的 lang 选项已弃用 …

亮点 Docsy 0.13.0 包含 2025 年得票最高的功能请求，以及更多改进。 本版带来新功能，而且只有少量破坏性变更。1 阅读我们使用 AI 升级 Docsy 项目的实践经验。 发布摘要 Docsy 0.13.0 包含以下重要功能与修复： 导航与用户体验改进，包括 2025 年 得票最高 的功能请求：目录活动项跟踪（#349、#2289）； 重写告警短代码，更好地支持 Markdown； 改进无障碍能力，增强颜色对比度和深色模式支持。 准备升级？ 审阅 BREAKING 变更： 告警短 …

我们没有为 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 说明 本文覆盖最常见的升级步骤。项目定制项可能还需要额外调整。建议在 独立分支 中完成这些变更，并在部署到 …

回顾 2024 年，我们很高兴看到项目稳步实现 2024 年工作重点中提出的目标。今年，我们专注于增强稳定性、改进国际化，并交付深色模式和持续集成（CI）测试等期待已久的功能。 2024 年，Docsy 的使用量从 1,400 个项目增长到 2,200 个，增幅达到 57%！1 下面一起回顾 2024 年的开发亮点，也展望一下后续计划。 版本亮点 今年我们发布了三个版本。每个版本都以稳定性为核心，同时至少引入一项重要功能增强： 0.9.0 增加了几项 期待已久 的能力： 通过 GitHub …

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 版本变 …

以 Docsy 的发布规模衡量，Docsy 0.9.0 是一次相当可观1的更新（包含 65 个以上 PR），其中有若干值得特别说明的破坏性和重要变更，主要涉及： Footer 改进 仓库链接及其他页面信息 外观与风格 持续集成测试 感谢所有贡献者！ Footer 改进 本版全部 Footer 改进与修复见 #1818。本节选取其中几项介绍。为了让定制更加容易，我们还为下一个主要版本规划了更多 Footer 改进（#1852）。 Footer 布局变更 为简化定制，Footer 布局被拆分为左、右 …

摘要：已有 1,400 个项目使用 Docsy！2024 年面向使用方项目的首要任务，是提升 Docsy 的稳定性、易用性、可定制性与整体一致性，同时整合现有功能。 Docsy 是广受欢迎的主题 Hugo 与 Docsy 的组合强大而高效，我也曾在其他文章中介绍过。因而，看到 Docsy 已被 1,400 个项目使用1，或许并不令人意外。Docsy 为什么受欢迎？我无法给出确切答案，但我之所以使用并推荐它，是因为它具备发布成熟技术文档站所需的核心能力：版本管理、多语言、自动生成站点导航等。它上 …

去年六月，Docsy 发布 0.7.0，迎来一项重要里程碑。这次重大升级源自历时六个月的细致工作（#470），核心任务是迁移到 Bootstrap 5.2。关于这段历程的亮点与缘由，请参阅迁移到 Bootstrap 5.2。 本文基于我升级 Docsy 0.7 的亲身经验，重点围绕 Bootstrap，帮助读者完成 Docsy 0.7 与 Bootstrap 5 升级。文章先为准备升级的 Docsy 项目提供通用建议。每个项目的迁移经历都不相同，但希望本文以及其中两个案例能让你的升级过程更轻松、 …

Docsy 以及使用 Docsy 的项目网站（包括 CNCF 项目）从一开始便一直愉快地采用 Bootstrap CSS 框架。今年一月，Docsy 过去几年使用的 Bootstrap 4 终止维护。Docsy 指导委员会一直期待 Bootstrap 5 带来的改进，却也担心迁移工作量及其对下游项目的影响，因此尽可能推迟了迁移。2022 年 12 月 Bootstrap 4 停止接收关键更新后，我们宣布 Docsy 进入功能冻结期，并把维护工作集中到 Bootstrap 5 迁移上。 本文记录 …

你好 一个已经存在数年的项目突然发布“你好”文章，或许有些奇怪。不过，随着 Docsy 逐渐成长为社区驱动的项目，我们觉得是时候重新介绍自己，也聊聊大家喜爱的——至少我们希望如此——Hugo 文档主题最近有哪些新进展。 欢迎参与讨论 最近，我们的 Discussions 十分活跃！请不要错过关于即将弃用 Font Awesome 与 Bootstrap Git 子模块的通知，以及全新治理模式的公告。 里程碑、版本与路线图 我们计划很快发布 Docsy 的首个正式版本——可以查看 0.2.0 里程 …