首页 | 数学 | 计算机 | 马克思主义 | 归档 | 路线 | 关于 | RSS

blog 搭建与维护记录

2026-06-09 | 计算机

当前结构

这个 blog 第一版是一个极简静态站点。内容写在 content/，生成结果写到 site/。

• content/math/：数学笔记
• content/cs/：计算机笔记
• content/marxism/：马克思主义笔记
• scripts/bloglib.py：共享的文章元数据规则
• scripts/build.py：Markdown 到 HTML 的生成器
• scripts/new_post.py：新文章草稿生成器
• scripts/list_posts.py：文章和草稿列表
• docs/maintenance.md：维护流程
• docs/project-structure.md：源文件和生成文件的边界
• docs/decisions.md：搭建选择和取舍

构建命令

常用命令：

make new SUBJECT=cs SLUG=example TITLE="示例文章"
make new SUBJECT=cs SLUG=example-draft TITLE="示例草稿" DRAFT=true
make audit
make build
make check
make list
make serve
make test
make clean

make audit 会依次运行测试、站点检查和文章列表。

make check 会重新生成站点，并检查三个问题：

1. 首页、关于页、路线页、归档页、RSS feed 和学科索引页是否存在。
2. 输出 HTML 是否包含 CSS 或 JavaScript。
3. 站内链接是否断裂。
4. RSS feed 是否是可解析的 XML。
5. 文章头部字段是否拼写正确。
6. 文章文件名是否规范，所在目录是否和 subject 一致。

文章头部可以写 draft: true。草稿不会生成到 site/，适合先积累材料。

查看文章和草稿可以运行 make list。

本地预览可以运行 make serve，默认打开 http://localhost:8000。

测试生成器规则可以运行 make test。

RSS feed 会生成到 site/feed.xml，只包含已发布文章。

设计原则

这个站点暂时不追求复杂功能。第一阶段的重点是：

• 学会 HTML 的基本结构。
• 把学习内容持续写下来。
• 让每次新增文章都有简单可靠的流程。
• 保持页面朴素，靠标题、段落、列表和链接组织内容。

下一步问题

后续可以继续思考这些问题：

• 是否需要初始化 Git 仓库？
• 是否需要发布到 GitHub Pages？
• 是否需要把 site/ 纳入版本管理？
• 是否需要按年份归档？
• 是否需要为数学笔记增加更系统的公式方案？