博客搭建

本文介绍了作者在使用 Waline 评论系统时遭遇的后台空白故障及其解决过程。某天作者发现管理后台页面完全空白，反复刷新并更换浏览器均无效，随后重新部署时遇到 Vercel 502 错误，经排查得知是 @waline/vercel 新版本存在兼容问题。在 DeepSeek 指导下手动回退版本号后编译通过，但后台仍为空白。作者向 Waline 提交了 Issue，详细描述了现象、步骤和日志。项目负责人认为与另一 Issue 相似，但作者对比后发现本质不同，并补充了截图和日志。当日下午，维护者 lizheming 确认问题源于新版 Waline 核心模块改动引发的连锁反应，导致所有基于新版的后台均失效。当晚，外国用户和作者朋友峰哥也反馈了同样问题。作者通过修改 Neon 数据库中评论的 user_id 字段使评论正确显示博主标签。深夜，维护者发布了修复版本，去除了有问题的功能模块，虽然界面简陋但核心功能恢复。全文展示了开源社区快速响应（一天内修复）的优势，也指出了活跃项目频繁重构（如 Rust 重写）给用户带来的升级困扰。

本文介绍了独立博客圈中的一起抄袭事件及其引发的思考。作者的朋友姓王者被抄袭，发现抄袭者并非为了名利，而是为了满足某些平台对“原创文章不少于20篇”的硬性门槛而机械式搬运。作者通过与 AI 讨论，厘清了抄袭的法律边界：若未接触原文且子句表达不同，即使主题相似仍属原创；反之，若接触过原文且未标注来源则构成抄袭。AI 还建议创意枯竭时去真实世界中体验生活，而非抄袭他人。此外，文章强调了知识共享协议（CC 协议）的重要性，指出多数独立博客通过标注协议明确转载需署名并附原文链接，违反者即使不违法也违背了作者授权。作者计划后续普及 CC 协议知识，帮助读者正确引用。文章呼吁独立博主保护原创，同时尊重他人创作成果。

本文介绍了作者在管理个人网站和 B 站信箱过程中经历的反思与回归。作者首先描述了 B 站信箱因评论被顶到热门而充斥陌生人的无效留言，使其难以分辨真实交流，转而通过回看视频评论区逐条回复来寻求真实感。接着，作者回顾了个人网站建设中因添加过多定制功能如毛玻璃卡片、深色模式等导致界面臃肿混乱，最终意识到最初的主题简洁完整，决定换回旧主题以回归初心。由于缺乏 Git 记录，作者借助 Matugen 生成配色方案，并利用 GLM 将配色写入主题，预期呈现更明亮清新的效果。同时，作者保留了部分实用功能如 CSS 覆写规则、404 页面自动修复、友链模块和评论区头像解析，实现删繁就简的融合升级。最后，作者反思过度美化的教训，强调简洁是需学习的克制，并建议访客在重新访问前清空浏览器缓存以避免样式冲突。

本文描述了 2026 年除夕夜在茂南区家中度过的情景，作者因父母不愿折腾而未回金塘乡下，内心感慨对老家的记忆逐渐模糊。文章回顾了创建 EMLOG 博客网站的过程，短短几天内写了十几篇日常琐事，尽管无人访问，但这是首个成功部署在树莓派上的站点，比之前的 Hexo 更简单。通过“十年之约”友链认识了 ACEVS 和暖心向阳两位博主，但自己因未仔细阅读规则而误以为能立即加入，闹了笑话。除夕夜家庭氛围冷清，家人各自刷手机，电视播放的粤语春晚无人真正观看。年夜饭是广东传统的白切鸡和肥猪肉，饭后逛了博客和主题商城，并参与十年之约的弹幕祝福。作者对比去年除夕折腾 Linux 系统的充实，感到今年索然无味。最后提及一件无关的事：路边看到一只南方家鼠睡在店门口，联想到童年时老鼠爬上床的阴影，至今心有余悸。

本文介绍了网站重构或迁移后路径变化导致搜索引擎索引失效的问题，并给出了一种基于前端脚本的路径纠错解决方案。文章描述了当用户访问错误路径时，浏览器会展示预设的 404 页面，然后通过脚本获取当前路径，并与从 sitemap.txt 中提取的合法路径列表进行语义匹配，利用 Levenshtein 距离和路径层级评分找到最可能的正确路径，并在 5 秒后自动跳转。还提供了调试函数 error_location 用于本地测试。文章详细说明了编写脚本过程中遇到的坑，例如 Butterfly 主题的 404 容器类名、Hexo 生成的 sitemap 包含 index.html 后缀问题，以及如何通过另一个脚本去除 index.html 实现干净跳转。最后给出了在 _config.butterfly.yml 的 inject 中引入脚本的配置示例。该方案有效保留了 SEO 索引，提升了用户体验。

