> 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>您的组织主页可让您访问站点、内容和组织控件。</p></figcaption></figure></div>

打开 GitBook 后，您将进入您的组织 **主页**：您组织中的所有文档站点都集中在一处。在这里，您可以打开站点、创建新站点或调整组织范围的设置。主页包含：

* **切换器**\
  从任何位置返回 **主页** ，可使用侧边栏顶部的切换器。如果您属于多个组织，可在此查看和切换组织，或创建新组织。
* **通知**\
  当有人在评论或讨论中提及您，或您正在处理的章节中有重要活动时，您会收到一条 [通知](/docs/documentation/zh/collaboration/notifications.md) ，向您显示最新动态。
* **提问或搜索**\
  由以下提供支持： [GitBook Agent](/docs/documentation/zh/creating-content/searching-your-content/gitbook-ai.md)，以自然语言提问，或搜索您组织中的站点和内容。
* **站点列表**\
  查看您组织中的所有文档站点。单击站点即可将其打开。
* **所有内容**\
  如果您的组织包含不属于任何站点的内容，它会显示在一个 **所有内容** 章节中，并以树状视图显示在您的站点旁边。如果每项内容都属于某个站点，则不会显示此章节。
* **设置**\
  [组织设置](/docs/documentation/zh/zhang-hu-guan-li/organization-settings.md) 和 [账户设置](/docs/documentation/zh/zhang-hu-guan-li/account-settings.md) 共用一个专用界面。该界面按以下类别对设置进行分组： **账户** 和 **组织**.

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

### 站点侧边栏

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

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

  该树状结构为只读。请在 [结构编辑器](/docs/documentation/zh/docs-site/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/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>.

### 章节页眉 <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/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>

章节页眉包括：

* **章节表情符号或图标**\
  为您的章节选择表情符号或图标，以便在侧边栏中识别它。
* **章节名称**\
  此名称会显示在侧边栏和已发布的站点上。
* **章节的面包屑导航**\
  该章节所在的站点，以及所属分组（如有）。
* **操作菜单**\
  提供针对您章节的操作。类似于 [页面操作](#the-actions-menu)，可用操作因编辑模式而异。
* **概览**\
  在变更请求中，查看其标题、描述、参与者、审阅者、更改和评论。
* **编辑器视图**\
  使用 GitBook 的基于区块的编辑器编辑内容。
* **更改视图**\
  此视图 [突出显示更改](/docs/documentation/zh/collaboration/change-requests.md#diff-mode) ，并在变更请求中使用差异视图显示。请在合并前审阅更改。
* **预览**\
  在合并变更请求前预览内容。
* **协作者**\
  查看正在阅读该章节页面的人员头像。单击头像可打开他们正在查看的页面。
* **Git 同步配置**\
  配置 GitHub 和 GitLab [同步](/docs/documentation/zh/getting-started/git-sync.md) ，供该章节使用。
* **分享菜单**\
  发布和分享您的章节，或邀请他人协作。
* **变量**\
  创建可复用 [变量](/docs/documentation/zh/creating-content/variables-and-expressions.md) ，供该章节使用。
* **GitBook Agent**\
  通过以下方式协作处理章节更改： [GitBook Agent](/docs/documentation/zh/gitbook-agent/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/site-structure.md) 来添加、重新排序、发布和移除章节及分组。
* **设置**\
  [站点设置](/docs/documentation/zh/docs-site/site-settings.md) 包括 **常规**, **成员**, **智能代理**, **受众**, **域名和 URL**, **重定向**，以及 **套餐**.

在 **工具**:

* **样式指南**\
  您的站点 [样式指南](/docs/documentation/zh/docs-site/site-structure.md) 定义写作规则和惯例。GitBook Agent 会在编写、编辑或审阅内容时遵循它。
* **自定义**\
  [自定义您的站点](/docs/documentation/zh/docs-site/customization.md) 使用 **主题**, **布局**, **AI 助手**，以及 **配置** 选项。
* **分析**\
  **AI 洞察** 和 **分析** 提供 [详细分析](/docs/documentation/zh/docs-site/insights.md) ，了解您的站点及其表现。
* **扩展**\
  **连接**, **渠道**, **文档嵌入**, **MCP 访问权限**，以及 [**集成**](/docs/documentation/zh/ji-cheng/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/creating-content/blocks.md)，编写 [Markdown](/docs/documentation/zh/creating-content/formatting/markdown.md), [嵌入内容](/docs/documentation/zh/creating-content/blocks/embed-a-url.md)，并与以下对象协作： [GitBook Agent](/docs/documentation/zh/gitbook-agent/what-is-gitbook-agent.md).

您还可以对区块发表评论并提及队友。

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

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

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

{% hint style="info" %}
若要更改页面 URL 短标识，请打开页面的 [操作菜单](#the-actions-menu) 并单击 **编辑标题和短标识**.
{% 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/collaboration/live-edits.md) 还是 [变更请求](/docs/documentation/zh/collaboration/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/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, and the optional `goal` query parameter:

```
GET https://gitbook.com/docs/documentation/zh/zi-yuan/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.