博客运营备忘录 - 江鸟博客

一、日常写作与发布#

1. 同步云端#

⚠️ 重要： 如果有在多设备编辑博客，每次打开 VS Code 准备写东西前，必须先运行这条。

1
git pull

2. 本地预览 (Dev)#

启动本地服务器，实时查看文章效果。浏览器访问 http://localhost:4321。

1
pnpm dev
2
# 写完后在终端按 Ctrl + C 退出预览

3. 新建文章#

快速生成带有标准格式头部的文章文件。

1
pnpm new-post my-new-article
2
# 文件名建议用英文，生成的文章在 src/content/posts/ 目录下

4. 发布#

写完文章、改完代码后，依次执行这三行，博客就会自动更新。

1
git add .
2
git commit -m "新增文章：我的新博客"
3
git push

二、Markdown 格式规范#

1. 文章头部模板#

1
---
2
title: "这里写标题"              # 必填，数字标题记得加引号 "2025"
3
published: 2025-11-26           # 必填，日期格式 YYYY-MM-DD
4
description: "文章的简短摘要"    # 选填，显示在卡片上
5
image: ""                       # 选填，封面图路径 (./cover.jpg 或 https://...)
6
tags: ["标签A", "标签B"]        # 选填
7
category: "分类名称"            # 选填
8
draft: false                    # 必填，true=草稿(不发布)，false=正式发布
9
---

2. 插入图片#

本地图片：将图片放入 src/assets/ 文件夹。
```
1
![描述文字](../../assets/image-name.jpg)
```

图床/外部图片：

1
![描述文字](https://example.com/image.jpg)

3. 特色提示块#

1
:::note
2
这是一个普通提示块
3
:::
4

5
:::tip
6
这是一个技巧提示块
7
:::
8

9
:::caution
10
这是一个警告提示块
11
:::
12

13
:::danger
14
这是一个危险操作提示块
15
:::

三、Git版本控制#

1. 版本回退#

如果把代码改崩了，想回到过去。

查看历史版本 ID：
Terminal window
```
1
git log --oneline
```
回退到指定版本：
Terminal window
```
1
git reset --hard CommitID
```
强制覆盖云端 (会覆盖远程记录)：
Terminal window
```
1
git push -f origin main
```

四、配置文件#

功能	文件路径	说明
核心配置	`src/config.ts`	修改标题、头像、背景图、导航栏、评论配置
系统配置	`astro.config.mjs`	修改网站域名、预加载策略、SEO 链接
页脚统计	`src/components/Footer.astro`	修改建站日期、字数统计逻辑、备案号
侧边栏	`src/components/widget/Profile.astro`	修改侧边栏的访客统计代码
番组计划	`src/pages/bangumi.astro`	修改 Bangumi UserID、番组分类逻辑
归档页	`src/pages/archive.astro`	修改归档页的时间流逝卡片
关于我	`src/content/spec/about.md`	修改个人介绍内容
全局样式	`src/layouts/Layout.astro`	修改 `<head>` 标签、全局 CSS (如无感切换)
自动部署	`.github/workflows/deploy.yml`	修改定时自动更新的时间 (cron)

五、定时任务说明#

我的博客配置了自动化脚本。

番组计划更新：每 1 小时触发一次 Cloudflare Pages 重新构建，以更新 Bangumi 数据。
如何修改频率：编辑 .github/workflows/deploy.yml 中的 cron 字段（GitHub Actions 使用 UTC）。
前置配置：在 GitHub Actions Secrets 中添加 CF_PAGES_DEPLOY_HOOK_URL（Cloudflare Pages 项目里创建 Deploy Hook 后复制 URL）。
- 格式：分时 * * * (使用 UTC 时间，北京时间需减去 8 小时)。
手动触发：GitHub 仓库 -> Actions -> Auto Deploy Blog -> Run workflow。