> 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. 点击 **页面**.

或者将鼠标悬停在目录中两个页面之间，然后点击 **+** 出现的图标。

<figure><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-5cc5b5fc280644f7b8306f511df7bfd022fa2f77%2F25_12_10_creating_content_content_structure_page%402x.png?alt=media" alt="A GitBook screenshot showing an empty page listed in the table of contents"><figcaption><p>GitBook 中的空白页面。您可以在左侧的目录中看到它列出。</p></figcaption></figure>

### 缺少“新页面”选项

{% hint style="warning" %}
如果分区已禁用实时编辑，请创建或编辑变更请求。在变更请求中，目录里会显示 **新建页面** 按钮，可用于创建页面、页面组和链接。

您也可能没有编辑页面的权限。
{% endhint %}

### 整理您的内容

在目录中组织内容有三种方式：

#### 页面

页面有标题、可选描述，以及一个可供您编写并添加任何类型内容的区域。

在目录中拖放页面，将其放到另一个页面下方，即可嵌套页面。这样会创建一个 **子页面**.

如果您向一个空的父页面添加子页面，GitBook 会在文档已发布版本中自动生成一个“目录”页面，其中包含指向所有子页面的链接。

{% hint style="info" %}
**提示：** 页面嵌套层级没有限制，但为简化导航，建议不要超过三级。
{% endhint %}

更改页面标题时，页面的 slug（URL 最末尾的部分，例如 `/hello-world`）也会随之更改，除非您之前手动设置过页面的 slug。

已发布页面的 URL 遵循导航树，而不是您的 Git Sync 文件结构。它包含顶级部分或组的 slug、每个上级页面或组的 slug，以及页面自身的 slug。

例如，以下 Git Sync 文件结构：

```
content/
└── setup/
    └── install.md
```

可以对应这样的导航树：

```
API
└── Guides
    └── Install
```

如果 slug 分别为 `api`, `guides`和 `install`，则发布后的 URL 为 `/api/guides/install`。文件路径不会决定 URL。

要更改页面的标题、链接标题或 slug：

1. 打开页面的 **操作菜单** <picture><source srcset="broken://files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-aabbca522107ef561981bdfe5af94605b31e0920%2F25_01_10_actions_icon_light.svg?alt=media" alt="The Actions menu icon in GitBook"></picture>.
2. 点击 **编辑标题和 slug**.

#### 页面链接标题

如果您想为页面设置一个更长、对 SEO 友好的标题，同时为导航项和链接保留较短的标题，请定义链接标题。

1. 打开页面的 **操作菜单** <picture><source srcset="broken://files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-aabbca522107ef561981bdfe5af94605b31e0920%2F25_01_10_actions_icon_light.svg?alt=media" alt="The Actions menu icon in GitBook"></picture>.
2. 点击 **编辑标题和 slug**.
3. 在 **编辑页面** 对话框中，启用并设置该页面的链接标题。

如果您使用 Git Sync，请在 `SUMMARY.md` 中的页面链接上设置页面链接标题：

```markdown
# 目录

* [页面主标题](page.md "页面链接标题")
```

{% hint style="info" %}
**注意：** 页面链接标题会显示在目录中、每个页面底部的分页按钮上，以及您添加到该页面的所有相对链接中。
{% endhint %}

页面链接标题是可选的——如果您不添加，页面将使用其标准标题。

#### 页面组

页面组会将相关页面聚合到某个部分的目录中。您可以为每个页面组添加一个图标。

如果你使用 Git Sync，请在 `SUMMARY.md`:&#x20;

{% code title="" lineNumbers="true" expandable="true" %}

```markdown
* [其他页面](other-page.md)

## 页面组

* [页面](page-group/page.md)
* [另一页面](page-group/another-page.md)

***

* [后续页面](subsequent-pages.md)
```

{% endcode %}

该标题之后的每个顶级链接都属于此页面组，直到遇到下一个页面组标题或 `***` 分隔符。

