Hugo

“Shiki 是一款基于 VS Code 语法高亮引擎的代码高亮工具，支持多种编程语言和主题，无需维护自定义正则表达式或 CSS。在 Hugo 中配置 Shiki 只需几分钟，通过 @shikijs/rehype 插件实现纯静态高亮，适合本地或 GitHub Actions 部署。安装需 Node.js 和 Yarn，配置时关闭 Hugo 的 codeFences 并创建 .rehyperc 文件定义主题。”

“为规避外链风险，博客采用 Hugo 的 render-link.html 模板实现外链跳转，通过 base64 编码目标链接并添加白名单机制。核心步骤包括修改渲染模板、创建跳转页面布局及背景图适配，最终通过 /go/ 路径实现安全跳转。此方案仅适用于 Markdown 内容，需手动处理 Shortcodes 和自定义 HTML 链接！”

“通过 Cloudflare Workers 和 D1 数据库部署 GitHub 风格的点赞功能，前端使用 emaction.frontend 模块实现交互，无需复杂配置即可快速集成到网站中。”

“通过 Cloudflare for SaaS 实现国内外流量分流，国内使用阿里云或腾讯云 CDN 及对象存储，境外则利用 Cloudflare CDN 和 R2 或 Backblaze B2 存储桶。无需将域名 NS 接入 Cloudflare，通过 CNAME 解析和 Worker 代理实现分区解析和资源访问，优化性能并降低成本。”

“AI 摘要功能能有效过滤低价值信息，但依赖第三方服务成本过高。通过本地化存储摘要数据并集成到静态博客中，既能保留功能又避免持续开销。具体方案包括将摘要存入 JSON 文件、修改 Hugo 模板实现动态渲染，并添加打字机动画提升体验。最终实现静态化部署，兼顾效率与可控性！”

“豆瓣图片防盗链升级导致依赖其图片的服务失效，促使将观影记录迁移至开源平台 NeoDB。怡红公子的 drone-doumark 项目已支持同步到 NeoDB，同时发现现有教程可将豆瓣标记通过 RSS 同步至 Notion 和 NeoDB。过程中需注意豆瓣 RSS 仅显示最新 10 条活动记录，且需调整标记可见度参数为公开。Notion 集成功能位置已变更至 Connections 选项。”

“将豆瓣观影数据迁移至 NeoDB 并静态化部署，通过 API 获取数据后本地存储为 JSON 文件，利用 Hugo 生成静态页面，结合自定义 CSS 和 JS 实现排序功能，并通过 GitHub Actions 自动化更新数据。SaaS 服务不可靠，自建方案更可控！”

“注册 NeoDB 需先拥有 Mastodon 账号，现已支持邮箱登录。生成 Access Token 需在开发者中心创建应用并记录 Client ID，通过授权链接获取 AUTH_CODE，最后用 curl 请求换取有效期为 1 年的 Access Token。”

“Artalk 评论系统可通过管理后台的前端配置直接嵌入 HTML 代码实现无评论时随机显示诗词效果。使用今日诗词 API 的图片形式调用，并选择 LightSlateGray 颜色以适配明暗主题背景。该方法无需侵入性代码即可优雅实现功能，兼顾实用性与美观性。”

“Hugo 的 .GitInfo 变量因设计限制无法正确显示 content 目录的 Commit hash，尤其在浅克隆时更易失效。通过自定义脚本动态替换模板中的占位字符串，可绕过该限制实时显示最新 Git hash。该方法需在构建前执行脚本更新模板，虽非官方方案但能有效解决问题。”

“博客评论系统历经多次迁移，最终选择 Waline 作为解决方案。Waline 是一款安全、快速且支持多种部署方式的评论系统，提供丰富的数据迁移选项。其设计理念避免了 LeanCloud 流控问题，免费额度足以满足正常博客需求。选择评论系统应基于个人偏好和实用性，无需过度纠结技术细节。没有完美的方案，只有最适合自己的工具！”

“静态博客需依赖第三方评论系统，主要分为 SaaS 类（如 Disqus）、GitHub Issues 类（如 Utterances）和 PaaS 类（如 Valine）。Disqus 虽稳定但国内访问受限，GitHub 类存在网络波动问题，Valine 因安全性和闭源引发争议。衍生品 Twikoo 和 Waline 成为新选择，前者基于腾讯云开发，后者专注安全性。”

“今天回乡下过月半，晚上开车回家时因精神集中但身心疲劳，时隔三年再次出现爱丽丝梦游仙境症。症状表现为视野中物体比例异常缩小或遥远，虽符合透视原理却与生活经验严重冲突，最折磨人的是这种视觉与意识的矛盾。不同于梦境或醉酒，它更像元神出壳般的清醒体验，能依靠经验控制动作但驾驶仍危险，最终停车调整至完全恢复才继续上路。”

“今天是土家族传统节日月半节，即中元节或鬼节，农历七月十二祭祀祖先。从小在外公外婆家度过，今年带妻儿回乡祭拜，感受节日氛围。随着生活水平提高，人们越来越重视传统节日的人文气息，年味也逐渐回归。恰逢月半归来，重温旧日志《年小月半大》，记录这一特殊时刻！”

“记录从 Typecho 迁移到 Hugo 的关键步骤，重点是保留原文章 URL 和导入评论到 Disqus。使用修改后的 PHP 脚本导出文章并添加 slug 字段，调整 Hugo 的 permalinks 配置确保链接一致。通过 WordPress 中转将 Typecho 评论导入 Disqus，需安装 Disqus 插件并同步数据，最后处理域名映射问题。”

“经过一年拖延，终于将博客从 Typecho 迁移到 Hugo 静态系统，彻底告别繁琐的 LNMP 维护。放弃 Hexo 因其构建速度过慢，4000 篇文章需 2 小时生成，最终选用性能更强的 Hugo 并部署在阿里云 OSS 实现无服务器架构。灵感来自林木木的现成主题模板，大幅节省开发时间！”