GitBook UI

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

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

侧边栏

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

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

• 组织切换器 如果你属于多个组织，可以在这里查看并在它们之间切换。你也可以通过此菜单创建一个新组织。

• 通知 当你在评论或对话中被提及，或者你正在处理的空间中有重要活动时，你会收到一条 通知 来告诉你有哪些新内容。

• 提问或搜索 由 GitBook AI提供支持，你可以用自然语言提问，或在你组织中的不同空间和内容中搜索。

• 主页 主页可让你一目了然地查看团队正在处理的一切。查看未完成的变更请求、讨论和评论、最近的页面编辑等更多内容。

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

• 集成 GitBook 集成 增强你的内容，使你能够在页面中嵌入更多内容，或从其他应用向你的知识库添加信息。

• 文档站点 切换此部分以查看 文档站点 在你组织中的全部内容，并可一键跳转到其中一个。

• 空间 空间部分是你可以找到你在添加更多内容时创建的 集合 并在 空间 的地方。前往我们的 内容结构 部分了解更多。

• 设置 你会在侧边栏底部找到 个人设置 并在 组织设置 。在这里，你还可以切换明暗模式，或在需要时向我们的支持团队寻求帮助。

• 废纸篓 已删除的空间会出现在废纸篓中。你可以在七天内恢复它们——之后它们将被永久删除。

目录

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

默认情况下，目录会显示由空间组成的 页面、链接和组 列表。你可以在侧边栏右侧找到它。它仅适用于你当前正在查看的空间。

目录也是你可以查看和管理空间中 可复用内容 并在 文件 的地方。

在目录中的 页面 标签页中，你可以：

• 创建新的 页面 和子页面

• 创建 页面组

• 添加 外部链接

• 访问权限 操作菜单 ，用于单个页面。

在 资源库 标签页中，你可以：

• 查看并搜索空间中的可复用内容、变量、图片和文件

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

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

• 将资源库项目拖放到页面上

• 双击可重命名任何资源库项目

• 预览图片

• 管理并下载图片和文件

这里有一段简短视频，展示你可以使用目录做什么，尤其是资源库标签页：

如果你想让页面内容更突出，可以将目录暂时隐藏：把光标悬停在它旁边，然后点击出现的 隐藏 按钮 。要让它再次显示，将光标悬停在页面边缘附近，然后点击 显示 按钮 .

空间页眉

空间页眉位于编辑器顶部，提供适用于整个空间的选项。

空间页眉包含你当前正在查看的空间信息。它可让你执行诸如发布和分享空间、查看空间的评论和历史、配置 GitHub 或 GitLab 同步等内容来自定义并覆盖默认配置。

空间页眉是可适应的，并会根据你当前所在的空间和模式而变化。

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

如果你正在查看只读空间，由于实时编辑已被锁定，你需要打开一个新的变更请求来编辑页面内容。

变更请求中的空间页眉。

空间页眉包括：

• 空间表情符号或图标 你可以为你的空间选择一个表情符号或图标，帮助你在侧边栏中轻松识别它。

• 空间名称 空间的名称，会显示在侧边栏中，以及在你选择发布时显示在你的文档中。

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

• 操作菜单

  提供你空间的操作列表。类似于 页面操作，可用的空间操作会根据你当前所在的模式而不同。

• 概述 在查看变更请求时，此标签页会显示变更请求的标题和描述，以及参与者和审阅者。它还会显示所有更改和评论。

• 编辑器视图 在此视图中，你可以使用 GitBook 基于块的编辑器编辑你的内容。

• 更改视图 此视图 突出显示更改 ，使用差异视图展示在变更请求中所做的修改。这非常适合在合并变更请求并将更改上线之前审阅新内容。

• 预览 此视图可让你在合并变更请求之前快速预览你的内容。

• 协作者 当前正在查看你空间中某个页面的其他人的头像，带有彩色圆圈来显示他们的光标颜色。点击头像可跳转到他们当前正在查看的页面。

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

• 分享菜单 允许你发布并分享你的空间。你也可以通过此菜单邀请他人 协作 。

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

• GitBook Agent 与以下功能一起协作处理空间中的更改： GitBook Agent.

• 评论 请参见 评论和讨论 你和团队就该空间内容进行的交流。

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

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

• 编辑按钮 如果你的空间已发布，或者有人锁定了 实时编辑，则 编辑 按钮会出现在空间页眉中。它将创建一个新的 变更请求 以编辑内容。

站点页眉

站点页眉包含你当前正在查看的站点信息。它可让你执行诸如查看站点洞察、自定义站点、更改设置，以及以不同模式和屏幕尺寸预览站点等操作。你还可以配置集成并管理成员访问权限。

站点页眉包括：

• 站点名称 空间的名称，会显示在侧边栏中，以及在你选择发布时显示在你的文档中。

• 站点的面包屑导航 返回主文档站点界面的链接。

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

• 洞察 该 洞察面板 会为你提供关于你的站点及其表现的详细分析。

• 自定义 在这里你可以 自定义你的站点 ，添加你自己的标志、颜色、页眉链接等更多内容。

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

• 预览 预览标签页可让你快速查看已发布站点在浅色和深色模式下，在桌面端和移动端上的外观。

• 集成 该按钮会打开一个模态窗口，允许你安装并配置 集成 用于你的站点。

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

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

内容编辑器

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

编辑器是你空间的主要部分，你可以在 GitBook 中编写或插入内容。它支持多人协作，这意味着你和你的团队可以实时协作进行更改。

你可以插入 内容区块，输入 Markdown, 嵌入内容，并与他人协作进行更改。 GitBook Agent.

除了处理更改之外，你还可以对区块发表评论、标记队友等更多操作。

页面标题和描述

在每个页面顶部，你可以设置一个 标题，添加一个可选的 表情符号，并编写一个 描述。你使用的标题会显示在目录中，并在发布后构成你页面的 URL slug。

你的页面描述最长可达 200 个字符，并将作为页面在搜索引擎中的预览文本。

你可以通过选择 页面操作 > 重命名来更改页面的 URL slug。更多信息请见下方关于 页面操作 的内容。

页面操作菜单

页面的 操作菜单 允许你执行诸如复制、重命名或删除页面等操作。

你可以使用 操作菜单 打开 图标——该图标会在你将鼠标悬停于侧边栏中的页面时出现，或者通过页面标题旁边的图标来打开。

可用操作的类型将取决于你当前处于 实时编辑 模式还是 变更请求.

页面选项

该 页面选项 侧边栏提供文档和导航的自定义选项。

使用页面选项，你可以自定义文档布局和导航。只有在编辑模式下才能访问页面选项。

你可以使用 页面选项 侧边栏，方法是打开页面的 操作菜单 并选择 选项，或者将鼠标悬停在页面主标题上并在出现时点击 页面选项 。

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

页面大纲

页面大纲显示 H1 和 H2 标题，让你可以快速跳转到单个页面中的特定部分。

该 页面大纲 位于编辑器右侧，使你可以轻松直接跳转到你想查找的页面部分。

你添加到页面中的任何 标题 都会显示在这里列出的页面大纲中。

页面大纲也会显示在你发布的网站中。你可以在 页面选项 侧边栏

如果你看不到应用右侧的列，可能是因为你的浏览器窗口宽度小于 1430 像素。要查看和使用页面大纲，你的浏览器窗口宽度至少需要 1430 像素。