页面

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

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

在发布文档时，每个空间都会成为其自己的 文档站点 或 站点部分，空间内的页面都会显示在该站点上。

目录

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

文档站点着陆页

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

创建新页面

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

GitBook 中的空页面。你可以在左侧的目录中看到它被列出。

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

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

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

组织你的内容

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

页面

页面有标题、可选的描述和一个你可以在其中撰写并添加任何类型内容的区域。

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

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

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

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

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

页面链接标题

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

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

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

# 目录

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

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

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

页面组

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

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

页面组只能存在于目录的 顶层 。你不能将页面组嵌套在页面组内。

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

外部链接

你也可以将链接添加到你的目录中。点击它们将直接带人们到所链接的内容。

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

页面图标和表情符号

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

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

页面选项

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

布局

你可以打开 页面选项 菜单或通过将鼠标悬停在页面标题上更改页面的封面。你会看到按钮出现在页面标题的正上方。

在 页面选项 侧边面板中，你可以选择每个页面对访问你 已发布 内容的访客如何显示。有三种布局预设可供选择，或者你可以创建自定义布局。

每个布局预设将切换以下页面部分的显示或隐藏：

• 页面标题

• 页面描述

• 目录

• 页面大纲

• 上一页/下一页 链接

• 页面元数据

• 标签

你可以从 库 → 标签中为页面添加一个或多个标签。开启 在页面上显示标签 以在页面头部显示它们。你也可以选择一个标签作为页面的主要标签。GitBook 可以将其显示在目录中的页面旁。更多信息请参见 标签.

你还可以从此菜单设置页面的全局宽度。选择 加宽 将自动扩展支持 全宽 选项的块——例如表格、卡片和代码块——以在页面发布时为它们提供更多空间。这对于创建引人注目的着陆页很理想！

可见性

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

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

来从站点的目录中隐藏一个页面或一组页面。

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

---
page.md
---

hidden: true

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

• 内容变体）。

• 规范 URL：该页面首选（权威）URL。搜索引擎将其视为“事实来源”。当多个 URL 显示相同内容时使用它。

备用 URL

：相同内容在另一个变体中的其他 URL。例如，另一版本或语言。它们帮助搜索引擎将变体分组，而不是将其视为重复内容。 1.0 → 2.0这两个字段都支持选择另一个 GitBook 页面（推荐）或输入外部 URL。

版本化文档的常见做法是将旧页面设为规范指向最新的相应页面（例如，

），然后在最新页面上将旧版本列为备用。 页面封面 你也可以为文档的每个页面设置页面封面。当你点击

• 页面封面

  选项时，会立即添加一个默认封面。从这里，你可以： 更改封面图片将鼠标悬停在页面封面上并点击

• 更改封面

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

• ，然后按你的需要拖动图片并点击 ，然后选择或上传一张图片。根据我们当前显示页面封面的方式，1990x480 像素是理想尺寸。 操作菜单 保存 移除封面图片.

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