fix: 补齐书签 subgroups 渲染并对齐 README

- 修复 subgroups 生成但不展示的问题(模板渲染 + 前端结构导出)
- 更新 README:配置示例/完全替换策略/多层级说明与 helper 文档,减少重复说明
This commit is contained in:
rbetree
2025-12-22 02:08:05 +08:00
parent 2daba411ba
commit 670e73e93c
8 changed files with 222 additions and 88 deletions

View File

@@ -59,7 +59,7 @@ MeNav 配置系统采用“完全替换”策略(不合并),按以下优
2. **字段与结构的权威参考**
- 全局配置:[`_default/site.yml`](_default/site.yml)
- 页面配置:[`_default/pages/`](_default/pages/)
3. **多层级嵌套书签示例**[`_default/pages/bookmarks-four-level.yml`](_default/pages/bookmarks-four-level.yml)2~4 层结构均有覆盖
3. **多层级嵌套书签示例**[`_default/pages/bookmarks-four-level.yml`](_default/pages/bookmarks-four-level.yml)示例展示到 `groups``subgroups` 可参考下方说明或由导入脚本生成
## 模块化配置文件
@@ -69,7 +69,7 @@ MeNav 配置系统采用“完全替换”策略(不合并),按以下优
- 网站标题、描述和关键词
- 作者信息和版权声明
- 字体配置和主题设置
- 字体配置、图标模式等全局设置
- 全局元数据和站点参数
- 个人资料和社交媒体链接
- 导航菜单配置(侧边栏导航项、页面标题和图标、页面顺序和可见性)
@@ -151,6 +151,22 @@ MeNav 配置系统采用“完全替换”策略(不合并),按以下优
4. `subgroups`:子分组
5. `sites`:站点(叶子节点)
若你需要第 4 层(`subgroups`),结构示例(片段):
```yaml
categories:
- name: 示例分类
subcategories:
- name: 示例子分类
groups:
- name: 示例分组
subgroups:
- name: 示例子分组
sites:
- name: 示例站点
url: https://example.com
```
#### 向后兼容性
- 原有二层结构(`categories -> sites`)无需修改即可继续使用
@@ -159,12 +175,16 @@ MeNav 配置系统采用“完全替换”策略(不合并),按以下优
## 配置优先级
配置项的优先级从高到低为:
MeNav 配置系统采用“完全替换”策略:只会选择一套目录加载,不会把 `user``_default` 混合合并。
1. 用户页面配置 (`user/pages/*.yml`)
2. 用户网站配置 (`user/site.yml`)
3. 默认页面配置 (`_default/pages/*.yml`)
4. 默认网站配置 (`_default/site.yml`)
- 若存在 `config/user/`:只加载 `config/user/`,并**完全忽略** `config/_default/`
- 否则:加载 `config/_default/`
在“同一套目录”内,各文件的关系是:
- `site.yml`:站点全局配置(包含 `navigation` 等)
- `pages/*.yml`:各页面配置(文件名需与 `navigation.id` 对应)
- `navigation.yml`:仅在 `site.yml` 未提供 `navigation` 时回退使用(兼容旧版本;推荐迁移到 `site.yml`
## 配置示例
@@ -182,15 +202,20 @@ profile:
subtitle: "我收藏的精选网站"
description: "这是一个用于快速访问常用网站的个人导航页面。"
# 主题和样式设置
theme:
default: "light"
toggleIcon: true
# 字体配置
fonts:
title: "Roboto, sans-serif"
content: "Noto Sans SC, sans-serif"
title:
family: Roboto
weight: 600
source: google
subtitle:
family: Noto Sans SC
weight: 500
source: google
body:
family: Noto Sans SC
weight: 400
source: google
# 社交媒体链接
social: