make new SLUG=hello-world TITLE='你好，世界' SUMMARY='第一篇,随便聊聊'
$EDITOR content/posts/hello-world.md      # 写正文 (markdown)
make publish MSG='post: hello world'      # commit + push,触发 CI

约 1 分钟后文章在 https://famzheng.me/posts/<slug>/ 上线。 CI 状态: https://famzheng.me/gitea/fam/blog/actions

content/posts/                # 文章 markdown,文件名 = URL slug
hugo.toml                     # 站点配置 (baseURL, 主题选项, social 链接)
layouts/                      # 主题 override (尽量别动)
static/                       # favicon 等公开资源
themes/PaperMod/              # 主题 (git submodule, 尽量别动)
.gitea/workflows/publish.yml  # CI: hugo build -> rsync 到 /var/gnoc/hugo-public/

Frontmatter

每篇文章顶部 YAML:

---
title: "标题"
date: 2026-04-30T10:00:00+01:00
draft: false
summary: "一句话摘要 (可选,影响列表页和 og:description)"
---

make new 会填好这四个字段,你只需要写正文。

文风 (供 AI 参考)

第一人称、口语化,不要 AI 流水账
标题简洁,正文别堆 emoji
长度 500-2000 字偏多,宁短勿长
写之前先扫一眼 content/posts/*.md 已发文章,对齐 Fam 的语气

部署机制

git push origin main
  → Gitea 触发 .gitea/workflows/publish.yml
  → host shell act_runner (gnoc 用户, 在 famzheng.com 节点)
  → 装 hugo 0.147.6 extended → hugo --minify --gc → rsync public/ /var/gnoc/hugo-public/
  → k8s gnoc-hugo/hugo (nginx) hostPath 直出
  → ingress famzheng.me/ 命中

本地预览 (可选)

需要 hugo 0.147.6 extended:

make serve    # http://localhost:1313, 热重载, draft 也能看
make build    # 一次性 build 到 public/, sanity check

README.md

blog

写一篇文章

目录

Frontmatter

文风 (供 AI 参考)

部署机制

本地预览 (可选)