本文介绍了 Butterfly 主题中首页文章列表高度不统一的问题及其解决方案。由于博客每页显示固定篇数（如 10 篇），末页文章数量不足时，列表容器高度会大幅缩减，导致底部大量空白，影响视觉一致性。为解决该问题，文章提供了一种基于 JavaScript 的动态补齐方法：通过 fillRecentPostItems 函数检测 .recent-post-items 容器内实际文章条目数，若少于目标值（如 10），则自动追加对应数量的隐藏 div 元素（visibility: hidden），使容器高度始终与满篇数保持一致。该逻辑还通过监听 pjax:complete 事件兼容 PJAX 无刷新加载，确保页面切换后自动执行补齐。同时指出，在 index_layout 参数为 4 或 6 的特殊布局下，由于文章条目高度依赖封面图片，纯隐藏标签会导致高度不一致，因此需要额外添加空封面占位元素。最后说明如何通过主题的 inject 配置将脚本注入页面底部，无需修改核心文件，便于维护升级。该方案有效解决了分页高度不一致的布局问题。

本文介绍了作者针对静态博客实现邮箱订阅推送的解决方案。文章首先指出现有方案（如基于 GitHub Issues 的推送）存在重复推送、依赖读者 GitHub 账号等问题，随后提出利用 GitHub Actions 的 Cache 系统记录已推送文章链接，从而避免重复。作者详细说明了整体流程：通过定时触发 Actions，运行 Python 脚本抓取博客 RSS 地址中的最新文章，解析标题、摘要和链接，并与缓存文件比对，若为新文章则生成 HTML 邮件，并通过 SMTP 协议密送订阅者。所有敏感配置（如 SMTP 凭据、邮箱列表）均存入 GitHub Secrets 以保护隐私。文章还给出了完整的 YAML 工作流配置和 Python 脚本示例，支持自定义邮件模板标签。最后，作者推荐使用 Resend 等免费 SMTP 服务，并列出需要创建的 Secrets 参数，方便读者 Fork 仓库后直接使用。该方案实现了真正的不重复邮箱推送，适用于任何拥有 RSS 输出的静态博客。

本文介绍了作者从 2024 年 5 月开始拥有第一个博客网站至今的建站历程与内心反思。作者回顾了反复建站、更换域名和主题的过程，从最初使用 MkDocs 搭建简陋站点，到尝试 Jekyll、Hexo、WordPress 等多种引擎，以及 Butterfly、Chirpy 等主题，经历了从只写技术教程到逐渐记录生活的转变。文中描述了作者因初中休学、技校退学、开店经历、长期感冒等事件产生的后悔情绪，但也认识到这些经历塑造了现在的自己。作者反思了早期缺乏关注、频繁更换站点导致友链失效等问题，最终领悟到网站可以同时写技术与生活，并决定向前看，努力做好下一件事。摘要涵盖了作者对博客活动的参与、与博友的互动、以及从 CSDN 到独立博客的转变，强调了成长过程中的自我意识与学习能力的重要性。

本文介绍了作者在网站优化过程中，重新关注友链功能并为其创造更大价值的思考与实践。作者在投入大量精力调整网站加载速度、排版布局和交互逻辑后，偶然通过社交媒体结识了一批新人博主并主动交换友链。然而，作者意识到传统友链页面容易被访客忽视，无法有效为小博主引流，因此设想在页脚以随机形式展示友链，使其更自然地触达访客。作者参考了安知鱼博客主题的类似实现，并基于此前编写的用于抓取友链数据的 JavaScript 脚本进行改造。脚本逻辑包括：在配置文件中添加空容器标签，页面加载后异步请求 /friends 页面 HTML，解析 DOM 提取第一个 flink-list 中的友链信息，过滤无效数据，再根据屏幕宽度（大于 768 像素显示 6 个，否则显示 3 个）随机抽取不重复的友链接，动态生成链接元素插入页脚。这一响应式设计避免了手机端布局错乱，同时充分利用电脑端空间，使友链从静态列表变为动态信息流，真正释放其引流价值。

本文介绍了作者在维护个人博客网站时发现字体拥挤、段落缺乏缩进导致可读性差的问题，并借助 DeepSeek 寻求解决方案的过程。通过分析，作者确定需要针对文章正文容器（article p 和 div#article-container p）添加 text-indent: 2rem 实现首行缩进，同时为全站 body 设置 letter-spacing: 0.1rem 以增加字符间距。随后，作者在 _config.butterfly.yml 主题配置文件中正确引用了自定义的 paragraph.css 文件，并利用 GitHub Actions 自动部署更新。文章还强调了在开发者工具中验证样式是否生效、以及清除浏览器缓存或强制刷新页面等常见排查步骤，帮助读者避免因配置遗漏或缓存导致修改无效的陷阱。最终，通过精准的 CSS 选择器和统一的间距设置，网站排版获得了“书卷气”般的舒适阅读体验。