Astro-Sakura 站点初始化与发文指南

如果会枝准备把这个仓库真正当成自己的博客来用，最值得先做的不是继续加功能，而是先把站点信息换成自己的，再把发文流程固定下来。这样后面不管是继续补 SEO、评论还是同步脚本，都会更顺。

这篇文章会把两件事讲清楚：

1. 初始化站点时需要改哪些内容
2. 后续新增一篇文章应该怎么做

先改站点基础信息

当前项目里，站点信息还分散在几个文件里，没有收成统一配置。所以初始化第一步，建议先把这些地方改成自己的内容。

1. 站点域名

文件：astro.config.mjs

这里的 site 决定了站点的基础域名，后面如果接 RSS、sitemap、canonical URL，这个值都会被用到。

export default defineConfig({
  site: 'https://example.com',
});

正式使用前，把它换成自己的线上域名，例如：

site: 'https://blog.example.com'

2. 默认页面标题和描述

文件：src/layouts/BaseLayout.astro

这里控制全站默认的 <title> 和 <meta name="description">。如果某个页面没有单独传值，就会退回这里的默认文案。

当前内容：

• 默认标题：huizhi Aside
• 默认描述：一个干净、现代、轻量的 Astro Sakura 风格博客。

如果博客准备长期使用，建议改成你自己的站点名和一句真正对外展示的简介。

3. 顶部导航名称

文件：src/components/Header.astro

这里有两个部分需要看：

• 左上角站点名 huizhi's Aside
• 顶部导航文案 Home / Archive / About

如果想保留英文导航可以继续用；如果想和中文内容风格统一，也可以改成“首页 / 归档 / 关于”。

4. 首页首屏文案

文件：src/pages/index.astro

这里控制首页 Hero 的主要内容，包括：

• title
• description
• kicker
• avatar

现在这些还是偏示例性质，建议替换成真正和博客定位一致的内容。尤其是 title 和 description，它们决定了第一次打开站点时的整体气质。

5. 首页提示条文案

文件：src/pages/index.astro

首页 Hero 下方现在还有一条提示信息：

• Some Notes and Life
• Latest Posts

这两处也建议一起改掉，不然后面文章明明已经是中文了，首页还会显得有点半成品。

6. 关于页内容

文件：src/pages/about.astro

这里现在写的是项目起点说明，更像开发中的占位内容。初始化站点时，建议换成真正的“关于我 / 关于这个博客 / 这里会写什么”。

7. 页脚文案

文件：src/components/Footer.astro

当前页脚只有一句：

Powered by Astro | Theme with Sakura

如果会枝想保留技术来源说明可以继续保留；如果想更像个人博客，也可以改成：

• 自定义版权文案
• 博客一句小注释
• 保留技术栈署名但换成更自然的表达

再确认内容模型

文章内容的字段约束在 src/content.config.ts 里，目前要求这些字段：

title: string
description: string
pubDate: date
updatedDate?: date
tags: string[]
cover?: string
draft: boolean

其中最常用的是：

• title：文章标题
• description：文章摘要
• pubDate：发布日期
• tags：标签数组
• cover：封面图

updatedDate 和 draft 都是可选语义里很实用的字段。尤其是 draft，写草稿时直接设成 true，它就不会出现在页面列表和静态生成结果里。

新增一篇文章的标准流程

后面发文时，建议固定按同一套步骤走，这样最省心。

第一步：在内容目录里新建 Markdown 文件

目录位置：

src/content/blog/

文件名最好直接使用未来想要的文章 slug，比如：

• my-first-week-note.md
• how-i-use-obsidian.md
• spring-evening-thoughts.md

因为当前路由是按文件 id 生成的，文件名基本就会变成文章 URL。

第二步：填写 frontmatter

最常用模板可以直接用这一份：

---
title: 文章标题
description: 一句话摘要
pubDate: 2026-04-28
updatedDate: 2026-04-28
tags:
  - 标签一
  - 标签二
cover: https://example.com/cover.jpg
draft: false
---

如果文章还没写完，可以先改成：

draft: true

这样本地能继续写，但不会被正式页面收进去。

第三步：写正文

正文直接使用标准 Markdown 即可，当前项目已经支持：

• 标题
• 段落
• 列表
• 引用
• 代码块
• 图片

如果以后需要更复杂的交互内容，再考虑引入 MDX；但现阶段不建议为了少数文章先把复杂度抬高。

第四步：本地预览

新增文章后，先本地启动开发环境预览，重点看这几项：

• 首页卡片是否正常显示
• 标签是否正确归类
• 归档页是否排序正常
• 文章详情页头图、摘要、正文是否正常
• 封面图比例是否合适

如果文章使用了外链封面，也建议顺手看一下加载效果，避免图过大、裁切不自然或风格不统一。

第五步：构建检查

准备提交前，再做一次构建检查，确认静态生成链路是通的。只要构建能过，通常就说明：

• frontmatter 字段合法
• 路由生成正常
• 页面渲染没有明显问题

一个比较稳妥的发文习惯

如果会枝后面文章会越写越多，小枝建议顺手建立几个小习惯：

• 文件名统一使用英文 slug
• 标签命名尽量固定，不要同义词乱飞
• description 保持一句话，不要写成长段
• cover 尽量控制风格，不要每篇图的气质差太远
• 大改旧文时补 updatedDate

这些小规则单独看都不大，但文章一多，就会明显影响归档、标签和整体观感。

当前最推荐先做的初始化顺序

如果会枝想一次性收拾清楚，小枝建议按这个顺序来：

1. 改 astro.config.mjs 的域名
2. 改 BaseLayout.astro 的默认标题和描述
3. 改 Header.astro 的站点名与导航
4. 改 index.astro 的首页首屏和提示文案
5. 改 about.astro 和 Footer.astro
6. 再开始新增正式文章

这样做的好处是，第一篇真正发出去的文章，从站点标题到首页气质都会已经对齐，不会出现“文章是自己的，站点还是模板默认文案”的割裂感。