维护管理
站点从本机到线上的运维事项：本地预览、发布上线、评论、分析与 SEO、版本升级与排错。
本栏目覆盖内容写完之后的运维事项：在本机预览、构建并部署产物、接入评论与分析、跟随主题版本升级、故障定位。前面五个栏目决定站点的外观与内容，这一栏决定站点能否构建、部署在哪、出问题如何排查。
按任务导航
| 你要做的事 | 去哪 |
|---|---|
| 在本机看到改动 | 本地预览 |
构建出能部署的 public/ |
本地预览 |
| 部署到 GitHub Pages / Cloudflare / Netlify | 发布上线 |
部署到 example.com/docs/ 这样的子路径 |
发布上线 |
| 让读者在页面底部留言 | 启用评论 |
| 接 Google Analytics 或自建统计 | 分析与 SEO |
| 让搜索引擎正确收录 | 分析与 SEO |
| 升到新版主题 / 从 Docsy 或 0.4 迁移 | 版本升级 |
| 构建报错、搜不到、页面 404 | 排错与检查 |
用 hugo server 在本机预览改动，用 hugo –panicOnWarning 构建可部署的 public/，不需要 Node 与 CDN。
把 public/ 部署到 GitHub Pages、Cloudflare Pages 或任何静态托管：baseURL 配对、内容安全策略、验收清单与回滚。
用 giscus 把 GitHub Discussions 接成页面底部的评论区，全站开、按页关、跟随深浅色。
接入一个分析服务（或者不接），并把主题已经生成的 canonical、hreflang、社交卡片、站点地图与 robots 配对。
升到新版主题、用迁移工具把 0.4 的 shortcode 改成 v5 语法、从 Docsy 迁过来，以及出问题怎么退回去。
构建、语言、搜索、平台四类故障的症状 → 原因 → 修法，以及站点可以自己跑的那几项检查。