时常感觉自己看的太多,想了太少,也基本上没什么输出。所以想着要不要试着写博客或者公众号。不是有句话叫 输出倒逼输入 么,也能对语言组织和表达能力做一些训练。

  • 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. 一些我在做、在实验,以及偶尔真正完成了的东西。

参考 hugo-theme-nightnote

环境搭建和配置

出于 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

手动发布工作流

发布前检查:

  1. 强制校验 private=false和publishStatus=ready/published 字段,不满足说明笔记不需要发布
  2. 校验发布相关元数据:
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: 对应博客文章内外链
  1. 附件提取、双链格式转换
  2. 以 hugo page bundle 样式生成文件夹,放置到 hugo 网站下 content 目录
Hugo/
└── content/
    └── posts/
        └── note-slug/
            ├── index.md
            └── note-image.png
  1. 构建及同步脚本:
#!/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"

自动化发布工作流

  1. 检查 Obsidian 内待发布笔记元数据
  2. 运行 publisher.py 脚本 uv run --script publisher.py "hugo-theme-nightnote.md"
  3. 运行部署同步脚本 ./deploy.sh

未来计划

未来考虑做一个 Obsidian 插件,自动化发布动作。先占个坑。

有几个路线:

  1. 客户端插件完成完整发布流程:内容哈希 - 元数据校验 - 双链/附件解析 -bundle 打包 - 构建并同步
  2. 树莓派负责暴露一个发布 API,插件只做调用
  3. 插件只负责维护一个 .publish-queue文件,借用FSN 同步到树莓派,树莓派监听文件变动并触发构建及同步

最后

欢迎来到我的博客。