核心概念
导航树
了解导航树的数据结构、节点类型和维护约束。
导航树定义了 reader 侧边栏的层级结构。它按语言分别存放,并且其中的页面引用必须能解析到现有 pageId。
节点类型
Anydocs 当前支持四种导航节点类型。
- `section`:分组节点,可包含子节点
- `folder`:文件夹节点,可包含子节点
- `page`:页面引用节点,指向一个现有 `pageId`
- `link`:外部链接节点,跳转到站外 URL
按语言存放
导航文件位于 `navigation/<lang>.json`。每个启用语言都需要自己的导航文件,reader 会按当前语言读取对应结构。
维护方式
你可以在 Studio 中可视化维护导航,也可以通过 MCP 导航工具进行创建、插入、移动、删除和整棵树替换。
- Studio 适合日常拖拽和人工整理
- MCP 适合 agent 或批量操作
- 删除导航节点不会自动删除对应页面文件