博客功能使用教程

📝 文章（Posts）#

在 src/content/posts/ 下新建 .md 文件即可发布一篇博客。

1
---
2
title: "文章标题"
3
published: 2026-09-06      # 发布日期（必填，YYYY-MM-DD）
4
updated: 2026-09-06        # 可选，更新日期
5
description: "列表页显示的摘要"
6
image: api                 # 封面图，填 api 自动生成，或填图片 URL
7
tags: [标签一, 标签二]
8
category: "博客指南"
9
pinned: true               # true 置顶
10
draft: false
11
comment: true
12
password: "123456"         # 可选，设置后加密访问
13
passwordHint: "密码提示"
14
author: "你的名字"
15
---
16

17
这里是正文，支持完整的 Markdown 语法。

💡 快捷命令：也可以用 pnpm new-post "标题" 一键生成文章文件。

🔖 网站导航（Website）#

与笔记本一样，每个分类是一个文件夹，文件夹里的 _index.json 描述这个分类，其它 .md 就是分类下的网站。

1️⃣ 建分类文件夹 + 分类说明（src/content/website/自建网站/_index.json）：

1
{
2
  "name": "自建网站",
3
  "icon": "material-symbols:person",
4
  "order": 30
5
}

🧩 字段：name 分类名称（显示在标题与 Tab 上）、icon 分类图标（iconify 名称）、order 分类顺序。

🔢 排序规则：分类按 _index.json 的 order 从大到小排列（如 30 → 20 → 10），相同则按名称。 想把某个分类排到最前，把它的 order 调到最大即可。

2️⃣ 在分类文件夹里放网站（src/content/website/自建网站/念时笺.md）：

1
---
2
name: 念时笺                    # 网站名称
3
url: https://image.LuvGaze.com  # 网站链接
4
icon: https://image.LuvGaze.com/favicon.ico  # 图标（iconify 名称或图片 URL）
5
description: 图床               # 简介
6
order: 1                       # 同分类内的顺序：数字越小越靠前
7
---

💡 分类由所在文件夹决定，网站文件里不用再写 category。若把网站直接放在 src/content/website/ 根目录（不建文件夹），才会回退读取 frontmatter 里的 category。

📓 笔记本（Notebooks）#

笔记本是一个文件夹，里面放一个 _index.json 描述笔记本本身，再放若干 .md 文件作为笔记/笔记。

1️⃣ 建文件夹 + _index.json（src/content/notebooks/my-notebook/_index.json）：

1
{
2
  "name": "我的笔记本",
3
  "cover": "https://example.com/cover.jpg",
4
  "summary": "记录生活的点滴",
5
  "order": 10
6
}

🔢 设置笔记本顺序：_index.json 里的 order 控制笔记本在 /notebooks/ 列表中的先后，数字越大越靠前；不填默认为 0，相同 order 时按最近更新时间排序。

🔢 设置笔记条目顺序：每个 .md 笔记文件也可加 order 字段，规则同上（越大越靠前），同样不填则按日期倒序。

2️⃣ 写一篇笔记（src/content/notebooks/my-notebook/笔记一.md）：

1
---
2
title: "第一篇笔记"
3
date: 2026-09-06
4
tags: [生活, 感悟]
5
image: ["photo1.jpg", "photo2.jpg"]
6
---
7

8
这里写笔记正文……

⚠️ 注意：笔记正文文件的 title 字段必须填写，相册/列表中才会显示正确的标题。

📚 书架 / 🎬 影视 / 🎮 游戏 / 🎵 音乐（Bangumi）#

书架、影视、游戏、音乐共用一个数据源结构，字段非常接近。按目录区分：

1
---
2
title: 查理九世
3
category: book
4
image: https://example.com/book-cover.jpg
5
score: 9
6
status: 2
7
comment: 儿童冒险系列经典
8
tags: [小说, 冒险]
9
---

1
---
2
title: 故乡的云
3
category: music
4
metingServer: netease
5
metingId: "1901371647"
6
score: 9.5
7
---

🖼️ 相册（Gallery）#

在 src/content/gallery/ 下每个文件是一个相册。

1
---
2
name: 2026 夏
3
description: 夏天的照片
4
location: 厦门
5
date: 2026-08-01
6
tags: [旅行, 夏天]
7
cover: https://example.com/cover.jpg
8
images:
9
  - https://example.com/1.jpg
