重构实录: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

Markdown 写作指南:像写代码一样写文章

在完成了 chowray.org 从 Netlify 到 Cloudflare Pages 的迁移,并对 PaperMod 主题进行了深度的 CSS 定制(宋体标题 + 极客蓝交互)之后,我意识到一个问题: 如果没有高质量的排版,再漂亮的 CSS 也是花瓶。 作为一个工科男和项目经理,我认为写作应该像写代码一样,遵循严格的 Style Guide。这不仅是为了视觉上的“呼吸感”,更是为了语义的正确性和未来的可维护性。 以下是我为本站制定的 Markdown 写作规范。 ...

2025年12月16日 · 4 分钟 · 1588 字 · 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

告别腾讯 404,重构幽灵页面

在这次将博客迁移到 chowray.org 的过程中,我做了一个稍显艰难的决定:下线使用了多年的“腾讯公益 404”代码。 对于老站长来说,这段代码是 Web 2.0 时代的一种技术温情。但作为一名工科男,当我不带滤镜地审视它时,看到的却是必须要解决的 “技术债务”。 ...

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