页面

添加页面、页面组或外部链接 — 并了解每个页面可用的选项

页面是您可以添加、编辑和嵌入内容的地方。页面始终位于一个 空间，允许您将相关内容分组并为您所涵盖的主题或领域创建不同的部分。

在发布您的文档时，每个空间将成为其自己的 文档站点 或 站点分区，空间内的页面都会出现在该站点上。

目录

您可以在一个空间中根据需要创建任意多的页面。它们都会显示在您屏幕左侧边栏的空间 目录中。发布空间时，目录将显示在同一位置，除非 您选择将其隐藏.

文档站点着陆页

即使在目录中被隐藏，目录中的第一页面始终是您空间的着陆页。

创建新页面

当处于 实时编辑 模式或在一个 变更请求中，您可以通过点击创建新页面 添加新内容... > 页面 在目录底部。或者，您也可以在目录中将鼠标悬停在页面之间，然后点击出现的 + 图标。

GitBook 中的空白页面。您可以在左侧的目录中看到它的列出项。

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

如果被拒绝， 实时编辑 已在您的空间中禁用，您需要创建或编辑一个 变更请求。一旦您进入变更请求， 新页面 按钮（允许您创建页面、页面组和链接）将在目录中可用。

或者，您可能没有正确的 权限 来编辑页面。

组织您的内容

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

页面

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

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

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

提示： 页面嵌套没有限制，但我们建议避免超过三级嵌套，以免导航过于复杂。

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

您可以随时通过点击打开页面的 操作菜单 并选择 编辑标题与 slug.

页面链接标题

如果您希望页面在 SEO 上使用更长的标题，同时在导航条目和链接中保持较短的标题，您可以选择定义一个链接标题。

打开页面的 操作菜单 并选择 编辑标题与 slug。在 编辑页面 对话框中，您会找到启用并为该页面定义链接标题的选项。

如果您使用 Git 同步，页面链接标题是在 SUMMARY.md 文件的页面链接中设置的：

# 目录

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

注意： 页面链接标题用于目录、每页底部的分页按钮以及您在该页面添加的任何相对链接中。

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

页面组

使用页面组，您可以将页面聚合为涵盖相关内容的部分。

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

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

要更改页面组的标题和 slug，请点击目录中组标题旁边的 操作菜单 图标 并选择 重命名.

外部链接

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

通过点击创建新的外部链接 添加新内容... > 外部链接 。

页面图标和表情符号

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

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

页面选项

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

布局

您可以使用出现在侧边栏中将鼠标悬停在页面上时显示的 页面选项 菜单或通过将鼠标悬停在页面标题上更改页面的封面。您会看到按钮显示在页面标题上方。

在 页面选项 在侧面面板中，您可以选择访客查看您的 发布 内容时每个页面的显示方式。有三种布局预设可供选择，或者您可以创建自定义布局。

每个布局预设将切换页面下列各部分的开启或关闭：

• 页面标题

• 页面描述

• 目录

• 页面大纲

• 上一页/下一页 链接

• 页面元数据

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

可见性

您可以决定在已发布的文档中显示/隐藏哪些页面，同时决定是否希望该页面被包含在已发布文档的搜索索引中，和/或被搜索引擎索引。

您可以通过打开页面的 操作菜单 并切换 隐藏页面.

如果隐藏，则在使用 Git 同步时，以下内容将出现在该 Markdown 文件的 front matter 中：

page.md

---
hidden: true
---

元数据（SEO）

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

• 规范 URL：该页面的首选（权威）URL。

• 备用 URL：以不同变体表示相同内容的其他页面。

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

针对有版本的文档，一个常见做法是将旧版本页面的规范设置为最新的等价页面（例如， 1.0 → 2.0），然后在最新页面上将旧版本列为备用。

页面封面

您还可以为文档的每个页面设置页面封面。点击 页面封面 选项时，会立即添加一个默认封面。从这里，您可以：

• 更改封面图片

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

• 重新定位封面图片

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

• 移除封面图片 将鼠标悬停在页面封面上并打开 操作菜单 ，然后点击 移除.

• 全宽和主视觉宽度 您可以更改页面封面的样式，使其跨越屏幕的全宽或仅为内容宽度。将鼠标悬停在页面封面上并打开 操作菜单 ，然后从菜单中选择您偏好的选项。