Hello Chirping Astro

之前一直使用 mkdocs 写笔记，因为低年级学习的知识还算成系统，比如课程笔记，一门课可以按内容分成几份笔记，mkdocs也很适合管理分类分的很清楚的笔记，同时也很简约很轻量化。

大二结束后，逐渐感觉想记录东西不再成明显的体系，单篇笔记的主体性更高一点，所以想着再开一个博客站来记录，选择了 Chirping Astro 主题，主要是因为他的对于文字内容呈现有比较好的优化，同时比较简约。

网站链接：

• 主题 live demo
• github repo

start up

使用 github 上的模版 创建仓库，clone到本地

配置本地环境

在 windows 上需要下载 bun

powershell -c "irm bun.sh/install.ps1 | iex"

重启终端，确认bun已配置好环境变量，bun --version可用

然后进入根目录，安装依赖

bun install

即可打开本地预览

bun dev

bun run dev --force

修改基本信息

复制.env.example为.env，修改site_url

修改src/config.ts

怎么新建文章

src/content/posts/en/ 新建 .md/.mdx 文件

front matter至少包含 title、description、pubDate 字段

---
title: "我的第一篇文章"
description: "这是一篇测试文章，用来熟悉 Chirping Astro 的写法。"
pubDate: 2026-08-05
updatedDate: 2026-08-06
tags: ["Astro", "博客", "GitHub Pages"]
categories: ["折腾记录"]
heroImage: /images/covers/astro-blog.webp
heroImageAlt: "夜晚电脑前的二次元风格插画"
pinned: true
toc: true
comments: true
math: false
mermaid: false
---