竹山一叶

装了统计代码却不知道该看什么? 本文讲清百度统计与 GA4 各自能回答什么问题、Hexo + Butterfly 下的具体配置与验证方法, 以及拿到数据后如何判断下一篇该写什么。

个人博客接广告前必须过的一关: ICP备案与公安备案怎么展示、隐私政策页面为什么要建、Cookie 与第三方服务怎么披露。本文给出 Hexo + Butterfly 下的完整落地步骤和可直接改用的模板。

个人博客怎么开始赚钱? 本文记录 Hexo + Butterfly 博客接入 Google AdSense 和百度联盟的完整流程: 申请账号、Butterfly 广告位配置代码、广告展示位置选择, 以及收益现实预期与被封号的雷区。

结构化数据是把文章元信息用 JSON-LD 告诉搜索引擎的方法, 影响搜索结果的富媒体展示。本文记录 Hexo 博客接入 BlogPosting 结构化数据的完整做法: inject 注入代码、动态取值、验证与常见陷阱。

静态博客没有 RSS, 读者就没法订阅更新。本文记录 Hexo 博客接入 RSS 的完整流程: 安装 hexo-generator-feed 插件、配置输出格式、在 Butterfly 主题中添加订阅按钮, 以及把订阅源提交到常用平台的注意事项。

Hexo 报 ERR_REQUIRE_ESM、找不到标签、构建结果和预期不一致时, 大概率不是代码问题。本文整理一套固定的排查顺序: 先清缓存, 再查依赖树, 最后才改配置, 附上具体命令和判断依据。

Butterfly 5.x 把 getScript 等全局函数收进了 window.btf 命名空间, 3.x 时代的老插件因此报 ReferenceError。本文记录 5.2 升级到 5.7 过程中遇到的真实障碍: 命名空间迁移、插件配置节点缺失、同名标签冲突, 以及对应的解决办法。

Hexo 8.0.0 正式移除了对 Node.js 16 和 18 的支持, 要求 Node 20.19.0 以上。本文记录从 Hexo 7.3.0 升级到 8.x 过程中遇到的真实问题: Node 版本不达标、ERR_REQUIRE_ESM 报错、strip-ansi 冲突的排查与解决思路。

为了适应当下的协作开发的节奏, svn的时代渐行渐远, git的操作无疑让开发进度更加快速。 于是乎 svn->git是必然的的, 而且还要带上提交记录，进行无缝切换。

代码从SVN迁移到Git代码库并保留提交记录