> 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/can-kao/gitbook-ui.md).

# GitBook 界面

GitBook 围绕你的文档站点组织。你从你的组织开始 **主页**，打开一个站点以处理其内容，并在各个部分中编辑页面。本页将带你了解界面的每个部分。

### 主页

<div data-with-frame="true"><figure><img src="/files/77c4b0a8cc8cfd378985f6a1ad8260b1bb333567" alt=""><figcaption><p>你的组织主页可让你访问站点、内容和组织控制项。</p></figcaption></figure></div>

打开 GitBook 后，你会进入你的组织 **主页**：你组织中的每个文档站点都汇集在一个地方。在这里你可以打开站点、创建新站点，或调整全组织范围的设置。主页包含：

* **切换器**\
  返回 **主页** ，你可以使用侧边栏顶部的切换器在任意位置返回。如果你属于多个组织，可在这里查看并在它们之间切换，或创建新的组织。
* **通知**\
  当你在评论或对话中被标记，或你正在处理的某个部分有重要活动时，你会收到一条 [通知](/docs/documentation/zh/xie-zuo/notifications.md) ，以便向你显示最新动态。
* **提问或搜索**\
  由……提供支持 [GitBook 代理](/docs/documentation/zh/chuang-jian-nei-rong/searching-your-content/gitbook-ai.md)，用自然语言提问，或在组织中的站点和内容中搜索。
* **站点列表**\
  查看你组织中的每个文档站点。点击站点即可打开。
* **全部内容**\
  如果你的组织中有不属于任何站点的内容，它会显示在一个 **全部内容** 部分中，与站点并列，以树状视图显示。如果每一条内容都属于某个站点，则不会显示此部分。
* **设置**\
  [组织设置](/docs/documentation/zh/zhang-hao-he-zhang-dan/organization-settings.md) 并 [账户设置](/docs/documentation/zh/zhang-hao-he-zhang-dan/account-settings.md) 共享一个专用屏幕。它按 **账户** 并 **组织**.

  **账户** 包括 **常规**, **通知**, **组织**，以及 **开发者工具**. **组织** 包括 **常规**, **成员**, **合并规则**, **GitBook 代理**, **集成**, **OpenAPI**, **翻译**, **邀请链接**, **团队**, **SSO**，以及 **计费**。点击 **返回应用** 以返回你的工作。
* **样式指南**\
  查看每个 [样式指南](/docs/documentation/zh/guan-li-ni-de-zhan-dian/site-structure.md) 在你的组织中以及使用它的站点。
* **回收站**\
  已删除的部分会显示在 **回收站**中。你可以在七天内恢复它们——之后它们将被永久删除。

### 站点侧边栏

打开站点后，侧边栏会替换为该站点的内容和工具：也就是访客在你已发布站点上看到的相同结构。站点侧边栏包含：

* **站点页眉**\
  你站点的名称和发布状态，以及 **预览** 并 **发布** 按钮。
* **常规**\
  **概览**, **变更请求**, **站点结构**，以及 **设置**.
* **工具**\
  **样式指南**, **Customize**, **分析**，以及 **扩展**。每个都会在主视图中打开。
