页面
添加页面、页面组或外部链接 — 并了解每个页面的可用选项
页面是您可以添加、编辑和嵌入内容的地方。页面始终位于一个 空间内,允许您将相关内容分组并为所涵盖的主题或领域创建不同部分。
在发布文档时,每个空间将成为其自己的 文档站点 或 站点部分,该空间内的页面都会显示在该站点上。
目录
您可以在一个空间中创建任意多的页面。它们都会在屏幕左侧的空间 目录中可见。当您发布空间时,目录将出现在同一位置,除非 您选择将其隐藏.
创建新页面
当处于 实时编辑 模式或在一个 变更请求中时,您可以通过点击创建新页面 添加新项... > 页面 在目录底部。或者,您可以在目录中悬停于页面之间并点击出现的 + 图标。
看不到创建新页面的选项?
组织您的内容
在目录中有三种方式来组织您的内容:
页面
页面有标题、可选描述以及用于撰写和添加任何类型内容的区域。
您可以通过在目录中将页面拖放到另一个页面下方来嵌套页面。这样会创建一个 子页面.
如果您向一个空的父页面添加子页面,GitBook 会在发布的文档版本中自动生成一个“目录”页面,其中包含指向所有子页面的链接。
当您更改页面标题时,页面的 slug(即 URL 最末部分,例如 /hello-world
)也会更改——除非您之前手动设置过页面的 slug。
您可以随时通过打开页面的 操作菜单 并选择 重命名.
页面组
使用页面组,您可以将页面聚合为涵盖相关内容的部分。
您可以通过点击目录底部的 添加新项... > 组 来创建新的页面组。
页面组只能存在于 目录的顶层 。您不能在页面组内嵌套页面组。
要更改页面组的标题和 slug,请点击目录中组标题旁的 操作菜单 图标 并选择 重命名.
外部链接
您也可以向目录添加链接。点击它们会直接将人们带到链接的内容。
通过点击创建新的外部链接 添加新项... > 外部链接 来创建新的页面组。
页面图标与表情符号
为了在浏览目录时提高读者的可见性,您可以为单个页面添加可选的图标或表情符号。图标或表情符号会出现在目录中,并在页面顶部的标题旁显示。
要添加图标或表情符号,请在悬停页面标题时点击 添加图标 按钮,或点击标题左侧的表情符号按钮。
页面选项
在 页面选项 菜单中,您可以自定义空间内所选页面的外观和感觉,并控制其可见性。
布局
您可以通过在页面标题上悬停打开 页面选项 菜单或更改页面封面。您会看到按钮出现在页面标题的正上方。
在 页面选项 在侧面面板中,您可以选择每个页面对访问您 已发布的 内容的显示方式。有三个布局预设可供选择,或您可以创建自定义布局。
每个布局预设将打开或关闭页面的以下各部分:
页面标题
页面描述
目录
页面大纲
上一页/下一页 链接
页面元数据
您还可以从此菜单设置页面的全局宽度。选择 宽屏 将自动为支持 全宽 选项的块(例如表格、卡片和代码块)加宽——这样在发布页面时可为它们提供更多空间。非常适合创建引人注目的着陆页!
可见性
您可以决定在已发布的文档中显示/隐藏哪些页面,同时决定是否希望该页面被包含在已发布文档的搜索索引中和/或被搜索引擎索引。
您可以通过打开页面的 操作菜单 并切换 隐藏页面.
如果隐藏,则在使用 Git 同步时,以下内容将出现在 markdown 文件的 front matter 中:
---
hidden: true
---
页面封面
您还可以为文档的每个页面设置页面封面。当您点击 页面封面 选项时,会立即添加一个默认封面。从这里,您可以:
更改封面图片
将鼠标悬停在页面封面上并点击 更改封面,然后选择或上传一张图片。根据我们当前显示页面封面的方式,1990x480 像素是理想尺寸。
重新定位封面图片
将鼠标悬停在页面封面上并打开 操作菜单
。点击 重新定位,然后按需拖动图片并点击 保存.
移除封面图片 将鼠标悬停在页面封面上并打开 操作菜单
,然后点击 移除.
全宽与横幅宽度 您可以更改页面封面的样式,使其横跨屏幕的全宽或仅与内容宽度一致。将鼠标悬停在页面封面上并打开 操作菜单
,然后从菜单中选择您偏好的选项。
最后更新于
这有帮助吗?