部分新增功能使用教程

新增功能列表#

本博客已集成以下新增功能：

网站导航 - /projects/
笔记本 - /life/notebooks/
书架 - /books/
影视与游戏 - /movies-games/
更新日志 - /changelog/
日常规划 - /life/routines/
足迹 - /life/places/

1. 网站导航#

新增网站条目#

在 src/content/daohang/ 目录下创建 .md 文件：

1
---
2
name: 网站名称
3
url: https://example.com
4
description: 网站描述
5
icon: "fa7-brands:github"
6
category: 常用网站
7
order: 1
8
---

可用分类#

我的网站
常用网站
资源网站
工具网站
大佬博客
学习网站
文档
其他网站

可用图标#

使用 fa7-brands:* 格式的 FontAwesome 图标
使用 material-symbols:* 格式的 Material Symbols 图标
或使用外部图片 URL

2. 笔记本#

创建新笔记本#

在 src/content/life/notebooks/ 目录下创建文件夹，例如 my-notebook/
在文件夹内创建 _index.json 文件：

1
{
2
  "name": "我的日记本",
3
  "summary": "记录生活点滴",
4
  "cover": "cover.jpg"
5
}

在文件夹内创建 .md 文件作为日记条目：

1
---
2
name: 日记标题
3
date: 2024-01-15
4
tags: ["生活", "感悟"]
5
image: ["photo1.jpg", "photo2.jpg"]
6
---
7

8
日记内容...

3. 书架#

新增书籍#

在 src/content/bangumi/books/ 目录下创建 .md 文件：

1
---
2
title: "书籍名称"
3
category: "book"
4
image: "https://example.com/cover.jpg"
5
score: 9.5
6
status: 2
7
comment: "我的评价"
8
tags: ["科幻", "小说"]
9
published: "2024-01-01"
10
---
11

12
书籍简介...

status 状态值#

1 - 想看（wish）
2 - 看过（collect）
3 - 在看（doing）
4 - 搁置（on_hold）
5 - 抛弃（dropped）

4. 影视与游戏#

新增影视作品#

在 src/content/bangumi/movies/ 目录下创建 .md 文件：

1
---
2
title: "电影名称"
3
category: "real"
4
subcategory: "movie"
5
image: "https://example.com/cover.jpg"
6
score: 9.4
7
status: 2
8
comment: "我的评价"
9
tags: ["科幻", "冒险"]
10
published: "2014-01-01"
11
---
12

13
电影简介...

新增游戏#

在 src/content/bangumi/games/ 目录下创建 .md 文件：

1
---
2
title: "游戏名称"
3
category: "game"
4
image: "https://example.com/cover.jpg"
5
score: 9.8
6
status: 3
7
comment: "我的评价"
8
tags: ["冒险", "开放世界"]
9
published: "2024-05-12"
10
---
11

12
游戏简介...

category 分类值#

book - 书籍
anime - 动漫
game - 游戏
real - 影视

subcategory 子分类（仅影视）#

movie - 电影
tv - 电视剧
anime - 动漫
documentary - 纪录片

5. 更新日志#

新增更新记录#

在 src/content/changelog/ 目录下创建 .md 文件：

1
---
2
version: "v1.0.1"
3
date: 2024-01-15
4
time: "10:30"
5
type: feature
6
description: "新增功能描述"
7
---

type 类型值#

feature - 新功能
improvement - 改进
fix - 修复
removal - 删除

6. 日常规划#

新增规划条目#

在 src/content/routines/ 目录下创建 .md 文件：

1
---
2
name: 晚间学习
3
time: "20:00 - 22:00"
4
description: 学习新技术
5
icon: 📚
6
color: "#6366f1"
7
updatedAt: 2024-01-15
8
---
9

10
## 学习内容
11

12
- 阅读技术文档
13
- 编写代码
14
- 总结笔记

7. 足迹#

新增地点记录#

在 src/content/life/places/ 目录下创建 .md 文件：

1
---
2
province: 北京市
3
city: 朝阳区
4
district: 三里屯
5
visitCount: 5
6
date: 2024-01-10
7
experience: 繁华的商业区，有很多时尚店铺和美食
8
---

8. 音乐播放器#

配置歌单#

修改 src/config/musicConfig.ts 文件：

1
playlists: [
2
  {
3
    id: "daily",
4
    name: "每日推荐",
5
    server: "netease",
6
    type: "playlist",
7
    playlistId: "8659142201"
8
  },
9
  {
10
    id: "classical",
11
    name: "古典音乐",
12
    server: "tencent",
13
    type: "playlist",
14
    playlistId: "5575587639"
15
  },
16
]

支持的平台#

netease - 网易云音乐
tencent - QQ音乐
kugou - 酷狗音乐

注意事项#

图片路径：使用外部 URL 或相对于 src/content/ 目录的相对路径
日期格式：使用 YYYY-MM-DD 格式
排序：大多数功能按日期倒序排列，最新的在前面
缓存：修改内容后需要重启开发服务器或重新构建
图标：优先使用项目已有的图标库，避免外部依赖

开发命令#

1
# 启动开发服务器
2
npm run dev
3

4
# 构建生产版本
5
npm run build
6

7
# 预览生产版本
8
npm run preview

音乐