博客
OINK 实现预览正式亮相
2026年8月8日 在 博客
今天，我们发布 OINK 实现预览：它从 Docsy 直接演化而来，提供唯一标准产品外壳、仅依赖 Hugo 的消费端构建、本地优先浏览器依赖、通用多语言框架，以及一组从 PGSTY 文档站提炼出的可复用内容组件。 这是实现与文档里程碑，不是已经公开的版本化发行。最终公开品牌、模块与软件包身份、首个版本，以及生产 Cloudflare Pages 部署，仍是必须显式关闭的发布关卡。 为什么需要 OINK？ 多个成熟文档站分别复制了相同的 Docsy 布局、导航、搜索代码 …
OINK 实施日记：从复制外壳到统一主题
2026年8月8日 在 博客
OINK 始于一个令人不安的事实：多个生产文档站之所以看起来相互关联，是因为它们确实源于同一套实现；但公共实现却以复制文件的形式散落在各处。呈现效果足够一致，维护模型却并非如此。 这篇日记记录项目如何从重复站点覆盖项走向一款直接演化的统一主题。它关注决策与证据，而不是逐条复述提交历史。 锁定产品契约 第一项真正有价值的工作是做减法。选择实现方式之前，我们先写清产品必须是什么： 从 Docsy 直接演化而来的独立主题； 唯一标准外壳，而不是可切换皮肤； Hugo Extended 是消费端唯一构建 …
0.16.0 发布报告与升级指南
2026年7月29日 在 博客
亮点 一等 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 变动； 模板与 …
0.15.0 发布报告与升级指南
2026年5月1日 在 博客
亮点 智能体支持：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+ 的破坏性与重要变化 发布摘要 样式与定制： 导航栏改进，包括可配置浅色/深色主题 …
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 选项已弃用 …
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.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 说明 本文覆盖最常见的升级步骤。项目定制项可能还需要额外调整。建议在 独立分支 中完成这些变更，并在部署到 …
Docsy 2024 年回顾：采用与增强
2024年12月12日 在 博客
回顾 2024 年，我们很高兴看到项目稳步实现 2024 年工作重点中提出的目标。今年，我们专注于增强稳定性、改进国际化，并交付深色模式和持续集成（CI）测试等期待已久的功能。 2024 年，Docsy 的使用量从 1,400 个项目增长到 2,200 个，增幅达到 57%！1 下面一起回顾 2024 年的开发亮点，也展望一下后续计划。 版本亮点 今年我们发布了三个版本。每个版本都以稳定性为核心，同时至少引入一项重要功能增强： 0.9.0 增加了几项 期待已久 的能力： 通过 GitHub …