> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/zh/chuang-jian-nei-rong/content-structure/page.md). # 页面页面是你可以添加、编辑和嵌入内容的地方。页面始终位于某个章节中，使你能够按你所涵盖的主题或领域将相关内容分组。当你发布站点后，每个章节都会出现在站点导航中，而其中的所有页面都会显示在该章节下方。 ### 目录在一个章节中，你可以根据需要创建任意多的页面。它们都会显示在你屏幕左侧边栏的该章节目录中。目录会以相同的位置显示在你已发布的站点上，除非 [你选择将其隐藏](#page-options). {% hint style="info" %} **章节首页** 目录中的第一个页面始终是该章节的首页，即使它在目录中被隐藏。 {% endhint %} ### 创建新页面 1. 进入实时编辑模式或打开一个变更请求。 2. 点击 **添加新内容...** 在目录底部。 3. 点击 **页面**. 或者，将鼠标悬停在目录中页面之间，然后点击 **+** 出现的图标。

A GitBook screenshot showing an empty page listed in the table of contents — GitBook 中的空白页面。你可以在左侧的目录中看到它被列出。

### 缺少新页面选项 {% hint style="warning" %} 如果你的章节已禁用实时编辑，请创建或编辑一个变更请求。在变更请求中， **新页面** 按钮——用于创建页面、页面组和链接——可在目录中使用。你也可能没有编辑页面的权限。 {% endhint %} ### 组织你的内容在目录中组织内容有三种方式： #### 页面页面包含标题、可选描述，以及一个可供你编写并添加任何类型内容的区域。通过将一个页面拖放到目录中另一个页面下方来嵌套页面。这样会创建一个 **子页面**. 如果你向一个空的父页面添加子页面，GitBook 会在你文档已发布版本中自动生成一个带有所有子页面链接的“目录”页面。 {% hint style="info" %} **提示：** 页面嵌套没有限制，但为了保持导航简洁，建议不要超过三层。 {% endhint %} 当你更改页面标题时，页面的 slug（URL 最末端的部分，例如 `/hello-world`）也会随之更改——除非你之前已手动设置过该页面的 slug。要更改页面的标题、链接标题或 slug： 1. 打开页面的 **操作菜单**

. 2. 点击 **编辑标题和 slug**. #### 页面链接标题如果你想为页面设置一个更长、对 SEO 友好的标题，同时在导航项和链接中保留较短标题，请定义一个链接标题。 1. 打开页面的 **操作菜单**

. 2. 点击 **编辑标题和 slug**. 3. 在 **编辑页面** 对话框，启用并为该页面定义链接标题。如果你正在使用 Git Sync，请在 `SUMMARY.md` 页面链接上： ```markdown # 目录 * [页面主标题](page.md "页面链接标题") ``` {% hint style="info" %} **注意：** 页面链接标题会显示在目录中、每个页面底部的分页按钮中，以及你添加到该页面的任何相对链接中。 {% endhint %} 页面链接标题是可选的——如果你不添加，它会使用页面的标准标题。 #### 页面组页面组会在章节的目录中将相关页面集中在一起。 {% hint style="info" %} 页面组用于组织 **页面** 在单个章节内。要组织 **部分中** 你的网站，请改用分组。 {% endhint %} 通过点击以下内容来创建页面组 **添加新内容...** > **分组** 在目录底部。页面组只能位于 **顶层** 的目录——你不能将页面组彼此嵌套。要更改页面组的标题和 slug： 1. 点击 **操作菜单** 图标

位于目录中的组标题旁边。 2. 点击 **重命名**. #### 外部链接向目录添加链接，可将用户直接带到链接内容。通过点击以下内容创建外部链接 **添加新内容...** > **外部链接** 在目录底部。 ### 页面图标和表情符号为了在读者浏览目录时提高可见性，可为单个页面添加可选图标或表情符号。该图标或表情符号会显示在目录中，以及页面顶部标题旁边。要添加图标或表情符号，请点击 **添加图标** 按钮（当鼠标悬停在页面标题上时），或标题左侧的表情符号按钮。 ### 页面选项在 **页面选项** 菜单，自定义所选章节中某个页面的外观与风格，并控制其可见性。 #### 布局打开 **页面选项**

菜单，或者将鼠标悬停在页面标题上来更改页面封面。按钮会出现在页面标题正上方。在 **页面选项** 侧边栏，选择每个页面在你的网站访客面前的显示方式 **已发布** 内容。可选择三种布局预设，或者你也可以创建自定义布局。每种布局预设都会切换页面中的以下部分显示或隐藏： * 页面标题 * 页面描述 * 目录 * 页面大纲 * 上一页/下一页链接 * 页面元数据 * 标签使用来自以下来源的一个或多个标签为页面添加标签 **资料库** → **标签**. 开启 **在页面上显示标签** 以在页面标题中显示它们。或者选择一个标签作为页面的主标签，GitBook 可以将其显示在目录中页面旁边。有关详细信息，请参阅标签。也可在此菜单中设置页面的全局宽度。选择 **宽版** 可为表格、卡片和代码块等区块在已发布页面上提供更多空间。适合用于吸睛的着陆页。 #### 可见性选择在已发布文档中显示或隐藏哪些页面，以及每个页面是否会出现在你网站的搜索中和搜索引擎中。要在你网站的目录中隐藏某个页面或一组页面： 1. 打开页面的 **操作菜单**

. 2. 切换 **隐藏页面**. 隐藏的页面仅会从已发布的目录中隐藏。它们仍可通过网站的 MCP 服务器以及在 `llms-full.txt`. 如果你正在使用 Git Sync，隐藏页面会在 Markdown 文件中包含以下 front matter：

---
hidden: true
---

{% hint style="warning" %} 隐藏 **页面标题** 或者 **页面描述** 只会隐藏已发布内容中的页面标题。它不会移除页面正文内的标题。有关标题层级的更多信息，请参阅标题。 {% endhint %} #### 元数据（SEO）使用 **页面选项 → 元数据** 用于控制搜索引擎如何理解相似页面之间的关系（例如：文档版本或内容变体）。 * **规范 URL**：此页面的首选（权威）URL。搜索引擎会将其视为“真实来源”。当多个 URL 显示相同内容时使用它。 * **备用 URL**：其他变体中相同内容的其他 URL。例如，另一个版本或语言。它们有助于搜索引擎对变体进行分组，而不是将其视为重复内容。这两个字段都支持选择另一篇 GitBook 页面（推荐）或输入外部 URL。 {% hint style="info" %} 版本化文档的常见做法是将较旧的页面设置为指向最新的对应页面作为规范页面（例如， `1.0` → `2.0`），然后在最新页面上列出较旧版本作为备用页面。 {% endhint %} #### 在章节之间移动页面 GitBook 目前不支持在应用中将单个页面在章节之间移动。要将页面内容移动到另一个章节： * **复制并粘贴** ——选中页面内容时按 `Esc` 键，然后将其复制并粘贴到目标位置。某些区块可能需要重新配置；评论和页面历史不会被复制，图片需要在新章节中重新上传。 * **使用 Git Sync** ——如果两个章节都与仓库同步，请在仓库之间复制文件，并将页面标题添加到目标的 `SUMMARY.md`。参见 [Git Sync](/docs/documentation/zh/wen-dang-ji-dai-ma/git-sync.md). ### 页面封面为文档的每个页面设置页面封面。点击 **页面封面**

选项时，GitBook 会立即添加默认封面。理想的封面图片尺寸为 1990 × 480 像素——封面会固定为此宽高比，因此在不同屏幕尺寸下比例保持不变。在这里，你可以： * **更改封面图片** 1. 将鼠标悬停在页面封面上，然后点击 **更改封面**. 2. 选择或上传一张图片。理想尺寸为 1990x480 像素。 * **重新定位封面图片** 1. 将鼠标悬停在页面封面上，然后打开 **操作菜单**

. 2. 点击 **重新定位**. 3. 将图片拖动到合适位置，然后点击 **保存**. * **移除封面图片** 1. 将鼠标悬停在页面封面上，然后打开 **操作菜单**

. 2. 点击 **移除**. * **全宽和英雄区宽度** 更改页面封面的样式，使其横跨整个屏幕宽度，或仅与内容宽度一致。 1. 将鼠标悬停在页面封面上，然后打开 **操作菜单**

. 2. 点击你偏好的选项。 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://gitbook.com/docs/documentation/zh/chuang-jian-nei-rong/content-structure/page.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.