这个博客是怎么搭起来的
这篇记录一下这个站的技术构成,方便以后的自己回来看,也方便想照抄的人。
结论先行
- 生成器:一个两百多行的 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 不写的话会自动截取第一段。
发布流程
- 打开 PowerShell,在博客目录里执行
.\build.ps1; - 检查
public里生成的页面,或者本地起个服务预览; - 打开 Cloudflare Pages 的项目,把
public文件夹拖进上传区; - 等十几秒,刷新线上地址。
拖拽上传的缺点是每次都要手动拖一次。等文章多到觉得烦了,再考虑接 GitHub 自动构建也不迟。
为什么不用现成的框架
本来想用 Hugo,一台机器一个二进制,模板生态也成熟。但这台 Windows 机器上没有装,外网又被限制,下载不下来。于是退一步:既然需求只是“Markdown 进、HTML 出”,那就自己写一个。
自己写的好处是没有黑盒:任何一个字节出了问题,都能在两百行里找到原因。坏处是没法白嫖主题,样式得自己一笔一笔写。不过对于个人博客,一套样式用三年,也算划算。
后面想加的东西
- 按年份的 RSS 归档
- 文章内的图片灯箱
- 一个简单的“相关文章”推荐
这些都可以慢慢来。先让它能写,再让它好看。