使用 Studio
管理导航
按真实 Studio 行为维护导航,而不是把导航当成页面文件管理器。
导航维护的目标,是让 reader 的结构、页面状态和语言版本保持一致。当前 Studio 更接近“按语言维护一棵发布导向导航树”:页面节点引用页面本身,分组节点组织结构,链接节点跳到外部地址。不要把导航操作和页面发布操作混为一件事。
Steps
- 先确认当前维护的是哪种语言导航
- 在 section 或 group 下新增页面、分组或外链
- 用 Move Up / Move Down 调整顺序
- 区分“移除导航引用”和“下线页面”
先确认当前维护的是哪种语言导航
导航是按语言分别保存的。进入导航编辑前,先确认你当前在维护 `zh` 还是 `en`,因为写入位置分别是 `navigation/zh.json` 和 `navigation/en.json`。一个语言里新增的分组或链接,不会自动出现在另一个语言导航里。
在 section 或 group 下新增页面、分组或外链
当前 Studio 支持三种常见新增动作:新增页面、新增分组、新增外链。新增页面时会先创建页面,再把该页面引用插入当前分组;新增分组会创建一个可继续容纳子节点的 `folder`;新增外链需要显示标题和 URL。页面节点本身显示的是页面标题,不是独立的导航标题编辑器。
用 Move Up / Move Down 调整顺序
当前导航维护以顺序移动为主,而不是任意拖拽。节点顺序会直接影响 reader 侧边栏展示顺序。分组节点可以继续容纳子节点;页面和链接节点本身不能再挂子项。
区分“移除导航引用”和“下线页面”
删除一个导航节点,只是把它从当前语言导航里拿掉,不等于删除页面文件。若要真正让页面从公开 reader、搜索和 AI 产物里消失,还要单独把页面状态改回 `draft` / `in_review`,或者直接删除页面。反过来,一个页面即使还留在导航里,只要不是 `published`,公开 reader 里也不会出现。
节点类型: 导航 contract 支持 `section`、`folder`、`page`、`link` 四类节点。Studio 常把 `folder` 叫做 group。
页面节点不是页面本体: 导航里的 page 节点只是对 `pageId` 的引用,不是页面内容副本。改导航不会自动改正文,改正文也不会自动重排导航。