# GitBook UI

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

### 侧边栏

<div data-with-frame="true"><figure><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FMINl0qBtvGV3pt8G3bnZ%2FCleanShot%202025-12-10%20at%2010.02.40.png?alt=media&#x26;token=57f3871d-67b0-432e-b646-8b5e5a073aaa" alt=""><figcaption><p>GitBook 侧边栏包含你所有的文档，以及通知、搜索栏、片段等更多内容。</p></figcaption></figure></div>

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

* **组织切换器**\
  如果你属于多个组织，可以在这里查看并在它们之间切换。你也可以通过此菜单创建一个新组织。
* **通知**\
  当你在评论或对话中被提及，或者你正在处理的空间中有重要活动时，你会收到一条 [通知](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/collaboration/notifications) 来告诉你有哪些新内容。
* **提问或搜索**\
  由 [GitBook AI](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/creating-content/searching-your-content/gitbook-ai)提供支持，你可以用自然语言提问，或在你组织中的不同空间和内容中搜索。
* **主页**\
  主页可让你一目了然地查看团队正在处理的一切。查看未完成的变更请求、讨论和评论、最近的页面编辑等更多内容。
* **文档站点首页**\
  点击此处可访问你在组织中创建的所有文档站点的概览页面。
* **集成**\
  GitBook [集成](https://github.com/GitbookIO/public-docs/blob/main/content-editor/editor/broken-reference/README.md) 增强你的内容，使你能够在页面中嵌入更多内容，或从其他应用向你的知识库添加信息。
* **文档站点**\
  切换此部分以查看 [文档站点](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/publishing-documentation/publish-a-docs-site) 在你组织中的全部内容，并可一键跳转到其中一个。
* **空间**\
  空间部分是你可以找到你在添加更多内容时创建的 [集合](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/creating-content/content-structure/collection) 并在 [空间](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/creating-content/content-structure/space) 的地方。前往我们的 [内容结构](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/creating-content/content-structure) 部分了解更多。
* **设置**\
  你会在侧边栏底部找到 [个人设置](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/zhang-hu-guan-li/account-settings) 并在 [组织设置](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/zhang-hu-guan-li/organization-settings) 。在这里，你还可以切换明暗模式，或在需要时向我们的支持团队寻求帮助。
* **废纸篓**\
  已删除的空间会出现在废纸篓中。你可以在七天内恢复它们——之后它们将被永久删除。

### 目录 <a href="#the-table-of-contents" id="the-table-of-contents"></a>

<div data-with-frame="true"><figure><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FZYKSwnzcZOkqVA2xgRlX%2FCleanShot%202025-12-10%20at%2010.07.01.png?alt=media&#x26;token=47cb70e3-4cee-4fdd-8247-28a04e75f92e" alt=""><figcaption><p>目录列出了你所选空间中的所有页面和链接。</p></figcaption></figure></div>

默认情况下，目录会显示由空间组成的 [页面、链接和组](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/creating-content/content-structure/page#organizing-your-content) 列表。你可以在侧边栏右侧找到它。它仅适用于你当前正在查看的空间。

目录也是你可以查看和管理空间中 [可复用内容](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/creating-content/reusable-content) 并在 [文件](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/creating-content/blocks/insert-files) 的地方。

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

* 创建新的 [页面](#pages) 和子页面
* 创建 [页面组](#groups)
* 添加 [外部链接](#external-links)
* 访问权限 [操作菜单](#the-actions-menu) <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt=""></picture> ，用于单个页面。

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

* 查看并搜索空间中的可复用内容、变量、图片和文件
* 查看并插入来自其他空间的可复用内容
* 在资源库中创建或导入新项目
* 将资源库项目拖放到页面上
* 双击可重命名任何资源库项目
* 预览图片
* 管理并下载图片和文件

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

{% embed url="<https://youtu.be/gg-VZP2wl-I>" %}

如果你想让页面内容更突出，可以将目录暂时隐藏：把光标悬停在它旁边，然后点击出现的 **隐藏** 按钮 <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F0goJ97jfVBvH656kUK0d%2Fpanel%20left.svg?alt=media&#x26;token=cb31d43b-804c-4c4f-b5bb-e71db0d03860" alt="The Hide button icon in GitBook"></picture> 。要让它再次显示，将光标悬停在页面边缘附近，然后点击 **显示** 按钮 <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FwOFmEqy96fMvDPjqjAED%2Fpanel%20right.svg?alt=media&#x26;token=2f39279a-cd05-48a3-8985-d07ec08663ba" alt="The Show button icon in GitBook"></picture>.

### 空间页眉

<div data-with-frame="true"><figure><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F2Z5NSb3mmbMRoWqONncm%2FCleanShot%202025-12-10%20at%2010.08.48.png?alt=media&#x26;token=da8f53b3-d134-46e1-84d1-db3c1e1eb3cd" alt=""><figcaption><p>空间页眉位于编辑器顶部，提供适用于整个空间的选项。</p></figcaption></figure></div>

空间页眉包含你当前正在查看的空间信息。它可让你执行诸如发布和分享空间、查看空间的评论和历史、配置 [GitHub 或 GitLab 同步](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/getting-started/git-sync)等内容来自定义并覆盖默认配置。

{% hint style="info" %}
**空间页眉是可适应的**，并会根据你当前所在的空间和模式而变化。

例如，如果你正在编辑一个 [变更请求](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/collaboration/change-requests)，你将看到该变更请求的概览，以及打开编辑器、查看更改和合并变更请求的选项。

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

<div data-with-frame="true"><figure><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FrTr3IxB9SPupw4YedgqL%2FCleanShot%202025-12-10%20at%2010.11.01.png?alt=media&#x26;token=772809ef-1b4b-453f-9ce4-64883cfc292c" alt=""><figcaption><p>变更请求中的空间页眉。</p></figcaption></figure></div>

空间页眉包括：

* **空间表情符号或图标**\
  你可以为你的空间选择一个表情符号或图标，帮助你在侧边栏中轻松识别它。
* **空间名称**\
  空间的名称，会显示在侧边栏中，以及在你选择发布时显示在你的文档中。
* **空间的面包屑导航**\
  空间所在集合或文档站点的完整线性列表。
* **操作菜单** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FPnnI41SqLSaKBNwT98fW%2Factions-horizontal.svg?alt=media&#x26;token=99754200-a354-4ffe-931e-aa6322ea7395" alt="The Actions menu icon in GitBook"></picture>

  提供你空间的操作列表。类似于 [页面操作](#the-actions-menu)，可用的空间操作会根据你当前所在的模式而不同。
* **概述**\
  在查看变更请求时，此标签页会显示变更请求的标题和描述，以及参与者和审阅者。它还会显示所有更改和评论。
* **编辑器视图**\
  在此视图中，你可以使用 GitBook 基于块的编辑器编辑你的内容。
* **更改视图**\
  此视图 [突出显示更改](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/collaboration/change-requests#diff-mode) ，使用差异视图展示在变更请求中所做的修改。这非常适合在合并变更请求并将更改上线之前审阅新内容。
* **预览**\
  此视图可让你在合并变更请求之前快速预览你的内容。
* **协作者**\
  当前正在查看你空间中某个页面的其他人的头像，带有彩色圆圈来显示他们的光标颜色。点击头像可跳转到他们当前正在查看的页面。
* **Git 同步配置**\
  该 [GitHub 和 GitLab 同步](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/getting-started/git-sync) 你空间的配置。
* **分享菜单**\
  允许你发布并分享你的空间。你也可以通过此菜单邀请他人 [协作](https://github.com/GitbookIO/public-docs/blob/main/content-editor/editor/broken-reference/README.md) 。
* **变量**\
  [创建并添加可复用变量](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/creating-content/variables-and-expressions) 以便在空间中使用。
* **GitBook Agent**\
  与以下功能一起协作处理空间中的更改： [GitBook Agent](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/gitbook-agent).
* **评论**\
  请参见 [评论和讨论](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/collaboration/comments) 你和团队就该空间内容进行的交流。
* **变更请求**\
  创建、更新和删除 [变更请求](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/collaboration/change-requests) ，在你的空间中。
* **空间历史记录**\
  查看 [版本历史](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/creating-content/version-control) ，其中包含随时间在空间中——或在你当前变更请求中——所做的所有更改。
* **编辑按钮**\
  如果你的空间已发布，或者有人锁定了[ 实时编辑](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/collaboration/live-edits)，则 **编辑** 按钮会出现在空间页眉中。它将创建一个新的 [变更请求](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/collaboration/change-requests) 以编辑内容。

### 站点页眉 <a href="#site-headers" id="site-headers"></a>

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

站点页眉包括：

* **站点名称**\
  空间的名称，会显示在侧边栏中，以及在你选择发布时显示在你的文档中。
* **站点的面包屑导航**\
  返回主文档站点界面的链接。
* **概述**\
  站点概览会向你展示有关站点的关键信息，包括其 URL、发布状态、受众和内容，以及顶层洞察。
* **洞察**\
  该 [洞察面板](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/publishing-documentation/insights) 会为你提供关于你的站点及其表现的详细分析。
* **自定义**\
  在这里你可以 [自定义你的站点](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/publishing-documentation/customization) ，添加你自己的标志、颜色、页眉链接等更多内容。
* **设置**\
  访问你的 [站点设置](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/publishing-documentation/site-settings) 并控制名称、受众、内容结构和其他选项。
* **预览**\
  预览标签页可让你快速查看已发布站点在浅色和深色模式下，在桌面端和移动端上的外观。
* **集成**\
  该按钮会打开一个模态窗口，允许你安装并配置 [集成](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/ji-cheng/install-an-integration) 用于你的站点。
* **成员访问权限**\
  查看并管理谁可以在 GitBook 应用中访问你的站点，以及他们拥有哪些权限。
* **访问站点**\
  点击此处可立即在新标签页中打开你已发布的文档站点。此按钮仅在你的站点上线时出现。

### 内容编辑器

<div data-with-frame="true"><figure><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FxpmoPcLU6kfep6QsXlxi%2FCleanShot%202025-12-10%20at%2010.18.49.png?alt=media&#x26;token=af2b3315-f6e0-4a12-b853-1cbbd5e0e0e9" alt=""><figcaption><p>在 GitBook 编辑器中编写内容并添加区块。</p></figcaption></figure></div>

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

你可以插入 [内容区块](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/creating-content/blocks)，输入 [Markdown](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/creating-content/formatting/markdown), [嵌入内容](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/creating-content/blocks/embed-a-url)，并与他人协作进行更改。 [GitBook Agent](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/gitbook-agent).

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

### 页面标题和描述 <a href="#page-title" id="page-title"></a>

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

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

{% hint style="info" %}
你可以通过选择 **页面操作** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture> > **重命名**来更改页面的 URL slug。更多信息请见下方关于 [页面操作](#page-options) 的内容。
{% endhint %}

### 页面操作菜单

页面的 **操作菜单** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture> 允许你执行诸如复制、重命名或删除页面等操作。

你可以使用 **操作菜单** 打开 <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture> 图标——该图标会在你将鼠标悬停于侧边栏中的页面时出现，或者通过页面标题旁边的图标来打开。

{% hint style="info" %}
可用操作的类型将取决于你当前处于 [实时编辑](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/collaboration/live-edits) 模式还是 [变更请求](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/collaboration/change-requests).
{% endhint %}

### 页面选项

<div data-with-frame="true"><figure><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FquMiRmEYl2L5vg76GJWT%2FCleanShot%202025-12-10%20at%2010.24.19.png?alt=media&#x26;token=b29ba1c2-0f5f-4d35-9e40-dcc6a27165d3" alt=""><figcaption><p>该 <strong>页面选项</strong> 侧边栏提供文档和导航的自定义选项。</p></figcaption></figure></div>

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

你可以使用 **页面选项** 侧边栏，方法是打开页面的 **操作菜单** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture> 并选择 **选项**，或者将鼠标悬停在页面主标题上并在出现时点击 **页面选项** 。

{% hint style="info" %}
某些更改，例如禁用目录，仅适用于已发布的文档，在编辑器中可能不可见。
{% endhint %}

### 页面大纲

<div data-with-frame="true"><figure><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F29FlwGeQG1m2s6nQ8yBv%2FCleanShot%202025-12-10%20at%2010.26.57.png?alt=media&#x26;token=6b4e1658-1526-4089-bea4-5bfe5f5656e7" alt=""><figcaption><p>页面大纲显示 H1 和 H2 标题，让你可以快速跳转到单个页面中的特定部分。</p></figcaption></figure></div>

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

你添加到页面中的任何 [标题](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/creating-content/blocks/heading) 都会显示在这里列出的页面大纲中。

页面大纲也会显示在你发布的网站中。你可以在 [**页面选项**](#page-options) 侧边栏

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