重构实录:Hugo+PaperMod 的终极现代化改造

摘要:记录了一个 17 年老博客从 Netlify 迁移至 Cloudflare Pages 的全过程。涵盖了构建环境配置、Profile Mode 深度定制、以及基于 Python 脚本的 URL 架构重构 ( 中文转 Slug + 301 重定向闭环 ) 。 1. 基础设施:Cloudflare Pages 构建环境 为了解决 Hugo PaperMod 主题 CSS 不生效的问题,必须锁定 Hugo 的 Extended 版本。 Cloudflare 后台设置: 位置:Settings -> Environment variables ...

2025年12月17日 · 4 分钟 · 1938 字 · Chow Ray · PGP SIGNED

上帝视角:为 PaperMod 接入 Microsoft Clarity 用户行为分析

在折腾完博客的 UI 和排版后,是时候关注一下「里子」了。 对于个人博客来说,Google Analytics ( GA4 ) 显得过于庞大且复杂。我们更关心的是:用户到底看了什么?他们在哪里停留?为什么他们离开了? 这时,Microsoft Clarity 是一个绝佳的选择。它完全免费、不限流量,且提供两个杀手级功能:热力图 ( Heatmaps ) 和 会话录屏 ( Session Recordings )。 本文记录了如何在 Hugo PaperMod 主题中,以最符合工程规范的方式接入 Clarity。 ...

2025年12月16日 · 3 分钟 · 1105 字 · Chow Ray · PGP SIGNED

PaperMod 主题微调:Profile Mode 下的中文排版精修

当年在启用 Hugo PaperMod 主题的过程非常顺利。在首页布局上,我选择了更符合个人品牌调性的 Profile Mode:全屏居中,只展示头像、简介和社交链接,像一张极简的数字名片。 但在“装修”的细节上,我发现了一个体验割裂的问题: 首页虽然极简了,但当我点击进入某一篇具体的文章(Post Detail)时,PaperMod 默认的英文排版字体(40px+)对于中文标题来说实在太大了,充满了压迫感。 本文记录了如何通过 custom.css 解决这个问题,以及中间的一个小插曲。 ...

2025年12月14日 · 2 分钟 · 777 字 · Chow Ray · PGP SIGNED