{% hint style="info" %}
页面组用于整理一个分区中的页面。分区组用于整理网站导航中的分区。虽然两者都称为“组”，但它们是不同的对象。请参阅 [组](https://gitbook.com/docs/documentation/zh/chuang-jian-nei-rong/content-structure/collection.md).
{% endhint %}

点击目录底部的 **添加新内容...** > **组** 。

页面组仅位于目录的 **顶级** 位置 — 你不能将页面组嵌套在其他页面组中，也不能将其嵌套在其他页面内。

页面组有一个 slug，该组中的所有页面都会嵌套在此 slug 下。用户访问页面组的 URL 时，会跳转到该组中的第一个页面。

{% hint style="warning" %}
页面组的 slug 会成为其所有子页面 URL 的一部分。添加、重命名或删除页面组都会更改子页面的 URL，并导致现有链接失效，除非您添加重定向。请参阅 [站点重定向](https://gitbook.com/docs/documentation/zh/publish/site-redirects.md).
{% endhint %}

要更改页面组的标题、slug 或图标：

1. 点击 **操作菜单** 图标 <picture><source srcset="broken://files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-aabbca522107ef561981bdfe5af94605b31e0920%2F25_01_10_actions_icon_light.svg?alt=media" alt="The Actions menu icon in GitBook"></picture> 在目录中的分组标题旁边。
2. 点击 **重命名**.
3. 更新标题、slug 或图标。

{% hint style="warning" %}
`SUMMARY.md` 不会存储页面分组图标。图标由 GitBook 存储，而 Git Sync 不会往返同步这些图标。如果仓库重新创建了一个页面分组，GitBook 不会自动恢复原来的图标。请在 GitBook 中重新设置图标。
{% endhint %}

#### 外部链接

向目录添加链接，让人们直接跳转到关联内容。

点击 **添加新项...** > **外部链接** 即可在目录底部创建外部链接。

### 页面图标和表情符号

为了让读者在快速浏览目录时更容易识别，可为单个页面添加可选图标或表情符号。图标或表情符号会显示在目录中，以及页面顶部标题旁边。

要添加图标或表情符号，请点击悬停在页面标题上时显示的 **添加图标** 按钮，或点击标题左侧的表情符号按钮。

### 页面选项

在 **页面选项** 菜单中，可以自定义所选分区内页面的外观，并控制其可见性。

#### 布局

打开 **页面选项** <picture><source srcset="broken://files/tb21SaZbz1g0fv6lzP83" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-29cf0a5f1fe3ae9efdec72f491acfa9fd308ce45%2F25_01_10_options_icon_light.svg?alt=media" alt="The Page options menu icon in GitBook"></picture> 菜单，或将鼠标悬停在页面标题上以更改页面封面。按钮会显示在页面标题上方。

在 **页面选项** 侧边栏中，可以选择每个页面向 **已发布** 内容的访客呈现的方式。你可以选择三种预设布局之一，也可以创建自定义布局。

每种布局预设都会开启或关闭页面的以下部分：

* 页面标题
* 页面描述
* 目录
* 页面大纲
* 下一页/上一页链接
* 页面元数据
* 标签

通过 **资源库** → **标签**为页面添加一个或多个标签。开启 **在页面上显示标签** ，即可在页面标题中显示这些标签。你也可以选择一个标签作为页面的主标签，GitBook 可以在目录中的页面旁显示该标签。了解详情，请参阅“标签”。

你也可以在此菜单中设置页面的全局宽度。选择 **宽** 可为已发布页面中的表格、卡片和代码块等内容提供更多空间。适用于打造引人注目的落地页。

#### 可见性

选择在已发布文档中显示或隐藏哪些页面，以及每个页面是否会出现在站点搜索和搜索引擎中。

要从站点目录中隐藏页面或页面组：

1. 打开页面的 **操作菜单** <picture><source srcset="broken://files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-aabbca522107ef561981bdfe5af94605b31e0920%2F25_01_10_actions_icon_light.svg?alt=media" alt="The Actions menu icon in GitBook"></picture>.
2. 切换 **隐藏页面**.

隐藏页面仅会从已发布的目录中隐藏。仍可通过站点的 MCP 服务器以及 `llms-full.txt`.

如果您使用 Git Sync，隐藏页面会在 Markdown 文件中包含以下 front matter：

<pre class="language-markdown" data-title="page.md"><code class="lang-markdown">---
hidden: true
<strong>---
</strong></code></pre>

{% hint style="warning" %}
中访问这些页面。隐藏 **页面标题** 或 **页面描述** 只会隐藏已发布内容中的页面标题区域，不会移除页面正文中的标题。了解标题级别的更多信息，请参阅“标题”。
{% endhint %}

#### 元数据（SEO）

使用 **页面选项 → 元数据** 控制搜索引擎如何理解相似页面之间的关系（例如，文档版本或内容变体）。

* **规范 URL**：此页面首选的（权威）URL。搜索引擎会将其视为“可信来源”。当多个 URL 显示相同内容时，请使用此设置。
* **替代 URL**：同一内容其他变体对应的 URL，例如其他版本或语言。这有助于搜索引擎将不同变体归为一组，而不是将其视为重复内容。

这两个字段都支持选择另一个 GitBook 页面（推荐）或输入外部 URL。

{% hint style="info" %}
版本化文档的一种常见做法是，将旧页面的规范 URL 设为最新对应页面（例如， `1.0` → `2.0`），然后在最新页面上将旧版本列为替代版本。
{% endhint %}

#### 在部分之间移动页面

GitBook 目前不支持在应用中在部分之间移动单个页面。要将某个页面的内容移动到另一个部分：

* **复制并粘贴** — 使用 `Esc` 键选择页面内容，然后将其复制并粘贴到目标位置。某些内容块可能需要重新配置；评论和页面历史记录不会复制，图片也需要在新分区中重新上传。
* **使用 Git Sync** — 如果两个分区都与代码库同步，请在代码库之间复制文件，并将页面标题添加到目标分区的 `SUMMARY.md`。请参阅 [Git Sync](https://gitbook.com/docs/documentation/zh/docs-as-code/git-sync.md).

### 页面封面

为文档中的每个页面设置封面。点击 **页面封面** <picture><source srcset="broken://files/m3pW0fk37zO88JKWr4U5" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-e5c00215e1a33fe1d6ca1f6682185a6cf5ab71d6%2F25_01_10_image_icon_light.svg?alt=media" alt="The Page cover icon in GitBook"></picture> 选项后，GitBook 会立即添加默认封面。理想的封面图片尺寸为 1990 × 480 像素。封面会锁定为此宽高比，以便在不同屏幕尺寸下保持相同比例。你可以：

* **更改封面图片**
  1. 将鼠标悬停在页面封面上，然后点击 **更换封面**.
  2. 选择或上传图片。理想尺寸为 1990 × 480 像素。
* **重新定位封面图片**
  1. 将鼠标悬停在页面封面上，然后打开 **操作菜单** <picture><source srcset="broken://files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-aabbca522107ef561981bdfe5af94605b31e0920%2F25_01_10_actions_icon_light.svg?alt=media" alt="The Actions menu icon in GitBook"></picture>.
  2. 点击 **重新定位**.
  3. 拖动图片以调整位置，然后点击 **保存**.
* **移除封面图片**
  1. 将鼠标悬停在页面封面上，然后打开 **操作菜单** <picture><source srcset="broken://files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-aabbca522107ef561981bdfe5af94605b31e0920%2F25_01_10_actions_icon_light.svg?alt=media" alt="The Actions menu icon in GitBook"></picture>.
  2. 点击 **移除**.
* **全宽和主视觉宽度**

  更改页面封面的样式，使其横跨整个屏幕宽度或仅占内容宽度。

  1. 将鼠标悬停在页面封面上，然后打开 **操作菜单** <picture><source srcset="broken://files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-aabbca522107ef561981bdfe5af94605b31e0920%2F25_01_10_actions_icon_light.svg?alt=media" alt="The Actions menu icon in GitBook"></picture>.
  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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://gitbook.com/docs/documentation/zh/chuang-jian-nei-rong/content-structure/page.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
