Docs 支持任意层级的目录嵌套,每一层都可以有自己的 _meta.json。
以当前项目为例:
src/content/ ├── _meta.json ← 第 1 层:控制顶级分类 ├── index.mdx ├── grammar/ │ ├── _meta.json ← 第 2 层:控制 grammar 下的文档 │ ├── markdown.md │ └── ... ├── system/ │ ├── _meta.json ← 第 2 层:控制 system 下的文档 │ ├── linux.md │ └── ... ├── agent/ │ ├── _meta.json ← 第 2 层:控制 agent 下的子分类 │ ├── claude-code/ │ │ ├── _meta.json ← 第 3 层:控制 claude-code 下的文档 │ │ └── wsl2-cc.md │ └── hermes-agent/ │ ├── _meta.json ← 第 3 层:控制 hermes-agent 下的文档 │ ├── wsl2-hermes.md │ └── hermes-feishu.md └── local/ └── _meta.json ← 第 2 层:控制 local 下的文档
content/_meta.json 控制侧边栏最外层的分类入口:
侧边栏会依次显示"语法基础"、"操作系统"、"智能体"、"本地部署"、"运营"五个顶级入口。
以 agent/_meta.json 为例,它控制"智能体"分类下的子项:
{ "hermes-agent": "Hermes Agent", "openclaw": "OpenClaw", "claude-code": "Claude Code"}这里的键 hermes-agent 和 claude-code 是目录名,openclaw 也是目录名。它们在侧边栏中作为可展开的子分类显示。
对于只包含文档文件不包含子目录的分类,如 system/_meta.json:
这里的键都是 .md 文件名(不含扩展名),侧边栏直接显示为文档链接。
agent/hermes-agent/_meta.json 控制子分类下的具体文档: