Hugo
在 Hugo 中使用 Shiki
·1050 字·3 分钟
代码
Hugo-Syntax-Highlight-Shiki
Hugo
Highlight
Shiki
高亮
Shiki 是一款基于 VS Code 语法高亮引擎的代码高亮工具,支持多种编程语言和主题,无需维护自定义正则表达式或 CSS。在 Hugo 中配置 Shiki 只需几分钟,通过 @shikijs/rehype 插件实现纯静态高亮,适合本地或 GitHub Actions 部署。安装需 Node.js 和 Yarn,配置时关闭 Hugo 的 codeFences 并创建 .rehyperc 文件定义主题。
Hugo 外部链接跳转提示页面
·1522 字·4 分钟
代码
Hugo-Redirect-Landing-Page
Hugo
博客
跳转
折腾
为规避外链风险,博客采用 Hugo 的 render-link.html 模板实现外链跳转,通过 base64 编码目标链接并添加白名单机制。核心步骤包括修改渲染模板、创建跳转页面布局及背景图适配,最终通过 /go/ 路径实现安全跳转。此方案仅适用于 Markdown 内容,需手动处理 Shortcodes 和自定义 HTML 链接!
自部署 GitHub 风格的 Reactions 点赞功能
·864 字·2 分钟
代码
Self-Hosted-Github-Flavored-Reactions
Hugo
Blog
Reactions
通过 Cloudflare Workers 和 D1 数据库部署 GitHub 风格的点赞功能,前端使用 emaction.frontend 模块实现交互,无需复杂配置即可快速集成到网站中。
图床 CDN CNAME 接入 Cloudflare SaaS 实现分流
·3521 字·8 分钟
代码
Cdn-Cname-Cloudflare
Hugo
Blog
Cname
Cloudflare
通过 Cloudflare for SaaS 实现国内外流量分流,国内使用阿里云或腾讯云 CDN 及对象存储,境外则利用 Cloudflare CDN 和 R2 或 Backblaze B2 存储桶。无需将域名 NS 接入 Cloudflare,通过 CNAME 解析和 Worker 代理实现分区解析和资源访问,优化性能并降低成本。
博客 AI 摘要及优化
·1763 字·4 分钟
代码
Ai-Summary
Hugo
Blog
AI
Summary
AI 摘要功能能有效过滤低价值信息,但依赖第三方服务成本过高。通过本地化存储摘要数据并集成到静态博客中,既能保留功能又避免持续开销。具体方案包括将摘要存入 JSON 文件、修改 Hugo 模板实现动态渲染,并添加打字机动画提升体验。最终实现静态化部署,兼顾效率与可控性!
豆瓣同步到 Notion 和 Neodb
·781 字·2 分钟
代码
Douban-Sync
Hugo
豆瓣
NeoDB
Notion
豆瓣图片防盗链升级导致依赖其图片的服务失效,促使将观影记录迁移至开源平台 NeoDB。怡红公子的 drone-doumark 项目已支持同步到 NeoDB,同时发现现有教程可将豆瓣标记通过 RSS 同步至 Notion 和 NeoDB。过程中需注意豆瓣 RSS 仅显示最新 10 条活动记录,且需调整标记可见度参数为公开。Notion 集成功能位置已变更至 Connections 选项。
NeoDB API 创建观影页面
·2857 字·6 分钟
代码
Neodb
Hugo
Blog
NeoDB
Movie
将豆瓣观影数据迁移至 NeoDB 并静态化部署,通过 API 获取数据后本地存储为 JSON 文件,利用 Hugo 生成静态页面,结合自定义 CSS 和 JS 实现排序功能,并通过 GitHub Actions 自动化更新数据。SaaS 服务不可靠,自建方案更可控!
NeoDB 获取 Access Token
·719 字·2 分钟
代码
Neodb_token
Hugo
Blog
NeoDB
Token
注册 NeoDB 需先拥有 Mastodon 账号,现已支持邮箱登录。生成 Access Token 需在开发者中心创建应用并记录 Client ID,通过授权链接获取 AUTH_CODE,最后用 curl 请求换取有效期为 1 年的 Access Token。
Artalk 无评论随机显示诗词
·595 字·2 分钟
代码
Artalk-No-Comment-Text
Hugo
Blog
Artalk
评论
Artalk 评论系统可通过管理后台的前端配置直接嵌入 HTML 代码实现无评论时随机显示诗词效果。使用今日诗词 API 的图片形式调用,并选择 LightSlateGray 颜色以适配明暗主题背景。该方法无需侵入性代码即可优雅实现功能,兼顾实用性与美观性。
Hugo .GitInfo 的替代方案
·569 字·2 分钟
代码
Githash
Hugo
GitInfo
Git
Hugo 的 .GitInfo 变量因设计限制无法正确显示 content 目录的 Commit hash,尤其在浅克隆时更易失效。通过自定义脚本动态替换模板中的占位字符串,可绕过该限制实时显示最新 Git hash。该方法需在构建前执行脚本更新模板,虽非官方方案但能有效解决问题。
启用 Waline
·972 字·2 分钟
日志
Waline
Hugo
Blog
Waline
Comment
评论
博客评论系统历经多次迁移,最终选择 Waline 作为解决方案。Waline 是一款安全、快速且支持多种部署方式的评论系统,提供丰富的数据迁移选项。其设计理念避免了 LeanCloud 流控问题,免费额度足以满足正常博客需求。选择评论系统应基于个人偏好和实用性,无需过度纠结技术细节。没有完美的方案,只有最适合自己的工具!
静态博客评论系统的选择
·1799 字·4 分钟
代码
Comments
Hugo
Blog
博客
评论
静态博客需依赖第三方评论系统,主要分为 SaaS 类(如 Disqus)、GitHub Issues 类(如 Utterances)和 PaaS 类(如 Valine)。Disqus 虽稳定但国内访问受限,GitHub 类存在网络波动问题,Valine 因安全性和闭源引发争议。衍生品 Twikoo 和 Waline 成为新选择,前者基于腾讯云开发,后者专注安全性。
爱丽丝梦游仙境症 偶发
·553 字·2 分钟
日志
Aiws-Again
Hugo
Blog
今天回乡下过月半,晚上开车回家时因精神集中但身心疲劳,时隔三年再次出现爱丽丝梦游仙境症。症状表现为视野中物体比例异常缩小或遥远,虽符合透视原理却与生活经验严重冲突,最折磨人的是这种视觉与意识的矛盾。不同于梦境或醉酒,它更像元神出壳般的清醒体验,能依靠经验控制动作但驾驶仍危险,最终停车调整至完全恢复才继续上路。
月半
·347 字·1 分钟
日志
Yueban2020
Hugo
Blog
月半
中元节
鬼节
今天是土家族传统节日月半节,即中元节或鬼节,农历七月十二祭祀祖先。从小在外公外婆家度过,今年带妻儿回乡祭拜,感受节日氛围。随着生活水平提高,人们越来越重视传统节日的人文气息,年味也逐渐回归。恰逢月半归来,重温旧日志《年小月半大》,记录这一特殊时刻!
Typecho 迁移到 Hugo
·832 字·2 分钟
代码
Typecho-to-Hugo
Hugo
Blog
Typecho
博客
记录从 Typecho 迁移到 Hugo 的关键步骤,重点是保留原文章 URL 和导入评论到 Disqus。使用修改后的 PHP 脚本导出文章并添加 slug 字段,调整 Hugo 的 permalinks 配置确保链接一致。通过 WordPress 中转将 Typecho 评论导入 Disqus,需安装 Disqus 插件并同步数据,最后处理域名映射问题。
博客迁移到 Hugo
·595 字·2 分钟
代码
Hugo
Hugo
Blog
经过一年拖延,终于将博客从 Typecho 迁移到 Hugo 静态系统,彻底告别繁琐的 LNMP 维护。放弃 Hexo 因其构建速度过慢,4000 篇文章需 2 小时生成,最终选用性能更强的 Hugo 并部署在阿里云 OSS 实现无服务器架构。灵感来自林木木的现成主题模板,大幅节省开发时间!