fix: 解决重构后自定义页面问题

1. 添加模板回退机制,当找不到指定模板时自动使用page.hbs通用模板
2. 支持在页面配置中通过template字段指定使用的模板文件
3. 更新配置文件和文档,添加template字段使用说明

Closes #10
This commit is contained in:
Zuoling Rong
2025-05-09 16:12:49 +08:00
parent fb32f06f19
commit 4a5f44bc71
7 changed files with 98 additions and 3 deletions

View File

@@ -147,6 +147,32 @@ MeNav 模板系统的数据流如下:
## 模板使用示例
### 布局模板使用
布局模板通常只有一个 `default.hbs`,会自动被系统使用。
### 页面模板使用
页面模板对应导航中的各个页面,有两种使用方式:
1. **自动匹配**系统会尝试使用与页面ID同名的模板例如页面ID为 `projects` 时会使用 `projects.hbs`
2. **显式指定**:在页面配置中使用 `template` 字段指定要使用的模板
#### 模板指定示例
`config/user/pages/项目.yml` 中:
```yaml
title: "我的项目"
subtitle: "这里展示我的所有项目"
template: "projects" # 使用 projects.hbs 模板而不是使用页面ID命名的模板
categories:
- name: "网站项目"
icon: "fas fa-globe"
sites:
- name: "个人博客"
# ... 其他字段
```
**注意**当系统找不到指定的模板或与页面ID匹配的模板时会自动使用通用模板 `page.hbs`
### 引用组件
在页面或其他组件中引用组件: