sidebarGitBook 界面(UI)

了解 GitBook 编辑器中不同的组件和界面

GitBook 被划分为不同的部分,以便更轻松地组织和管理您创建的内容。

侧边栏

GitBook 侧边栏包含您所有的文档,以及通知、搜索栏、片段等内容。

侧边栏可让您一目了然地查看和概览您的 GitBook 组织。侧边栏包含:

  • 组织切换器 如果您属于多个组织,您可以在此查看并切换它们。您也可以从此菜单创建新组织。

  • 通知 当您在评论或对话中被标记,或您正在使用的空间中有重要活动时,您会收到一条 通知 来显示有哪些新内容。

  • 询问或搜索 由以下提供技术支持 GitBook AI,您可以用自然语言提问,或在组织中的不同空间和内容中进行搜索。

  • 主页 首页可让您一目了然地查看团队正在进行的所有工作。查看未结的变更请求、讨论和评论、最近的页面编辑等。

  • 文档站点主页 点击此处可访问您在组织中创建的所有文档站点的概览页面。

  • 集成 GitBook 集成arrow-up-right 可增强您的内容,允许您在页面中嵌入更多内容,或将其他应用中的信息添加到您的知识库中。

  • 文档站点 切换此部分以在侧边栏中查看所有 文档站点 并单击即可跳转到其中一个。

  • 空间 空间部分是您创建更多内容时会找到 集合空间 的位置。前往我们的 内容结构 部分以了解更多信息。

  • 设置 您会在侧边栏底部找到 个人设置组织设置 。在这里,您还可以切换浅色/深色模式,或在需要时向我们的支持团队寻求帮助。

  • 回收站 已删除的空间将显示在回收站中。您可以在最多七天内恢复它们——之后它们将被永久删除。

目录

目录列出所选空间中的所有页面和链接。

默认情况下,目录显示由 页面、链接和分组 组成的空间列表。您会在侧边栏的右侧找到它。它针对您当前查看的空间。

目录也是您可以查看和管理 可重用内容文件 的地方,适用于您的空间。

页面 选项卡的目录中,您可以:

选项卡中,您可以:

  • 查看并在空间中搜索可重用内容、变量、图像和文件

  • 查看并插入来自其他空间的可重用内容

  • 在库中创建或导入新项目

  • 将库项目拖放到页面上

  • 双击以重命名任何库项目

  • 预览图像

  • 管理并下载图像和文件

这里有一个简短视频,展示了您可以使用目录(尤其是库选项卡)执行的操作:

如果您想更多地关注页面内容,您可以将光标悬停在目录旁并单击出现的 隐藏 按钮 The Hide button icon in GitBook 以临时隐藏目录。要使其再次出现,请将光标悬停在页面边缘附近并单击 显示 按钮 The Show button icon in GitBook.

空间头部

空间头部位于编辑器顶部,提供适用于整个空间的选项。

空间头部包含有关您当前正在查看的空间的信息。它让您执行诸如发布和共享空间、查看该空间的评论和历史记录、配置 GitHub 或 GitLab 同步等操作。

circle-info

空间头部是可适应的,并会根据您当前所在的空间和模式而变化。

例如,如果您正在编辑一个 变更请求,您将看到变更请求的概览,以及打开编辑器、查看更改和合并变更请求的选项。

如果您正在查看只读空间,您需要打开新的变更请求来编辑页面内容,因为实时编辑已被锁定。

变更请求内的空间头部。

空间头部包括:

  • 空间表情或图标 您可以为空间选择表情或图标,以帮助您在侧边栏中轻松识别它。

  • 空间名称 将在侧边栏中显示的空间名称,以及在您选择发布文档时出现在文档中的名称。

  • 空间的面包屑 包含该空间所在集合或文档站点的完整线性列表。

  • 操作菜单 The Actions menu icon in GitBook

    为您的空间提供操作列表。与 页面操作类似,空间可用的操作将取决于您当前所在的模式。

  • 概览 在查看变更请求时,此选项卡显示变更请求的标题和描述,以及参与者和审阅者。它还显示所有更改和评论。

  • 编辑器视图 此视图是您可以使用 GitBook 的基于区块的编辑器对内容进行编辑的地方。

  • 更改视图 此视图 突出显示更改 在差异视图中显示变更请求中的更改。这非常适合在合并变更请求将更改发布到线上之前审查新内容。

  • 预览 此视图允许您在合并变更请求之前快速查看内容预览。

  • 协作者 任何其他当前正在查看您空间中页面的人的头像,会有彩色圆圈显示他们的光标颜色。单击头像可跳转到他们当前查看的页面。

  • Git 同步配置 您空间的 GitHub 和 GitLab 同步 配置。

  • 共享菜单 允许您发布和共享您的空间。您也可以通过此菜单邀请其他人 协作arrow-up-right

  • 变量 创建并添加可重用变量 以在空间中使用。

  • GitBook 代理 与他人协作处理空间中的更改,使用 GitBook 代理.

  • 评论 查看您和团队就空间内容进行的 评论和讨论

  • 变更请求 在您的空间中创建、更新和删除 变更请求

  • 空间历史 查看 版本历史 ,其中包含随时间在空间中或您当前的变更请求中所做的所有更改。

  • 编辑按钮 如果您的空间已发布,或有人锁定了 实时编辑,则 编辑 按钮将出现在空间头部。它将创建一个新的 变更请求 以编辑内容。

站点头部

站点头部包含有关您当前查看的站点的信息。它让您执行诸如查看站点洞察、定制站点、更改其设置以及在不同模式和屏幕尺寸下预览站点等操作。您还可以配置集成并管理成员访问权限。

站点头部包括:

  • 站点名称 将在侧边栏中显示的空间名称,以及在您选择发布文档时出现在文档中的名称。

  • 站点的面包屑 返回主文档站点屏幕的链接。

  • 概览 站点概览向您展示有关站点的关键信息,包括其 URL、发布状态、受众和内容,以及顶层洞察。

  • 洞察 您空间的 洞察面板 为您提供有关站点及其表现的详细分析。

  • 自定义 在此您可以 自定义您的站点 ,包括自己的徽标、颜色、头部链接等更多内容。

  • 设置 访问您的 站点设置 并控制名称、受众、内容结构和其他选项。

  • 预览 预览选项卡可让您快速查看已发布站点在桌面和移动显示中以浅色和深色模式下的呈现效果。

  • 集成 该按钮打开一个模态,允许您为站点安装和配置 集成 集成。

  • 成员访问 在 GitBook 应用中查看并管理谁可以访问您的站点以及他们拥有什么权限。

  • 访问站点 单击此处可在新标签页中立即打开您已发布的文档站点。仅当站点已上线时此按钮才会出现。

内容编辑器

在 GitBook 编辑器中撰写内容并添加区块。

编辑器是您空间的主要部分,您可以在其中使用 GitBook 撰写或插入内容。它支持多人协作,这意味着您和团队可以实时协作处理更改。

您可以插入 内容区块、输入 Markdown, 嵌入内容,并与他人协作处理更改。 GitBook 代理.

除了处理更改,您还可以对区块发表评论、标记队友等。

页面标题和描述

在每个页面的顶部,您可以设置一个 标题,添加一个可选的 表情,并撰写一个 描述。您使用的标题将出现在目录中,并在发布后构成页面的 URL slug。

您的页面描述最多可为 200 个字符,并将在搜索引擎中作为页面的预览文本显示。

circle-info

您可以通过选择更改页面的 URL slug: 页面操作 The Actions menu icon in GitBook > 重命名。在下面了解更多相关信息。 页面操作 页面操作菜单

页面的

允许您执行诸如复制、重命名或删除页面等操作。 操作菜单 The Actions menu icon in GitBook 您可以使用出现在侧边栏中将鼠标悬停在页面上时的

图标打开 操作菜单 ,或从页面标题旁的图标打开它。 The Actions menu icon in GitBook 可用操作的类型将取决于您是在

circle-info

实时编辑 模式还是 一种 变更请求.

页面选项

您空间的 页面选项 侧面板为您的文档和导航提供自定义选项。

通过页面选项,您可以自定义文档布局和导航。只有在编辑模式下您才能访问页面选项。

图标打开 页面选项 通过打开页面的 操作菜单 The Actions menu icon in GitBook 并选择 选项,或将鼠标悬停在页面主标题上并在出现时单击 页面选项 来打开侧面板。

circle-info

某些更改,例如禁用目录,仅适用于已发布的文档,并且在编辑器中可能不可见。

页面大纲

页面大纲显示 H1 和 H2 标题,允许您快速跳转到单个页面的特定部分。

您空间的 页面大纲 位于编辑器的右侧,使您可以轻松直接跳转到所需的页面部分。

任何您添加到页面的 标题 都将出现在此处列出的页面大纲中。

页面大纲也会出现在您已发布的站点中。您可以在 页面选项 侧面板

circle-info

中打开或关闭它。 如果您看不到应用的右侧列,可能是因为您的浏览器窗口宽度小于 1430 像素。您的浏览器窗口需要至少 1430 像素宽才能查看和使用页面大纲。

最后更新于

这有帮助吗?