# 页面页面是你可以添加、编辑和嵌入内容的地方。页面始终位于一个 [空间](/docs/documentation/zh/creating-content/content-structure/space.md)中，让你能够对相关内容进行分组，并为你所涵盖的主题或领域创建不同的部分。当你发布文档时，每个空间都会成为一个独立的 [文档站点](/docs/documentation/zh/docs-site/publish-a-docs-site.md) 或 [网站部分](/docs/documentation/zh/docs-site/site-structure/site-sections.md)，空间中的所有页面都会显示在该站点上。 ### 目录你可以在一个空间中创建所需数量的页面。它们都会显示在你空间的屏幕左侧边栏中的 [目录](/docs/documentation/zh/zi-yuan/gitbook-ui.md#table-of-contents)里。目录会在你发布空间时出现在同一位置，除非 [你选择隐藏它](#page-options). {% hint style="info" %} #### Docs 站点落地页目录中的第一页始终是你空间的落地页，即使它在目录中被隐藏。 {% endhint %} ### 创建新页面在 [实时编辑](/docs/documentation/zh/collaboration/live-edits.md) 模式或在一个 [更改请求](/docs/documentation/zh/collaboration/change-requests.md)中时，你可以通过点击 **添加新的...** > **页面** 在目录底部创建新页面。或者，你也可以将鼠标悬停在目录中的页面之间并点击出现的 **+** 图标。

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

### 看不到创建新页面的选项？ {% hint style="warning" %} 如果 [实时编辑](/docs/documentation/zh/collaboration/live-edits.md) 对你的空间已被禁用时，你需要创建或编辑一个 [更改请求](/docs/documentation/zh/collaboration/change-requests.md)。一旦你进入变更请求， **新页面** 按钮（可让你创建页面、页面组和链接）就会在目录中可用。或者，你可能没有正确的 [权限](/docs/documentation/zh/collaboration/member-management/permissions-and-inheritance.md) 来编辑页面。 {% endhint %} ### 组织你的内容在目录中组织内容有三种方式： #### 页面页面包含标题、可选描述，以及一个你可以编写和添加任何类型内容的区域。你可以通过在目录中将一个页面拖放到另一个页面下方来嵌套页面。这样会创建一个 **子页面**. 如果你向一个空的父页面添加子页面，GitBook 会自动生成一个“contents”页面，其中包含发布后的文档中所有子页面的链接。 {% hint style="info" %} **提示：** 页面嵌套没有限制，但我们建议不要超过三层嵌套，以避免导航过于复杂。 {% endhint %} 当你更改页面标题时，页面的 slug（URL 最末尾的部分，例如 `/hello-world`）也会随之更改——除非你之前已手动设置过页面的 slug。你可以随时通过点击打开页面的 **操作菜单**

并选择 **编辑标题和 slug**. #### **页面链接标题** 如果你希望页面拥有更长、更利于 SEO 的标题，同时为导航条目和链接保留较短的标题，你可以选择性地定义一个链接标题。打开页面的 **操作菜单**

并选择 **编辑标题和 slug**。在 **编辑页面** 对话框后，你会找到启用并为该页面定义链接标题的选项。如果你使用 Git Sync，页面链接标题会在页面链接上的 `SUMMARY.md` 文件中设置： ```markdown # 目录 * [页面主标题](page.md "页面链接标题") ``` {% hint style="info" %} **注意：** 页面链接标题会用于目录、每个页面底部的分页按钮，以及你添加到该页面的任何相对链接中。 {% endhint %} 页面链接标题是可选的——如果你不手动添加，默认会使用页面的标准标题。 #### 页面组通过页面组，你可以将页面组合成涵盖相关内容的部分。你可以通过点击 **添加新的...** > **组** 在目录底部创建新的页面组。页面组只能位于目录的 **顶层** 。你不能在页面组内嵌套页面组。要更改页面组的标题和 slug，请点击目录中组标题旁边的 **操作菜单** icon

