第一篇:为什么我要自己写一个静态站生成器
从想做一个个人站,到真正打开编辑器写第一行代码,中间隔了很久。原因很简单:可选项太多,反而不知道选哪个。
现成的方案其实不少
Hexo、Hugo、Astro、Next.js,甚至直接上 VitePress,都能很快把我的 Markdown 变成网页。我挨个试了一遍,最后却有了一个略显固执的想法:
这个站是我的作品集。如果连它本身都是「点几下生成」的,好像少了点什么。
于是决定:不用框架,自己写一个最小的静态生成器。要求也不高:
- 读取
content/posts/*.md,解析 frontmatter 和 Markdown; - 套上统一的模板,生成首页、博客列表和文章页;
- 输出到
dist/,扔给 Nginx 就能跑。
核心其实只有三板斧
整个生成器的核心,其实就是「读 Markdown、套模板、写文件」三步。把 Markdown 交给 markdown 这个库,剩下的都是字符串拼接:
from pathlib import Path
import markdown
def build_post(path: Path) -> str:
raw = path.read_text(encoding="utf-8")
meta, body = split_frontmatter(raw)
html = markdown.markdown(body, extensions=["fenced_code", "tables"])
return render_template("post.html", meta=meta, content=html)
看起来有点简陋,但好处是:
- 每一行代码我都知道在干什么;
- 想改样式、加页面,直接改模板就行;
- 部署产物就是一堆 HTML,没有任何运行时。
代价是什么
代价当然也有。没有插件生态、没有增量构建、没有现成的 SEO 优化。但我现在的写作频率,远没有高到需要这些的程度。
先让它跑起来,剩下的以后再说。这大概就是做小项目该有的心态。