GitBook 界面

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

GitBook 被划分为不同的部分,以便于组织和管理你创建的内容。

侧边栏

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

侧边栏允许你一目了然地查看和概览你的 GitBook 组织。侧边栏包含:

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

  • 通知 当你在评论或讨论中被提及,或你正在工作的空间有重要活动时,你会收到一个 通知 来告诉你有什么新内容。

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

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

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

  • 集成 GitBook 集成 能为你的内容提供强大功能,允许你在页面中嵌入更多内容,或从其他应用向你的知识库添加信息。

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

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

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

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

目录

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

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

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

页面 标签中的目录你可以:

图库 标签中,你可以:

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

  • 查看并从其他空间插入可重用内容

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

  • 将库项目拖放到页面上

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

  • 预览图片

  • 管理并下载图片和文件

这里有一个简短视频,展示了你可以用目录做什么,特别是图库标签:

如果你想更多地关注页面内容,你可以通过将光标移到目录旁并点击出现的 隐藏 按钮 The Hide button icon in GitBook 来临时隐藏目录。要再次显示它,将光标停在页面边缘附近并点击 显示 按钮 The Show button icon in GitBook.

空间头部

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

空间头部包含关于你当前查看空间的信息。它允许你执行例如发布和共享空间、查看该空间的评论和历史、配置 GitHub 或 GitLab 同步等操作。

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

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

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

变更请求内的空间头部。

空间头部包括:

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

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

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

  • 操作菜单 The Actions menu icon in GitBook

    为你的空间提供一系列操作。类似于 页面操作,空间可用的操作将根据你当前的模式而有所不同。

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

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

  • 更改视图 此视图 突出显示变更 在变更请求中使用差异视图所做的更改。这对于在合并变更请求并将更改推送为线上内容之前审查新内容非常理想。

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

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

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

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

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

  • GitBook 代理 与以下一起在空间中协作更改 GitBook 代理.

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

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

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

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

站点头部

站点头部包含关于你当前查看站点的信息。它允许你执行例如查看站点洞察、定制站点、更改其设置并在不同模式和屏幕尺寸下预览站点。你也可以配置集成并管理成员的访问权限。

站点头部包括:

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

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

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

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

  • 定制 在这里你可以 自定义你的站点 ,使用你自己的徽标、颜色、头部链接等更多内容。

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

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

  • 集成 该按钮打开一个模态窗口,让你为站点安装和配置 集成

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

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

内容编辑器

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

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

你可以插入 内容区块,输入 Markdown, 嵌入内容,并与以下协作进行更改 GitBook 代理.

除此之外,你还可以对区块进行评论、@ 同事以及更多操作。

页面标题和描述

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

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

你可以通过选择来更改页面的 URL slug 页面操作 The Actions menu icon in GitBook > 重命名。在下文了解更多关于 页面操作 的信息。

页面操作菜单

页面的 操作菜单 The Actions menu icon in GitBook 允许你执行例如复制、重命名或删除页面等操作。

你可以使用出现在侧边栏中将鼠标悬停在页面上时的 操作菜单 图标 The Actions menu icon in GitBook 或页面标题旁的图标来打开

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

页面选项

你空间的 页面选项 侧边面板为你的文档和导航提供定制选项。

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

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

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

页面大纲

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

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

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

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

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

最后更新于

这有帮助吗?