这个博客是怎么搭起来的

整个网站由一个脚本生成：build.py 读取 content/ 里的 Markdown，套上模板，输出一堆静态 HTML 到 dist/。

目录结构

site.toml          站名、简介、主题分类
build.py           生成器
content/posts/     文章，一篇一个 .md
content/pages/     独立页面（比如「关于」）
static/            样式、脚本、图标
dist/              生成结果，部署的就是它

写一篇新文章

在 content/posts/ 下新建一个文件，文件名是 日期-英文短名.md：

---
title: 文章标题
topic: tech
summary: 一两句摘要，会显示在卡片上
---

正文从这里开始。

topic 填 site.toml 里某个主题的 slug。还有两个可选项：pinned: true 会把文章放到首页第一张大卡片，draft: true 则暂时不发布。

预览与发布

.venv/bin/python build.py --serve

打开 http://localhost:4321，改完文件刷新页面就会重新生成。

为什么不用现成的框架

需求很简单：把 Markdown 变成网页。三百来行脚本够用，出了问题也看得懂。等哪天真的不够用了再换。