页面

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

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

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

目录

您可以在一个空间中创建任意数量的页面。它们都在屏幕左侧的空间的 目录中可见。除非 您选择隐藏它.

文档站点着陆页

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

创建新页面

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

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

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

组织您的内容

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

页面

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

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

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

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

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

您可以随时通过点击打开页面的 操作菜单 The Actions menu icon in GitBook 并选择 重命名.

页面组

通过页面组,您可以将页面聚合到覆盖相关内容的各个部分中。

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

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

要更改页面组的标题和 slug,请点击目录中组标题旁的 操作菜单 图标 The Actions menu icon in GitBook 并选择 重命名.

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

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

页面图标和表情符号

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

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

页面选项

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

布局

您可以打开 页面选项 The Page options menu icon in GitBook 菜单或通过将鼠标悬停在页面标题上来更改页面封面。您会在页面标题上方看到这些按钮出现。

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

每个布局预设将切换页面以下各部分的显示与否:

  • 页面标题

  • 页面描述

  • 目录

  • 页面大纲

  • 上一页/下一页 链接

  • 页面元数据

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

可见性

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

您可以通过打开页面的 操作菜单 The Actions menu icon in GitBook 并切换 隐藏页面.

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

page.md
---
hidden: true
---

页面封面

您还可以为文档的每个页面设置页面封面。当您点击 页面封面 The Page cover icon in GitBook 选项时,将立即添加一个默认封面。从这里,您可以:

  • 更改封面图片

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

  • 重新定位封面图片

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

  • 移除封面图片 将鼠标悬停在页面封面上并打开 操作菜单 The Actions menu icon in GitBook,然后点击 移除.

  • 全宽和英雄宽度 您可以更改页面封面的样式,使其横跨屏幕的全宽或仅为内容宽度。将鼠标悬停在页面封面上并打开 操作菜单 The Actions menu icon in GitBook,然后从菜单中选择您偏好的选项。

最后更新于

这有帮助吗?