GitHub
Dashboard
← 返回博客

一百来行 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)

生成器该有的小功能

真正用起来之后,我发现这几件事缺一不可:

  1. 按日期排序,首页只放最近三篇;
  2. 上一篇 / 下一篇导航,读文章时很自然要翻;
  3. 摘要,没写 summary 就自动截正文前几十个字;
  4. 阅读时间,按字数粗算一下,给读者一个心理预期;
  5. 标签,至少能看出这篇文章大概讲什么。

功能不用一次做完,用到什么加什么,是这类小工具能活下来的关键。

构建流程

最终 build.py 的流程就四步:

posts = load_posts()          # 读 Markdown、渲染 HTML
copy_static("static", "dist") # 拷贝 CSS / JS / 图片
write_pages(posts)            # 生成首页、列表、文章页
print_report()                # 打印生成了几个页面

每次写完文章,运行 python build.py,然后 rsync 到服务器,一次发布不到十秒。

写在最后

做这类东西最大的收获不是「学会了写生成器」,而是发现自己对「网站是怎么长出来的」有了完整的掌控感——从一行 Markdown 到公网上能打开的页面,中间每一步都是自己写的。

这种感觉挺好的。