这个博客是怎么搭起来的

·2 分钟·松鼠

这篇记录一下这个站的技术构成,方便以后的自己回来看,也方便想照抄的人。

结论先行

  • 生成器:一个两百多行的 Python 脚本,只用标准库,没有第三方依赖;
  • 托管:Cloudflare Pages,免费额度对个人博客绰绰有余;
  • 成本:域名一年十几块,其余全免;
  • 发布:跑一次脚本,把 public 文件夹拖进 Cloudflare,结束。

目录结构

路径作用
config.json站点标题、简介、域名
content/posts/*.md文章,一篇一个文件
content/about.md关于页
templates/base.html页面骨架,改版式从这里下手
static/style.css全部样式,配色在 :root 里
build.py生成器本体
public/生成结果,不要手改

写一篇文章

新建 content/posts/文件名.md,开头写一段 front matter:

---
title: 文章标题
date: 2026-11-11
tags: [随笔, 建站]
summary: 列表页显示的一句话摘要
---

正文从这里开始。

date 决定排序,tags 会生成对应的标签页,summary 不写的话会自动截取第一段。

发布流程

  1. 打开 PowerShell,在博客目录里执行 .\build.ps1;
  2. 检查 public 里生成的页面,或者本地起个服务预览;
  3. 打开 Cloudflare Pages 的项目,把 public 文件夹拖进上传区;
  4. 等十几秒,刷新线上地址。

拖拽上传的缺点是每次都要手动拖一次。等文章多到觉得烦了,再考虑接 GitHub 自动构建也不迟。

为什么不用现成的框架

本来想用 Hugo,一台机器一个二进制,模板生态也成熟。但这台 Windows 机器上没有装,外网又被限制,下载不下来。于是退一步:既然需求只是“Markdown 进、HTML 出”,那就自己写一个。

自己写的好处是没有黑盒:任何一个字节出了问题,都能在两百行里找到原因。坏处是没法白嫖主题,样式得自己一笔一笔写。不过对于个人博客,一套样式用三年,也算划算。

后面想加的东西

  • 按年份的 RSS 归档
  • 文章内的图片灯箱
  • 一个简单的“相关文章”推荐

这些都可以慢慢来。先让它能写,再让它好看。