晴纸 —— 我的博客主题开源了

拖了很久，终于把这个博客的主题整理成独立仓库发出来了。

为什么要做这件事

最初用的是 hexo-theme-A4，喜欢它的纸张风格，用着用着就开始折腾。先替换掉 jQuery，后来改了配色，又移植了 Typora 主题 Phycat 的排版层级……改到跟 A4 差得有点远了，就干脆起了个名字：晴纸（qingzhi）。

后来又改了什么

这篇是 2 月的发布记录，下面按 2026 年 10 月的站点补了一遍，免得照着旧说明安装踩坑。

现在用的是 MIUIX 风格，主色改为 #3482FF，字体是 MiSans。标题也收敛了，H2 用小圆点标记，去掉了原来的渐变胶囊。早期基于 A4 改写的脚本已经移除了 jQuery。

平时写笔记用得上的功能留着：专栏前后篇导航、Fragment 提示块、图片灯箱、全站搜索，以及点开才加载的 PDF 预览。专栏文章写 series 和 series_index，按 / 可以打开搜索。

以前塞进去的 42 个小工具已经全部移除。独立的最近更新页也取消了，文章更新时间按 Git 中的正文修改记录计算，具体改动放在更新日志。

安装

1
2
3

cd your-hexo-site
git clone https://github.com/yeliqin666/hexo-theme-qingzhi themes/qingzhi
npm install --save hexo-renderer-pandoc hexo-filter-mathjax

站点 _config.yml 里设置 theme: qingzhi，本地还要安装 Pandoc。主题配置在 themes/qingzhi/_config.yml，导航、主色、评论和播放器都在这里改。

当前站点用 Pandoc 处理 Markdown，公式交给 hexo-filter-mathjax 渲染。搜索和字数统计已有主题实现，不需要再安装 hexo-generator-search 或 hexo-wordcount。

仓库地址：yeliqin666/hexo-theme-qingzhi

提了官方 PR

发布时也向 hexojs/site 提了收录 PR，交了主题信息和截图。当时还在等审核。

感谢 AI 们

主题的 JS 模块重写、CSS 和早期工具箱，基本都是 Vibe Coding 全程。ChatGPT、Gemini、Claude、豆包轮番上阵，每次以为搞定了，下一个 bug 又冒出来。调试一个动画的 timing 可以在四个 AI 之间绕两个小时。差点被主页 APlayer 气晕。