用 .config.yml 配置目录级侧边栏导航。
目录导航
除了单篇 Markdown 的 frontmatter,你还可以在每个内容目录下放一个 .config.yml 文件,对整个目录做配置。
目录级导航
# content/docs/guide/.config.yml
navigation:
label: 指南
icon: book
description: 上手指南合集| 字段 | 类型 | 说明 |
|---|---|---|
navigation.title | string | 该目录在侧边栏的分组标题。 |
navigation.label | string | 备用标签。 |
navigation.description | string | 分组描述。 |
navigation.icon | string | 图标标识(由你的导航组件解释)。 |
navigation.hidden | boolean | 隐藏整个目录分组,子项也不显示。 |
navigation.flatten | boolean | 把子项提升到父级,不再生成这一层分组。 |
hidden:隐藏分组
navigation:
hidden: true目录从侧边栏消失,但目录内的页面仍可通过 URL 直接访问。
flatten:展开层级
navigation:
flatten: true子页面会被提升到上一级,不再单独出现「目录分组 → 子项」的两层结构,适合不想多一层嵌套的场景。