Fuwari & Mizuki 博客模板简易使用指南

封面图片来源：来源

本博客模板基于 Astro 构建。本指南中未提及的内容，你可前往 Astro 官方文档查阅答案。

文章前置元数据说明#

1
---
2
title: 我的第一篇博客文章
3
published: 2025-01-31
4
description: 这是我新搭建的 Astro 博客的第一篇文章
5
image: ./cover.jpg
6
tags: [分享, 示例标签2]
7
category: qgxs
8
draft: false
9
---

1
---
2
title: 111
3
published: 2025-01-31
4
description: 111
5
tags: ["分享"]
6
category: qgxs
7
draft: false
8
---

配置项	说明
`title`	文章标题
`published`	文章发布日期
`description`	文章简短描述，将在博客首页展示
`image`	文章封面图片路径 1. 以 `http://` 或 `https://` 开头：使用网络图片 2. 以 `/` 开头：引用 `public` 目录下的本地图片 3. 无上述前缀：引用与当前 Markdown 文件同级目录的图片
`tags`	文章标签
`category`	文章分类
`draft`	文章草稿标识，设为 true 时该文章将不会在博客中展示

文章文件的存放位置#

文章文件需存放至 src/content/posts/ 目录下。你也可创建子目录，更规范地管理文章及相关资源文件。

1
src/content/posts/
2
├── post-1.md
3
└── post-2/
4
    ├── cover.png
5
    └── index.md

常用分类与标签推荐#

配置示例#

配置参考：

1
---
2
title: Astro博客搭建全流程教程
3
published: 2024-01-15
4
description: 从零开始搭建基于Astro框架的Fuwari博客，包含配置、部署与优化技巧
5
image: ./astro-cover.png
6
tags: [技术, 代码, 教程, 工具, 效率]
7
category: 技术
8
draft: false
9
---

Mizuki#

置顶文章功能 pinned 字段允许您将重要文章置顶到博客列表的顶部。置顶文章将始终显示在普通文章之前，无论其发布日期如何。

使用方法：

1
pinned: true  # 将此文章置顶
2
pinned: false # 普通文章（默认）

排序规则：

置顶文章优先显示，按发布日期排序（最新在前）普通文章随后显示，按发布日期排序（最新在前）文章级评论控制 comment 字段允许您单独控制每篇文章评论区的开启与关闭。

使用方法：

1
comment: true  # 启用评论（默认）
2
comment: false # 禁用评论

特色页面配置

追番页面：在 src/pages/anime.astro 中编辑动画列表

友链页面：在 src/content/spec/friends.md 中编辑朋友数据

日记页面：在 src/pages/diary.astro 中编辑动态

关于页面：在 src/content/spec/about.md 中编辑内容

音乐

音乐

文章前置元数据说明#

文章文件的存放位置#

常用分类与标签推荐#

推荐文章分类#

推荐文章标签#

配置示例#

Mizuki#

支持与分享

音乐

目录