导航页配置说明
2026/3/20大约 2 分钟
导航页配置说明
导航卡片的内容通过在 nav/README.md 文件的 frontmatter 中配置来实现。
配置文件位置
打开 src/nav/README.md,修改 frontmatter 中的 categories 字段。
配置结构
---
categories:
- id: dev-tools # 分类唯一标识(用于匹配按钮和卡片)
name: 开发工具 # 底部按钮显示名称
icon: /assets/icon/... # 按钮图标路径(相对于 public 目录)
items: # 该分类下的导航卡片列表
- name: GitHub
url: https://github.com
icon: https://github.com/favicon.ico # 支持 URL、本地路径、iconfont 类名
external: true # 是否在新窗口打开
---图标格式说明
icon 字段支持三种格式:
- 完整 URL:
https://example.com/favicon.ico - 本地路径:
/assets/icon/icon.png(相对于 public 目录) - iconfont 类名:
icon-github(需要在项目中引入对应字体图标)
操作示例
添加新导航项
在对应分类的 items 数组中添加:
items:
- name: 百度
url: https://baidu.com
icon: https://www.baidu.com/favicon.ico
external: true添加新分类
在 categories 数组中添加新对象:
categories:
- id: tools
name: 工具集
icon: /assets/icon/tools.png
items:
- name: 示例工具
url: https://example.com
icon: icon-tool
external: true删除导航项
直接从 items 数组中删除对应条目即可。
壁纸配置
壁纸列表也在 frontmatter 中配置,使用 wallpapers 字段:
wallpapers:
- id: default
name: 默认主题
file: default.jpg
- id: '001'
name: 风景 001
file: 001.jpg配置说明
| 字段 | 说明 |
|---|---|
id | 壁纸唯一标识,default 表示恢复主题默认背景 |
name | 壁纸在弹窗中显示的名称 |
file | 壁纸文件名,位于 /assets/bg/ 目录下 |
添加新壁纸
- 将图片放入
public/assets/bg/目录(如009.jpg) - 在 frontmatter 中添加配置:
wallpapers:
- id: '009'
name: 我的壁纸
file: 009.jpg注意事项
- 配置位于
nav/README.md的 frontmatter 中(---包裹的区域) - 修改保存后,开发服务器会自动刷新
id字段在同一页面内必须唯一- 最后一个按钮(壁纸切换)是固定的,不需要在
categories中定义 - 如果删除
wallpapers配置或配置为空,将使用默认壁纸列表