适用场景

这篇笔记用于记录一个纯静态博客的基础结构。目标不是做一个复杂后台，而是让内容、页面和发布链路都保持轻量。

页面结构

站点目前保留五个主要入口：

  • 首页：展示个人索引、最近更新、标签和知识库主题。
  • 博客：放阶段性记录、部署复盘和想法。
  • 知识库：按主题沉淀可反复回访的笔记。
  • 标签：把博客和知识库内容重新连接起来。
  • 关于：说明站点定位、阅读方式和联系方式。

这类结构的好处是维护成本低。新增内容时只需要写 Markdown，页面会在构建阶段自动读取内容集合。

内容集合

Astro Content Collection 负责约束 Markdown 的 frontmatter。博客和知识库使用不同集合，是为了让两类内容拥有不同的字段：

  • 博客更关注发布日期、描述和标签。
  • 知识库额外维护主题分类和建议学习时长。

当内容数量变多后，集合可以继续扩展 series、difficulty、updatedDate 等字段，但不需要一开始就把模型做得很重。

静态搜索

搜索不依赖后端。构建时把公开内容整理成一份前端索引，浏览器里用标题、描述、分类和标签做匹配。

这个方案适合个人博客，因为数据量小、部署简单、没有服务端状态。后续如果内容变得很多，可以再替换成 Pagefind 或其他静态搜索方案。

发布流程

代码推送到 GitHub 后由 Cloudflare Pages 构建。构建产物是纯静态文件，域名解析到 Cloudflare 后即可访问。

这样的发布流程把写作和部署分开：平时只需要维护 Markdown，CI 负责把站点重新生成并发布。