缘起

一直想有一个属于自己的网站。不是那种注册即用、模板千篇一律的,而是完全自己掌控、按自己想法长的。

之前试过 WordPress,太重了。试过 Notion 公开页,不够灵活。直到遇见了 Hugo。

为什么是 Hugo

  • 快 — 毫秒级构建,秒杀 Jekyll 和 Hexo
  • 纯静态 — 生成 HTML,随便找个虚拟主机就能跑
  • Markdown — 和 Obsidian 天然配合,在 Obsidian 里写完后直接 publish
  • 主题丰富 — PaperMod 简约大方,该有的都有

工作流设计

我的需求很明确:

  1. 在 Obsidian 里写内容(这是我每天都在用的笔记软件)
  2. 保存后自动触发构建
  3. 构建结果自动上传到虚拟主机
  4. 刷新浏览器就能看到更新

技术选型

环节工具
写作Obsidian
静态站点Hugo + PaperMod
文件监听inotifywait
FTP 同步lftp
开机自启systemd –user

实现效果

现在我在 Obsidian 的 website/content/posts/ 目录下写完文章,保存的那一刻:

Obsidian 保存 → inotifywait 触发
    → hugo --minify 构建
    → lftp mirror --reverse 上传
    → 浏览器刷新即可看到

全程不到 3 秒。

踩坑记录

FTP chmod 报错

虚拟主机是 Windows IIS,不支持 chmod。lftp 每次 mirror 都会报一堆红色错误。解决:加上 2>/dev/null 重定向,不影响上传。

GitHub 拉不下来

我在国内,GitHub 直连经常超时。用 gitclone.com 镜像来 clone 主题:

git clone --depth 1 https://gitclone.com/github.com/adityatelange/hugo-PaperMod themes/PaperMod

Hugo deprecation

Hugo 0.161 废弃了一些配置项:

  • languageCode → 改成 locale
  • languages.zh.languageName → 改成 languages.zh.label

PaperMod 主题本身也有一些废弃的变量引用,等主题更新就好。

总结

这个工作流搭建完后,写作变成了一件很纯粹的事:打开 Obsidian,写,保存,完事。

技术是服务于创作的,而不是反过来。