# 页面

页面是您可以添加、编辑和嵌入内容的地方。页面始终位于一个 [空间](https://gitbook-v2-q67etdj25-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/creating-content/content-structure/space)中，让您能够将相关内容分组，并为您所涵盖的主题或领域创建不同的版块。

在发布您的文档时，每个空间都会成为自己独立的 [文档站点](https://gitbook-v2-q67etdj25-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/publishing-documentation/publish-a-docs-site) 或者 [站点版块](https://gitbook-v2-q67etdj25-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/publishing-documentation/site-structure/site-sections)，并且该空间中的所有页面都会显示在那个站点上。

### 目录

您可以在一个空间中创建任意多的页面。它们都会显示在屏幕左侧边栏中，位于您空间的 [目录](https://gitbook-v2-q67etdj25-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/zi-yuan/gitbook-ui#table-of-contents)里。发布您的空间后，目录也会出现在同一位置，除非 [您选择将其隐藏](#page-options).

{% hint style="info" %}

### 文档站点着陆页

目录中的第一页始终是您空间的着陆页，即使它在目录中被隐藏。
{% endhint %}

### 创建新页面

在 [实时编辑](https://gitbook-v2-q67etdj25-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/collaboration/live-edits) 模式或在 [变更请求](https://gitbook-v2-q67etdj25-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/collaboration/change-requests)中时，您可以通过点击 **添加新内容...** > **页面** 位于目录底部的按钮来创建新页面。或者，您也可以将鼠标悬停在目录中的页面之间，然后点击出现的 **+** 图标。

<figure><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FP0V046UJgzgtkrD1NiQG%2Fcreating-content-content-structure-page%402x%20(1).png?alt=media&#x26;token=69805dbf-4ce7-4a6b-ac4d-43fc958d62c4" alt="A GitBook screenshot showing an empty page listed in the table of contents"><figcaption><p>GitBook 中的空白页面。您可以在左侧的目录中看到它被列出。</p></figcaption></figure>

### 看不到创建新页面的选项？

{% hint style="warning" %}
如果 [实时编辑](https://gitbook-v2-q67etdj25-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/collaboration/live-edits) 已为您的空间禁用，您需要创建或编辑一个 [变更请求](https://gitbook-v2-q67etdj25-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/collaboration/change-requests)。一旦您进入变更请求， **新页面** 按钮（可让您创建页面、页面组和链接）就会在目录中可用。

或者，您可能没有正确的 [权限](https://gitbook-v2-q67etdj25-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/zhang-hu-guan-li/member-management/permissions-and-inheritance) 来编辑页面。
{% endhint %}

### 整理您的内容

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

#### 页面

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

您可以通过在目录中将一个页面拖放到另一个页面下方来嵌套页面。这样会创建一个 **子页面**.

如果您向空的父页面添加子页面，GitBook 会在文档的已发布版本中自动生成一个“内容”页面，并链接到所有子页面。

{% hint style="info" %}
**提示：** 页面嵌套没有限制，但我们建议不要超过三层嵌套，以避免导航过于复杂。
{% endhint %}

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

您可以随时通过点击打开页面的 **操作菜单** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture> 并选择 **编辑标题和 slug**.

#### **页面链接标题**

如果您希望页面拥有更长、更利于 SEO 的标题，同时在导航项和链接中保留较短的标题，您可以选择性地定义一个链接标题。

打开页面的 **操作菜单** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture> 并选择 **编辑标题和 slug**。在 **编辑页面** 对话框中，您会找到为该页面启用并定义链接标题的选项。

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

```markdown
# 目录

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

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

页面链接标题是可选的——如果您没有手动添加，它将默认使用页面的标准标题。

#### 页面组

通过页面组，您可以将页面汇集到覆盖相关内容的版块中。

您可以通过点击 **添加新内容...** > **组** 位于目录底部来创建新的页面组。

页面组只能位于目录的 **顶层** 。您不能在页面组内嵌套页面组。

要更改页面组的标题和 slug，请点击目录中组标题旁边的 **操作菜单** icon <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture> 并选择 **重命名**.

#### 外部链接 <a href="#external-links" id="external-links"></a>

您还可以向目录添加链接。点击它们会直接将用户带到链接的内容。

通过点击创建新的外部链接 **添加新内容...** > **外部链接** 位于目录底部来创建新的页面组。

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

为了提高读者在浏览目录时的可见性，您可以为单个页面添加可选的图标或表情符号。该图标或表情符号会显示在目录中，以及页面顶部标题旁边。

要添加图标或表情符号，请点击 **添加图标** 按钮（在鼠标悬停于页面标题时出现），或标题左侧的表情符号按钮。

### 页面选项

在 **页面选项** 菜单中，您可以自定义空间内所选页面的外观和感觉，并控制其可见性。

#### **布局**

你可以使用 **页面选项** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FAsao5RY8jwAmcYhpVwPI%2Foptions.svg?alt=media&#x26;token=d962d9a8-0cd6-42e7-a7b7-50c68a74dfea" alt="The Page options menu icon in GitBook"></picture> 菜单中，或者通过将鼠标悬停在页面标题上来更改页面封面。您会看到按钮出现在页面标题的正上方。

在 **页面选项** 侧边栏中，您可以选择每个页面向访问您 **已发布** 内容的用户显示的方式。有三种布局预设可供选择，或者您也可以创建自定义布局。

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

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

您可以从 **资源库** → **标签**中为页面添加一个或多个标签。启用 **在页面上显示标签** 即可在页面页眉中显示它们。您还可以选择一个标签作为页面的主标签。GitBook 可以将其显示在目录中的页面旁边。了解更多请参阅 [标签](https://gitbook-v2-q67etdj25-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/creating-content/content-structure/page/tags).

您也可以从此菜单设置页面的全局宽度。选择 **宽版** 会自动扩展支持 **全宽** 选项的区块——例如表格、卡片和代码块——在页面发布后为它们提供更多空间。这非常适合创建吸引眼球的着陆页！

#### 可见性

您可以决定在已发布的文档中显示/隐藏哪些页面，同时还可以决定是否要将该页面编入已发布文档的搜索索引，以及/或者被搜索引擎索引。

您可以通过打开页面的 **操作菜单** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture> 并切换 **隐藏页面**.

如果隐藏，在使用 Git Sync 时，markdown 文件的 front matter 中将显示以下内容：

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

#### 元数据（SEO）

使用 **页面选项 → 元数据** 用于控制搜索引擎如何理解相似页面之间的关系（例如：文档版本或 [内容变体](https://gitbook-v2-q67etdj25-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/publishing-documentation/site-structure/variants)).

* **规范 URL**：此页面首选的（权威的）URL。搜索引擎将其视为“真实来源”。当多个 URL 显示相同内容时，请使用它。
* **备用 URL**：同一内容在另一种变体中的其他 URL。例如，另一个版本或语言。它们有助于搜索引擎将不同变体归为一组，而不是将它们视为重复内容。

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

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

### 页面封面

您还可以为文档的每个页面设置页面封面。当您点击 **页面封面** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FI1Q5rfhHgy0toM2pUEH5%2Fimage.svg?alt=media&#x26;token=a3cf4181-880b-4698-9a1b-1a99f48bb03b" alt="The Page cover icon in GitBook"></picture> 选项时，会立即添加一个默认封面。在这里，您可以：

* **更改封面图片**

  将鼠标悬停在页面封面上并点击 **更改封面**，然后选择或上传一张图片。根据我们当前的页面封面显示方式，1990x480 像素是理想尺寸。
* **重新定位封面图片**

  将鼠标悬停在页面封面上并打开 **操作菜单** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture>。点击 **重新定位**，然后按需拖动图片并点击 **保存**.
* **移除封面图片**\
  将鼠标悬停在页面封面上并打开 **操作菜单** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture>，然后点击 **移除**.
* **全宽和英雄宽度**\
  您可以更改页面封面的样式，使其横跨整个屏幕宽度，或仅与内容宽度一致。将鼠标悬停在页面封面上并打开 **操作菜单** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture>，然后从菜单中选择您偏好的选项。
