使用 Studio
编辑页面
在 Studio 中编辑页面正文、元数据、状态与可见性。
编辑页面不只是写正文,还要一起决定 slug、描述、标签、状态,以及它是否应该被导航引用。
Steps
- 在正确语言下选择目标页面
- 编辑正文
- 补齐元数据
- 决定发布状态
- 决定是否接入导航
在正确语言下选择目标页面
先确认当前语言,再从页面列表中选择目标页面。如果你在双语项目中工作,不要默认另一种语言页面会自动同步内容。
编辑正文
在中间编辑器中使用当前开放的文档型块写内容,例如标题、段落、列表、代码、提示框、表格、图片、链接和 Mermaid。需要新增块时使用 `/` 菜单;需要调整顺序时使用块拖拽手柄。
补齐元数据
在右侧面板填写 `title`、`description`、`slug` 和 `tags`。其中 `slug` 会决定 reader 路径,并且必须在同一语言内保持唯一。
决定发布状态
把页面留在 `draft`、推进到 `in_review`,或者切到 `published`。只有 `published` 页面才会进入公开阅读站、搜索索引、`llms.txt` 和 `mcp/` 产物。
决定是否接入导航
如果页面应该被读者从站点中发现,再把它接入导航树。导航引用影响可发现性;发布状态影响它是否进入公开产物,这两件事不要混为一谈。
保存行为: 通过 Studio 编辑后,页面内容和元数据会写回 `pages/<lang>/` 下对应页面文件。
未接导航不等于未发布: 一个页面即使没有放进导航,也可能在已发布状态下通过直接 URL 被访问。真正的公开边界仍然是页面状态,而不是导航是否引用它。