10
  - https://example.com/2.jpg
11
---

📁 小技巧：如果不填 images 数组，会把 public/gallery/<相册名>/ 目录下的所有图片当作该相册的图片，按文件名排序展示。

字段支持：name、description、location、date、tags、password + passwordHint（加密相册）、images（图片 URL 数组）、 cover（封面图）。

🧭 足迹（Travel）#

在 src/content/travel/ 下每个文件代表一个地点，正文部分写详细游记，访问 /travel/<文件名>/ 查看。

1
---
2
title: 北京市
3
date: 2024-05-03
4
cover: https://example.com/cover.jpg
5
province: 北京          # 省份，用于地图点亮
6
city: 朝阳区            # 城市/区县，用于地图定位
7
visitCount: 3           # 访问次数，会显示在地图统计里
8
lat: 39.9042            # 可选，纬度
9
lng: 116.4074           # 可选，经度
10
tags: [旅行]
11
---
12

13
这里是该地点的游记正文……

🗺️ 足迹页（/travel/）使用的是高德地图：默认显示省界，放大后显示市界；province + city + visitCount 三个字段决定了地图上哪个区域被点亮。

📋 规划（Plans）#

在 src/content/plans/ 下，每个文件一条规划/待办。

1
---
2
name: 完善其余内容
3
time: 随时
4
description: 规划描述
5
cover: https://example.com/cover.jpg   # 可选封面
6
updated: 2026-08-24
7
---
8

9
## 具体事项
10

11
- 补充文章
12
- 整理相册

常用字段：name、time、description、cover、updated（更新时间，用于排序）。

💰 账单（Bills）#

在 src/content/bills/ 下，每个文件一条收支记录。

1
---
2
title: 健身房会员
3
amount: 399            # 金额
4
type: expense          # expense=支出 / income=收入
5
category: 运动         # 分类，影响统计与排行
6
account: 银行卡        # 账户
7
date: 2026-09-04       # 日期 YYYY-MM-DD
8
time: "09:00"          # 时间 HH:MM
9
description: 季度会员费
10
tags: [健康]
11
---

📌 type 必填且只能是 income 或 expense；date 必填；time 格式为 HH:MM。收入的分类名（如 工资、人情收礼 ）会自动汇总到「本月分类收入」；金额为 0 的分类不会展示。

🕘 更新日志（Changelog）#

在 src/content/changelog/ 下，文件名建议用版本号（如 v2.0.2.md）。

1
---
2
version: "v2.0.2"
3
date: "2026-09-06"
4
time: "20:30"
5
type: "feature"          # feature / improvement / fix / removal
6
description: "一句话概述"
7
---
8

9
## 新增功能
10
- ...
11

12
## 优化改进
13
- ...

更新日志页在导航「关于 → 更新日志」中查看。

🤝 友链（Friends）#

在 src/content/friends/ 下，每个文件一个友链。

1
---
2
title: 朋友的名字
3
imgurl: https://example.com/avatar.png   # 头像
4
desc: 一句简介
5
siteurl: https://example.com
6
tags: [Blog]
7
weight: 10            # 排序权重，大的排前面
8
enabled: true         # false 时隐藏
9
---

⚙️ 常见配置#

多数全局配置在 src/config/ 下：

音乐页的歌词「已唱/未唱」颜色、默认歌单、Meting 接口都可在 src/config/musicConfig.ts 中调整；也可在后台管理「音乐播放器配置」中可视化修改。

⚠️ 注意事项#

• 日期格式：一律使用 YYYY-MM-DD；时间使用 HH:MM。
• 图片路径：支持远程 URL，或相对 src/content/ 的相对路径。
• 排序规则：书架/影视/游戏按“状态”分组（在用→已看→想看→搁置→抛弃），同状态下按评分降序；其余多数按日期倒序。
• 缓存：修改内容后需要重新构建（pnpm build）或重启开发服务器才会更新。

🚀 开发命令#

1
pnpm dev        # 启动开发服务器（http://localhost:4321）
2
pnpm build      # 构建生产版本（输出到 dist/）
3
pnpm preview    # 预览生产版本

💘 祝你的数字花园越来越丰盛。如果某个功能不清楚，欢迎再留言问我！