并选择 **重命名**. #### 外部链接你还可以在目录中添加链接。点击它们会将用户直接带到链接的内容。通过点击创建新的外部链接 **添加新的...** > **外部链接** 在目录底部创建新的页面组。 ### 页面图标和表情符号为了提高读者在浏览目录时的可见性，你可以为单个页面添加可选图标或表情符号。图标或表情符号会显示在目录中，以及页面顶部标题旁边。要添加图标或表情符号，请点击 **添加图标** 按钮（将鼠标悬停在页面标题上时出现），或标题左侧的表情符号按钮。 ### 页面选项在 **页面选项** 菜单中，你可以自定义空间内所选页面的外观和可见性。 #### **布局** 你可以打开 **页面选项**

菜单中，或将鼠标悬停在页面标题上以更改页面封面。你会看到按钮出现在页面标题正上方。在 **页面选项** 侧边面板中，你可以选择每个页面向访问你的 **已发布** 内容的用户如何显示。有三种布局预设可选，或者你也可以创建自定义布局。每种布局预设都会切换以下页面部分的显示或隐藏： * 页面标题 * 页面描述 * 目录 * 页面大纲 * 上一页/下一页链接 * 页面元数据 * 标签你可以从 **资源库** → **标签**中为页面添加一个或多个标签。打开 **在页面上显示标签** 以在页面页眉中显示它们。你还可以选一个标签作为页面的主标签。GitBook 可以在目录中的页面旁显示它。了解更多请参见 [标签](/docs/documentation/zh/creating-content/content-structure/page/tags.md). 你还可以在此菜单中设置页面的全局宽度。选择 **宽屏** 会让表格、卡片和代码块等内容在页面发布后拥有更多空间。这非常适合创建引人注目的落地页。 #### 可见性你可以决定在已发布的文档中想显示/隐藏哪些页面，同时也可以决定是否希望该页面被纳入已发布文档的搜索索引，和/或被搜索引擎索引。你可以通过打开页面的 **操作菜单**

并切换 **隐藏页面**. 如果隐藏，在使用 Git Sync 时，markdown 文件的 front matter 中会显示以下内容：

---
hidden: true
---

#### 元数据（SEO）使用 **页面选项 → 元数据** 以控制搜索引擎如何理解相似页面之间的关系（例如：文档版本或 [内容变体](/docs/documentation/zh/docs-site/site-structure/variants.md)). * **规范 URL**：该页面首选的（权威）URL。搜索引擎会将其视为“真实来源”。当多个 URL 显示相同内容时，请使用它。 * **备用 URL**：同一内容在另一变体中的其他 URL。例如，另一个版本或语言。它们有助于搜索引擎对不同变体进行分组，而不是将其视为重复内容。这两个字段都支持选择另一个 GitBook 页面（推荐）或输入外部 URL。 {% hint style="info" %} 版本化文档的常见做法是将旧页面规范到最新的对应页面（例如， `1.0` → `2.0`），然后在最新页面上将旧版本列为备用版本。 {% endhint %} ### 页面封面你还可以为文档中的每个页面设置封面。当你点击 **页面封面**

选项时，系统会立即添加一个默认封面。从这里你可以： * **更改封面图片** 将鼠标悬停在页面封面上并点击 **更改封面**，然后选择或上传一张图片。根据我们当前显示页面封面的方式，1990x480 像素是理想尺寸。 * **重新定位封面图片** 将鼠标悬停在页面封面上并打开 **操作菜单**

。点击 **重新定位**，然后按需拖动图片，最后点击 **保存**. * **移除封面图片**\ 将鼠标悬停在页面封面上并打开 **操作菜单**

然后点击 **移除**. * **全宽和英雄宽度**\ 你可以将页面封面的样式改为横跨屏幕全宽，或者只覆盖内容宽度。将鼠标悬停在页面封面上并打开 **操作菜单**

，然后从菜单中选择你偏好的选项。 --- # Agent Instructions: 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: ``` GET https://gitbook.com/docs/documentation/zh/creating-content/content-structure/page.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.