为了丰富博客内容并提升不同板块之间的关联性,本站对原生主题进行了一些定制与魔改,开发了一些独有的博客联动功能。
日记关联活动卡片#
当您在日记页面记录生活或撰写读后感、游戏简评、装备开箱等内容时,可以直接在当前日记上方联动显示对应的卡片(样式与首页的“活动卡片”一致)。卡片支持点击并跳转到对应的详情页面,极大地方便了内容的互联。
使用方法#
在日记的 Markdown 文件(位于 src/content/diary/)的 Frontmatter 中,添加 linkCard 配置项:
---
title: ' '
publishDate: 2026-06-16
linkCard:
type: book # 关联类型(必填)
name: 神的模仿犯 # 关联项目名称(必填,须与数据源中的名称一致)
---yaml支持的关联类型 (type)#
目前支持以下 7 种关联类型,配置后卡片会自动解析对应数据源中的元数据(如封面图、评分、日期、简评等):
类型值 (type) | 对应板块 | 数据源文件 | 自动获取的元数据 |
|---|---|---|---|
book | 阅读页面 (/books) | public/books.yaml | 封面图、评分、阅读状态/日期、简评描述 |
movie | 影视页面 (/movies) | public/movies.yaml | 封面图、评分、观影日期、简评描述 |
series | 影视页面 (/movies) | public/movies.yaml | 封面图、评分、观影日期、简评描述 |
anime | 影视页面 (/movies) | public/movies.yaml | 封面图、评分、观影日期、简评描述 |
game | 游戏页面 (/games) | public/games.yaml | 封面图、评分、游玩日期/状态、简评描述 |
equipment | 装备页面 (/equipment) | public/equipment.yaml | 封面图、价格/规格、购入日期、简评描述 |
travel | 旅行页面 (/travel) | public/travel.yaml / travel 集合 | 封面图、评分、旅行日期、简评描述 |
示例#
例如,如果您想写一篇关于小说《神的模仿犯》的读后感,日记文件内容如下:
---
title: ' '
publishDate: 2026-06-16
linkCard:
type: book
name: 神的模仿犯
---
今天读完了这本小说,里面关于智斗和单元剧的描写非常精彩,特此记录……yaml渲染效果与降级处理#
- 正常渲染:组件会自动到对应的数据源中匹配
name,提取封面、评分、日期和简评,并以精美的卡片形式横向展示在日记文本正上方,右侧附带跳转箭头。 - 防错降级:如果数据源中没有找到对应名字的项,卡片依然会生成,但会降级显示为“未能在数据源中匹配”的占位卡片,同时保留类型标签 and 跳转链接,不会导致页面构建失败。