> 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/docs-site/customization.md).

# 站点自定义

{% hint style="info" %}
某些自定义功能仅可在 [高级和终极站点方案](https://www.gitbook.com/pricing).
{% endhint %}

你可以自定义已发布文档的外观，使用户界面与你的内容语言一致，等等。

你可以将自定义应用于整个文档站点，作为站点级主题；也可以应用于单个变体和站点分区。

<figure><img src="/files/2be2d03fd8fcc4e6d5bd045a2f570d1e25a465ec" alt="A GitBook screenshot showing a customized docs site"><figcaption><p>你可以使用 GitBook 内置的自定义选项创建各种站点设计。</p></figcaption></figure>

### 为包含多个分区或变体的站点进行自定义

如果你的文档站点包含多个分区或变体，你可以单独控制每个部分的自定义。

使用顶部的下拉菜单选择整个站点或某个特定站点分区 **自定义** 面板。

* **站点级设置** – 这些会自动应用于所有分区。
* **分区或变体特定设置** – 如果你正在使用站点分区或变体，你可以设置特定的自定义内容，它将覆盖默认的站点级设置。

<figure><img src="/files/03e79f95f140a678f1bf1501853fd8965eea7274" alt="A GitBook screenshot showing the customization panel"><figcaption><p>GitBook 中的自定义面板。</p></figcaption></figure>

{% hint style="warning" %}
你对特定站点分区所做的更改会覆盖站点级自定义设置，即使你之后再次更改站点级设置也是如此。

你可以通过点击 **重置** 按钮 <picture><source srcset="/files/pqrwkdhGuOQlk1cWXLgI" media="(prefers-color-scheme: dark)"><img src="/files/db6be9765006db26f1933c5b866a7e5283387877" alt="The Reset icon in GitBook"></picture> 旁边的分区选择器，将自定义覆盖重置回站点级默认值。
{% endhint %}

### 什么算作“高级自定义”？

每个 GitBook 用户都可以利用其文档站点上的基础自定义选项。Premium 或 Ultimate 站点方案用户还可以使用高级自定义功能，进一步调整文档以匹配其品牌。

高级自定义选项包括：

* **自定义徽标** – 添加一个徽标，以替换文档站点顶部的表情符号和标题。
* **图标样式** - 更改文档站点中页面图标的粗细和样式。
* **自定义字体** – 更改文档站点的主字体和等宽字体。
* **页脚** – 在文档底部的页脚中添加自定义徽标、版权文本和导航。
* **粗体和渐变主题** – 使用这些新主题更改页眉的背景颜色，或为整个站点添加渐变背景。
* **语义颜色** – 更改已发布内容中提示块的背景颜色以及代码块的样式。
* **代码主题** – 使用预设主题或使用站点颜色的自适应主题，更改已发布文档中代码和 API 块的外观。

### 哪些内容无法自定义？

上面的选项为你提供了许多自定义站点的方式，但有几项内容无论 [你选择的方案](/docs/documentation/zh/zhang-hu-guan-li/plans.md).

1. 都无法自定义页面元素的布局（不过， *为* 可以 [隐藏特定页面上的某些元素](/docs/documentation/zh/creating-content/content-structure/page.md)).
2. 无法将自定义代码（例如 CSS、HTML 或 JS）直接插入到你的 GitBook 站点中。我们已经与许多流行工具集成，并为更多工具提供 [丰富嵌入](/docs/documentation/zh/creating-content/blocks/embed-a-url.md) 功能。
3. 无法移除已发布文档中出现的那条小的“由 GitBook 提供支持”链接。


---

# 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/docs-site/customization.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.
