一百来行 Python,写一个能用的静态博客生成器
上一篇说了为什么要自己写生成器,这篇说说具体怎么让它「能用」。重点不是代码有多优雅,而是把几个必须的功能补齐。
frontmatter 解析
文章开头用 --- 包一段元信息,是最省事的方式:
---
title: 文章标题
date: 2026-10-28
tags: Python, 静态站
---
解析的时候不需要上 YAML 库,按行拆 key: value 就够了:
def split_frontmatter(raw: str):
match = re.match(r"^---\s*\n(.*?)\n---\s*\n(.*)$", raw, re.S)
if not match:
return {}, raw
meta = {}
for line in match.group(1).splitlines():
if ":" in line:
key, value = line.split(":", 1)
meta[key.strip()] = value.strip()
return meta, match.group(2)
生成器该有的小功能
真正用起来之后,我发现这几件事缺一不可:
- 按日期排序,首页只放最近三篇;
- 上一篇 / 下一篇导航,读文章时很自然要翻;
- 摘要,没写
summary就自动截正文前几十个字; - 阅读时间,按字数粗算一下,给读者一个心理预期;
- 标签,至少能看出这篇文章大概讲什么。
功能不用一次做完,用到什么加什么,是这类小工具能活下来的关键。
构建流程
最终 build.py 的流程就四步:
posts = load_posts() # 读 Markdown、渲染 HTML
copy_static("static", "dist") # 拷贝 CSS / JS / 图片
write_pages(posts) # 生成首页、列表、文章页
print_report() # 打印生成了几个页面
每次写完文章,运行 python build.py,然后 rsync 到服务器,一次发布不到十秒。
写在最后
做这类东西最大的收获不是「学会了写生成器」,而是发现自己对「网站是怎么长出来的」有了完整的掌控感——从一行 Markdown 到公网上能打开的页面,中间每一步都是自己写的。
这种感觉挺好的。