> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/zh/zi-yuan/gitbook-ui.md).

# GitBook 界面

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

### 侧边栏

<div data-with-frame="true"><figure><img src="/files/77c4b0a8cc8cfd378985f6a1ad8260b1bb333567" alt=""><figcaption><p>GitBook 侧边栏包含你的全部文档，以及通知、搜索栏、代码片段等更多内容。</p></figcaption></figure></div>

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

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

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

<div data-with-frame="true"><figure><img src="/files/ef9702f6af59143ce3a845b22f4dbc832ea05b3e" alt=""><figcaption><p>目录列出了你所选空间中的所有页面和链接。</p></figcaption></figure></div>

默认情况下，目录会显示一列 [页面、链接和组](/docs/documentation/zh/creating-content/content-structure/page.md#organizing-your-content) ，这些构成了一个空间。你会在侧边栏右侧找到它。它仅对应你当前正在查看的空间。

目录也是你查看和管理 [可复用内容](/docs/documentation/zh/creating-content/reusable-content.md) 和 [文件](/docs/documentation/zh/creating-content/blocks/insert-files.md) 的地方。

在 **页面** 目录中的选项卡下，你可以：

* 创建新的 [页面](#pages) 和子页面
* 创建 [页面组](#groups)
* 添加 [外部链接](#external-links)
* 访问 [操作菜单](#the-actions-menu) <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="/files/d05670ba93b683794fb3fe95a9fc7ab5c7fceafd" alt=""></picture> ，用于单个页面。

在 **资源库** 选项卡中，你可以：

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

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

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

如果你想让页面内容更突出，可以将光标悬停在目录旁边并点击出现的 **隐藏** 按钮 <picture><source srcset="/files/t7RZoZXBNdmA75mANdIQ" media="(prefers-color-scheme: dark)"><img src="/files/027f402722db0ea9be1ef86d283cd7748cae81d4" alt="The Hide button icon in GitBook"></picture> 。要再次显示它，请将光标悬停在页面边缘附近并点击 **显示** 按钮 <picture><source srcset="/files/Vxv06rO6ZJQJWLfW9YHZ" media="(prefers-color-scheme: dark)"><img src="/files/17f52278dc1924185de789e547495d4ce71301f2" alt="The Show button icon in GitBook"></picture>.

### 空间标题栏

<div data-with-frame="true"><figure><img src="/files/fb1dafbef773482f3a1811c91ec6710fc971510e" alt=""><figcaption><p>空间标题栏位于编辑器顶部，提供适用于整个空间的选项。</p></figcaption></figure></div>

空间标题栏包含你当前查看的空间信息。它让你可以发布并分享你的空间、查看空间的评论和历史记录、配置 [GitHub 或 GitLab 同步](/docs/documentation/zh/getting-started/git-sync.md)等更多设置。

{% hint style="info" %}
**空间标题栏具有适应性**，并会根据你当前所在的空间和模式而变化。

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

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

<div data-with-frame="true"><figure><img src="/files/14482194f5442e478fe0b383243a6b9162d8e8b0" alt=""><figcaption><p>变更请求中的空间标题栏。</p></figcaption></figure></div>

空间标题栏包含：

* **空间表情符号或图标**\
  你可以为你的空间选择一个表情符号或图标，方便在侧边栏中快速识别。
* **空间名称**\
  空间的名称，会显示在侧边栏中；如果你选择发布，也会显示在你的文档中。
* **空间的面包屑导航**\
  该空间所在集合或文档站点的完整线性列表。
* **操作菜单** <picture><source srcset="/files/HXFvPsjDqbaBEhpH0WKJ" media="(prefers-color-scheme: dark)"><img src="/files/950d2c0e21d4aa4c603de07a2bc5d827c0d5cbde" alt="The Actions menu icon in GitBook"></picture>

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

### 站点标题栏 <a href="#site-headers" id="site-headers"></a>

站点标题栏包含你当前查看的站点信息。它让你可以查看站点洞察、自定义站点、更改设置，并以不同模式和屏幕尺寸预览站点。你还可以配置集成并管理成员权限。

站点标题栏包含：

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

### 内容编辑器

<div data-with-frame="true"><figure><img src="/files/1d57458d3c65adbed0a288749a4a37d2bb89701a" alt=""><figcaption><p>在 GitBook 编辑器中编写内容并添加块。</p></figcaption></figure></div>

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

你可以插入 [内容块](/docs/documentation/zh/creating-content/blocks.md)、输入 [Markdown](/docs/documentation/zh/creating-content/formatting/markdown.md), [嵌入内容](/docs/documentation/zh/creating-content/blocks/embed-a-url.md)，并与 [GitBook 代理](/docs/documentation/zh/gitbook-dai-li/what-is-gitbook-agent.md).

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

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

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

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

{% hint style="info" %}
你可以通过选择以下选项来更改页面的 URL 片段： **页面操作** <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="/files/d05670ba93b683794fb3fe95a9fc7ab5c7fceafd" alt="The Actions menu icon in GitBook"></picture> > **重命名**。了解更多关于 [页面操作](#page-options) 如下。
{% endhint %}

### 页面操作菜单

页面的 **操作菜单** <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="/files/d05670ba93b683794fb3fe95a9fc7ab5c7fceafd" alt="The Actions menu icon in GitBook"></picture> 可让你执行复制、重命名或删除页面等操作。

你可以打开 **操作菜单** ，方法是使用 <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="/files/d05670ba93b683794fb3fe95a9fc7ab5c7fceafd" alt="The Actions menu icon in GitBook"></picture> 将鼠标悬停在侧边栏中的页面上时出现的图标，或页面标题旁边的图标。

{% hint style="info" %}
可用操作的类型取决于你是否处于 [实时编辑](/docs/documentation/zh/collaboration/live-edits.md) 模式，或者处于 [变更请求](/docs/documentation/zh/collaboration/change-requests.md).
{% endhint %}

### 页面选项

<div data-with-frame="true"><figure><img src="/files/4117b3f4c69134107e7d16b9dc8eaace50ff13c8" alt=""><figcaption><p>该 <strong>页面选项</strong> 侧边栏面板提供文档和导航的自定义选项。</p></figcaption></figure></div>

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

你可以打开 **页面选项** 侧边栏面板，方法是打开页面的 **操作菜单** <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="/files/d05670ba93b683794fb3fe95a9fc7ab5c7fceafd" alt="The Actions menu icon in GitBook"></picture> 并选择 **选项**，或者将鼠标悬停在页面主标题上并点击 **页面选项** 出现时的按钮。

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

### 页面大纲

<div data-with-frame="true"><figure><img src="/files/db84709a2578e47211240ca504496359dfa3129a" alt=""><figcaption><p>页面大纲会显示 H1 和 H2 标题，让你可以快速跳转到单个页面中的特定部分。</p></figcaption></figure></div>

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

任何 [标题](/docs/documentation/zh/creating-content/blocks/heading.md) 你添加到页面中的标题都会显示在此处列出的页面大纲中。

页面大纲也会显示在你已发布的站点中。你可以在 [**页面选项**](#page-options) 侧边栏面板中将其打开或关闭。

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://gitbook.com/docs/documentation/zh/zi-yuan/gitbook-ui.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.