有把握地交付
用一套可重复的发布清单,依次检查本地预览、生产构建、主题升级与线上部署。
6 有把握地交付
用一套可重复的发布清单,依次检查本地预览、生产构建、主题升级与线上部署。
文档站点的交付通常包含四个阶段:本地预览、锁定或升级主题模块、执行干净的生产构建,以及推送到托管平台上线。 按顺序检查每个阶段,能在构建或部署出错时快速定位原因。
按阶段检查发布流程
| 阶段 | 已验证的内容 | 仍需继续确认的事项 |
|---|---|---|
| 本地预览 | 页面、导航与内容修改可在 hugo server 中正常渲染 |
生产环境 baseURL、草稿过滤与干净的模块状态 |
| 主题模块版本 | hugo mod graph 在 go.mod 与 go.sum 中解析到目标公开标签 |
站点内容与覆盖项能否在该版本下通过生产构建 |
| 生产构建 | 内容、配置与 go.mod 在 --environment production 下构建通过 |
托管平台工作流、CDN 缓存与线上公开路由 |
| 线上部署 | CI 工作流成功完成,主要公开路由均可正常访问 | 代表性页面在桌面端与窄屏下的实际排版表现 |
验证最小且有效的范围
在自己的 Starter 仓库中,先执行一次干净的生产构建,再触发部署工作流:
确认 hugo mod graph 解析到 go.mod 中预期的公开版本,再按Starter 部署步骤操作。
普通 Starter 站点不需要 npm 构建脚本或同级主题目录。如果同时在修改 OINK 主题本身,
可按主题开发流程进行联调。
审阅真正渲染出的结果
自动检查能发现坏链接、重复 ID、无效短代码与无障碍回归,而版面与可读性仍需肉眼审阅。 请在桌面与窄屏宽度下抽查具有代表性的中英文页面,涵盖 Hero 裁切、宽表格、导航、主题切换控件、 代码块以及整书打印视图。
整理发布记录
发起 Pull Request 或升级主题版本时,对照 表 6-1
记录当前使用的 Hugo 版本、go.mod 中的主题版本、构建输出以及抽查过的页面路由。
在变更说明中附上这份简短清单,方便团队审阅与回滚排查。