fix: 补齐书签 subgroups 渲染并对齐 README
- 修复 subgroups 生成但不展示的问题(模板渲染 + 前端结构导出) - 更新 README:配置示例/完全替换策略/多层级说明与 helper 文档,减少重复说明
This commit is contained in:
@@ -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:
|
||||
|
||||
Reference in New Issue
Block a user