时常感觉自己看的太多,想了太少,也基本上没什么输出。所以想着要不要试着写博客或者公众号。不是有句话叫 输出倒逼输入 么,也能对语言组织和表达能力做一些训练。
- Obsidian 作为笔记唯一真相源
- Publisher 作为中间层,核心功能是
发布校验+内容转换+单篇发布+撤回和预检。把任意 MD 文件及其附件标准化成 hugo content 下的 page bundle 发布格式。
content/posts/my-article/
├── index.md
├── diagram.png
└── attachment.pdf- Hugo 负责对 Publisher 的产物进行构建,放置到 public 下
- Deploy 负责部署 Public 下静态资源文件到 ECS
笔记元数据治理
因为现有的笔记都记录在 Obsidian 里,索性把 Obsidian 作为唯一内容来源,通过元数据维护状态和信息,包括发布所需的字段。
为了轻量化和维护性,选择 hugo 作为平台,跟 GPT 梳理了 Obsidian 元数据治理,期间也推翻过一版,最终定为跟主题解耦,不强制要求元数据规范,通过中间增加一个发布层完成解析和转换,hugo 构建使用最小。博客发布主要依赖以下元数据:
title: 博客显示文章标题
publishId: 文章唯一ID,UUID v4,发布时生成
slug: 文章唯一url,发布时生成
noteType: 笔记类型,支持note/daily/book/project,目前只有note和project发布到博客
private: 笔记可见性布尔值,最高优先级,只有false时配合publishStatus决定是否发布
publishStatus: draft/ready/published,发布状态
published: 首次发布日期,更新时不改
description: 一句话摘要
category: 对应博客Topic专题
tags: 对应博客Tags标签
collection: 对应博客Collection合集
project: 可选,表示文章关联项目
cover: 封面图
featured: true/false项目是否在首页展示
links: 对应博客文章内外链博客主题 Nightnote
跟 GPT 反复沟通(大部分时间是他出方案,我回一个 " 可以 “)出了设计方案,以设计包(需求说明 + 线框图 + 视觉稿)产物的形式交给 Codex 实现,用的 GPT-5.6 Sol。
喜欢 AboutMe 页面的这句:
Things I build, experiment with, and occasionally finish. 一些我在做、在实验,以及偶尔真正完成了的东西。
环境搭建和配置
出于 Local-First 倾向,把 Hugo 依赖和内容源都部署放置在内网树莓派上,只把构建静态产物同步到阿里云 ECS,通过 Caddy 暴露为静态站点。阿里云和树莓派通过 Tailscale 通信。
ECS 配置
# 确保rsync依赖完整
sudo apt install -y rsync
# 创建专属部署用户及目录,无密码,仅密钥登陆
sudo adduser --disabled-password blog
sudo mkdir -p /home/blog/.ssh
sudo chown -R blog:blog /home/blog/.ssh
sudo chmod 700 /home/blog/.ssh
sudo chmod 600 /home/blog/.ssh/authorized_keys
sudo nano /home/blog/.ssh/authorized_keys
# 粘贴 blog_deploy.pub 的内容
# 创建博客目录
sudo mkdir -p /srv/www/blog/releases
sudo chown -R blog:blog /srv/www/blog
# 域名解析配置指向ECS公网IP
vim /etc/caddy/Caddyfile
# Caddy File增加静态站块
blog.seeyou2night.xyz {
root /srv/www/blog/current
encode zstd gzip
file_server
}
# 应用Caddy改动
sudo caddy validate --config /etc/caddy/Caddyfile
sudo systemctl reload caddy树莓派配置
# 树莓派安装hugo及git和rsync依赖
sudo apt install -y hugo git rsync
## APT仓库版本过低,也可以通过release deb安装
wget https://github.com/gohugoio/hugo/releases/download/v0.166.0/hugo_extended_0.166.0_linux-arm64.deb
sudo dpkg -i hugo_extended_0.166.0_linux-arm64.deb
# 创建站点
mkdir -p ~/sites
cd ~/sites
hugo new project blog
cd blog
git init
# 使用git submodule安装主题
cd ~/sites/blog
git submodule add https://github.com/seeyou2n1ght/hugo-theme-nightnote themes/nightnote
# 本地测试
hugo server --bind 0.0.0.0
# 生产构建
rm -rf public/ && hugo --minify
# 鉴权密钥创建
ssh-keygen -t ed25519 -f ~/.ssh/blog_deploy
ssh-copy-id -i ~/.ssh/blog_deploy.pub -p <PORT> blog@<ECS_HOST>
# 身份登录配置~/.ssh/.config
Host blog-ecs
HostName <ECS_IP>
User blog
Port <ECS_PORT>
IdentityFile ~/.ssh/blog_deploy
# publisher脚本
uv run --script手动发布工作流
发布前检查:
- 强制校验
private=false和publishStatus=ready/published字段,不满足说明笔记不需要发布 - 校验发布相关元数据:
title: 博客显示文章标题
noteID: 文章唯一ID,UUID v4,发布时生成,生成后不可更改
slug: 文章唯一url,发布时生成候选并检查全站唯一性
noteType: 笔记类型,支持note/daily/book/project,目前只有note和project发布到博客
private: 笔记可见性布尔值,最高优先级,只有false时配合publishStatus决定是否发布
publishStatus: draft/ready/published,发布状态
published: 首次发布日期,更新时不改
description: 一句话摘要
category: 对应博客Topic专题
tags: 对应博客Tags标签
collection: 对应博客Collection合集
project: 可选,表示文章关联项目
cover: 封面图
featured: true/false项目是否在首页展示
links: 对应博客文章内外链- 附件提取、双链格式转换
- 以 hugo page bundle 样式生成文件夹,放置到 hugo 网站下 content 目录
Hugo/
└── content/
└── posts/
└── note-slug/
├── index.md
└── note-image.png- 构建及同步脚本:
#!/usr/bin/env bash
set -euo pipefail
REMOTE_HOST="blog@ecs"
REMOTE_BASE="/srv/www/blog"
LOCAL_PUBLIC="public"
RELEASE="$(date '+%Y%m%d-%H%M%S')"
REMOTE_RELEASE="$REMOTE_BASE/releases/$RELEASE"
echo "Building Hugo site..."
rm -rf "$LOCAL_PUBLIC"
hugo --minify
echo "Deploying release: $RELEASE"
ssh "$REMOTE_HOST" \
"mkdir -p '$REMOTE_RELEASE'"
rsync -avz \
"$LOCAL_PUBLIC/" \
"$REMOTE_HOST:$REMOTE_RELEASE/"
ssh "$REMOTE_HOST" "
ln -sfn '$REMOTE_RELEASE' '$REMOTE_BASE/current.new'
mv -Tf '$REMOTE_BASE/current.new' '$REMOTE_BASE/current'
"
echo "Deployed successfully: $RELEASE"自动化发布工作流
- 检查 Obsidian 内待发布笔记元数据
- 运行
publisher.py脚本uv run --script publisher.py "hugo-theme-nightnote.md" - 运行部署同步脚本
./deploy.sh
未来计划
未来考虑做一个 Obsidian 插件,自动化发布动作。先占个坑。
有几个路线:
- 客户端插件完成完整发布流程:内容哈希 - 元数据校验 - 双链/附件解析 -bundle 打包 - 构建并同步
- 树莓派负责暴露一个发布 API,插件只做调用
- 插件只负责维护一个
.publish-queue文件,借用FSN同步到树莓派,树莓派监听文件变动并触发构建及同步
最后
欢迎来到我的博客。