* **内容**\
  你站点的 [部分中](/docs/documentation/zh/guan-li-ni-de-zhan-dian/site-structure/site-sections.md) 以及分组，按发布顺序排列。点击某个部分即可编辑。

  该树状结构为只读。可在 [结构编辑器](/docs/documentation/zh/guan-li-ni-de-zhan-dian/site-structure.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/chuang-jian-nei-rong/content-structure/page.md#organizing-your-content) 在你所选部分中。它位于侧边栏右侧。

你还可以管理 [可复用内容](/docs/documentation/zh/chuang-jian-nei-rong/reusable-content.md) 并 [文件](/docs/documentation/zh/chuang-jian-nei-rong/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>.

### 部分页眉 <a href="#space-header" id="space-header"></a>

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

部分页眉包含你当前正在查看的部分的信息。它可让你查看评论和历史记录，并配置 [GitHub 或 GitLab 同步](/docs/documentation/zh/wen-dang-ji-dai-ma/git-sync.md)等内容来自定义并覆盖默认配置。

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

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

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

<div data-with-frame="true"><figure><img src="/files/14482194f5442e478fe0b383243a6b9162d8e8b0" alt=""><figcaption><p>变更请求中的部分页眉。</p></figcaption></figure></div>

部分页眉包含：

* **部分表情符号或图标**\
  为你的部分选择一个表情符号或图标，以便在侧边栏中识别它。
* **部分名称**\
  此名称会显示在侧边栏和你已发布的站点上。
* **部分的面包屑导航**\
  该部分所在的站点——以及（如有）所在的分组。
* **操作菜单**\
  为你的部分提供操作。类似于 [页面操作](#the-actions-menu)，可用操作会因编辑模式而异。
* **概览**\
  在变更请求中，可查看其标题、描述、参与者、审阅者、更改和评论。
* **编辑器视图**\
  使用 GitBook 的基于块的编辑器编辑内容。
* **更改视图**\
  此视图 [突出显示更改](/docs/documentation/zh/xie-zuo/change-requests.md#diff-mode) ，使用差异视图展示变更请求中的修改。合并前请审阅更改。
* **预览**\
  在合并变更请求之前预览内容。
* **协作者**\
  查看正在阅读该部分页面的人员头像。点击某个头像即可打开他们正在查看的页面。
* **Git 同步配置**\
  配置 GitHub 和 GitLab [同步](/docs/documentation/zh/wen-dang-ji-dai-ma/git-sync.md) ，适用于该部分。
* **分享菜单**\
  发布并分享你的部分，或邀请他人协作。
* **变量**\
  创建可复用的 [变量](/docs/documentation/zh/chuang-jian-nei-rong/variables-and-expressions.md) ，适用于该部分。
* **GitBook 代理**\
  与……协作处理部分更改 [GitBook 代理](broken://pages/155dafccc07f944f2a09205d69e1c7ba7bea602a).
* **评论**\
  查看 [评论和讨论](/docs/documentation/zh/xie-zuo/comments.md) ，关于部分内容。
* **变更请求**\
  创建、更新和删除 [变更请求](/docs/documentation/zh/xie-zuo/change-requests.md).
* **部分历史记录**\
  查看 [版本历史记录](/docs/documentation/zh/chuang-jian-nei-rong/version-control.md) ，适用于该部分或变更请求。
* **编辑按钮**\
  如果某个部分已发布或 [实时编辑](/docs/documentation/zh/xie-zuo/live-edits.md) 已锁定， **编辑** 会创建一个 [变更请求](/docs/documentation/zh/xie-zuo/change-requests.md).

### 站点工具 <a href="#site-headers" id="site-headers"></a>

站点工具可从主视图中的站点侧边栏打开。站点页眉会保留 **预览** 并 **发布**.

在 **常规**:

* **概览**\
  站点的关键信息，包括其 URL、发布状态、受众、内容和顶级洞察。一旦你的网站上线， **概览** 将链接到它。
* **变更请求**\
  你站点各部分中的变更请求。
* **站点结构**\
  使用 [结构编辑器](/docs/documentation/zh/guan-li-ni-de-zhan-dian/site-structure.md) 用于添加、重新排序、发布和移除部分与分组。
* **设置**\
  [网站设置](/docs/documentation/zh/guan-li-ni-de-zhan-dian/site-settings.md) 包括 **常规**, **成员**, **智能体**, **受众**, **域名和 URL**, **重定向**，以及 **方案**.

在 **工具**:

* **样式指南**\
  你站点的 [样式指南](/docs/documentation/zh/guan-li-ni-de-zhan-dian/site-structure.md) 定义写作规则和约定。GitBook Agent 在撰写、编辑或审阅内容时会遵循它。
* **Customize**\
  [自定义你的站点](/docs/documentation/zh/guan-li-ni-de-zhan-dian/customization.md) ，包含 **主题**, **布局**, **AI 助手**，以及 **配置** 选项。
* **分析**\
  **AI 洞察** 并 **分析** 提供 [详细分析](/docs/documentation/zh/fen-xi/insights.md) ，关于你的站点及其表现。
* **扩展**\
  **连接**, **渠道**, **文档嵌入**, **MCP 访问**，以及 [**集成**](/docs/documentation/zh/guan-li-ni-de-zhan-dian/install-an-integration.md).

### 内容编辑器

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

编辑器是你部分的主要区域。撰写并插入内容，然后与团队实时协作。

插入 [内容块](/docs/documentation/zh/chuang-jian-nei-rong/blocks.md)，编写 [Markdown](/docs/documentation/zh/chuang-jian-nei-rong/formatting/markdown.md), [嵌入内容](/docs/documentation/zh/chuang-jian-nei-rong/blocks/embed-a-url.md)，并与……协作 [GitBook 代理](broken://pages/155dafccc07f944f2a09205d69e1c7ba7bea602a).

你也可以对块发表评论并标记队友。

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

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

页面描述最多可包含 200 个字符。它会作为搜索引擎中的预览文本显示。

{% hint style="info" %}
要更改页面 URL 的 slug，请打开该页面的 [操作菜单](#the-actions-menu) 并点击 **编辑标题和 slug**.
{% endhint %}

### 页面操作菜单 <a href="#the-actions-menu" id="the-actions-menu"></a>

页面的 **操作菜单** <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/xie-zuo/live-edits.md) 或 [变更请求](/docs/documentation/zh/xie-zuo/change-requests.md).
{% endhint %}

### 页面选项 <a href="#page-options" id="page-options"></a>

<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>

页面大纲位于编辑器右侧。它可让你跳转到页面的某个部分。

大纲列出 H1 和 H2 [标题](/docs/documentation/zh/chuang-jian-nei-rong/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, and the optional `goal` query parameter:

```
GET https://gitbook.com/docs/documentation/zh/can-kao/gitbook-ui.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.