如何开始维护这个博客

这是一篇留给博客维护者的上手说明。网站会在构建时把文章、标签、搜索索引、RSS（内容订阅源）和分享图一起生成，因此发布新内容不需要数据库或管理后台。

目录

新建文章

在 src/content/posts/ 目录中新建 Markdown/MDX（轻量内容文件格式）文件。文件名会成为文章地址的一部分，建议使用简短、稳定的英文名称，例如：

src/content/posts/
├── getting-started.md
└── astro-content-collections.md

每篇文章都从一段 Frontmatter（文章头部元数据）开始：

---
title: "文章标题"
description: "用于文章列表和搜索结果的简短摘要。"
pubDatetime: 2026-07-13T13:00:00+08:00
modDatetime: 2026-07-13T13:00:00+08:00
draft: false
tags:
  - Astro
  - 工程实践
---

• pubDatetime 是首次发布时间。
• modDatetime 只在文章内容确实更新时修改。
• draft: true 的文章不会进入正式构建、搜索、标签页或 RSS。
• 没有单独提供 ogImage 时，网站会根据标题自动生成社交分享图。

本地预览

安装依赖后启动开发服务：

pnpm install
pnpm dev

站内搜索依赖构建后的静态索引。需要完整验证搜索时，先执行：

pnpm build
pnpm preview

发布流程

推送到 main（主分支）后，GitHub Actions（自动构建服务）会生成静态页面与搜索索引，并将结果发布到 GitHub Pages（静态网站托管服务）。

正式发布前至少确认三件事：

1. 标题和摘要能够准确概括文章。
2. 代码示例可以直接运行，命令没有遗漏前置条件。
3. 手机与桌面端阅读时，标题层级和代码块都清晰可用。

完成这些检查后，这篇文章就可以和源码一起长期保存、持续更新。