建站

痛点 每次写网页报告，样式和内容糊在一起。改个颜色要重新生成全文，换风格等于重写。更烦的是，内容写在一个专有编辑器里，换个工具就迁移不了。 解决方案：拆两层 内容层只管写什么——Markdown 文件，带 YAML 头信息。 样式层只管长什么样——独立的 HTML 模板，用 {{变量}} 占位符接收内容。 中间一个渲染脚本串起来，输入 MD 选模板，输出成品 HTML。 具体实现 目录结构 ~/.hermes/ |-- scripts/ | +-- render_page.py |-- templates/ |-- default.html |-- dark.html +-- magazine.html 模板文件是独立 HTML，用 {{title}}、{{content}}、{{toc}} 等占位符接收内容。想加新模板？写一个 HTML 丢进 templates/ 就行，脚本自动识别。 使用方法 python3 ~/.hermes/scripts/render_page.py 文章.md python3 ~/.hermes/scripts/render_page.py 文章.md -t dark python3 ~/.hermes/scripts/render_page.py 文章.md -t magazine 文章格式 每篇文章开头加 YAML 头信息： --- title: 标题 date: 2026-08-06 description: 一句话描述 --- 正文内容... 配合 Obsidian 使用 设置软链接 ln -s ~/Documents/Obsidian/Blog /path/to/hugo/content/posts 写作流程 在 Obsidian 里写文章，存到 Blog/ 文件夹 用标准 Markdown，不要用 [[双向链接]] 图片用  语法 保存后 Hugo 自动就能读到 发布流程 hugo git add . && git commit -m "新文章" && git push Cloudflare Pages 自动构建上线。 ...

为什么搭这个站 之前一直用 Bear 和 Obsidian 记笔记，但笔记都是私有的。有些内容想公开分享，需要一个博客。 技术选型 工具 作用 理由 Hugo 静态站点生成器 快，一个二进制搞定，零依赖 PaperMod Hugo 主题 干净、功能全、适合笔记站 Obsidian 写作工具 日常记笔记的地方，直接写 MD Cloudflare Pages 部署 免费，全球 CDN，自动 HTTPS 工作流 在 Obsidian 里写文章，保存到 02-Projects/uuunit.com/posts/ 目录，推送到 GitHub，Cloudflare 自动部署。 避坑 主题文件不要手写简化版，直接拉官方主题 HUGO_VERSION 环境变量必须和主题要求一致 模板里 range 嵌套容易导致菜单重复渲染，注意检查 print("Hello, uuunit.com!")