维护记录

完成的工作

  • 删除 layouts/partials/footer.html(1 行 wrapper)
  • 删除 layouts/partials/custom_footer.html(156 行,PaperMod footer 的本地 fork)
  • 删除 hugo.toml 中 [params.cloudflareAnalytics] 配置块
  • Hugo --minify 构建通过,确认 Cloudflare Web Analytics 注入消失(cf-beacon 匹配 0 次),PaperMod 自带 footer 功能保留(top-link / scroll-to-top JS / 版权 / Powered by)

决策

  • 移除 Cloudflare 站点统计:custom_footer.html 相对于 PaperMod 原版 footer 唯一真正的差异就是 Cloudflare beacon 注入;既然没用价值,把 footer 部分整体还原回 PaperMod 默认,避免 PaperMod 升级 footer 时本地 fork 不同步的问题(2026-08-01 已记录此风险)
  • 保留 layouts/_partials/cover.html:该 override 解决了 PaperMod resources.ByType "image" 不识别 SVG 封面导致 404 的问题,不能删

下次建议

  • 如果以后又想加自定义站点统计,可以直接在 Hugo 配置启用内置埋点,或 inline 在 layouts/partials/extend_footer.html(PaperMod 已留 hook),不需要再 fork 整个 footer