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

# 站点自定义

使用自定义徽标、字体、颜色、链接等创建品牌化文档

你可以自定义已发布文档的外观，使界面与你内容的语言相匹配，等等。

你可以将自定义设置作为全站主题应用到整个文档站点，或应用到单独的变体和站点区块。

<figure><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-b5176c44bacdad5f68cf9d1e7801920a2d8446dc%2F25_07_16_customization_demo.png?alt=media" alt="A GitBook screenshot showing a customized docs site"><figcaption><p>你可以使用 GitBook 内置的自定义选项创建各种站点设计。</p></figcaption></figure>

### 自定义包含多个区块或变体的站点

如果你的文档站点包含多个区块或变体，你可以分别控制每一个的自定义设置。

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

* **站点级设置** – 这些设置会自动应用于所有分区。
* **分区或变体专属设置** – 如果使用网站分区或变体，可以设置专属自定义选项，以覆盖全站默认设置。

<figure><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-9484f3ad4c49465cb5b2990d40aad51b6b7a029d%2F25_12_10_customization%402x.png?alt=media" alt="A GitBook screenshot showing the customization panel"><figcaption><p>GitBook 中的自定义面板。</p></figcaption></figure>

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

点击 **重置** 按钮 <picture><source srcset="broken://files/pqrwkdhGuOQlk1cWXLgI" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-950a429afdf1c25e2afa77aac3333489c1a66f58%2F25_02_19_reset_icon_light.svg?alt=media" alt="The Reset icon in GitBook"></picture> 位于分区选择器旁边。
{% endhint %}

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

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

高级自定义选项包括：

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

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

以上选项为自定义网站提供了多种方式，但无论 [您选择的套餐](https://gitbook.com/docs/documentation/zh/zhang-hu-yu-ji-fei/plans.md).

1. 都无法自定义页面上各元素的布局（不过， *可以* 在 [特定页面上隐藏某些元素](https://gitbook.com/docs/documentation/zh/chuang-jian-nei-rong/content-structure/page.md)).
2. 无法直接在 GitBook 站点中插入自定义代码（例如 CSS、HTML 或 JS）。我们已经与多种热门工具集成，并提供 [丰富的嵌入功能](https://gitbook.com/docs/documentation/zh/chuang-jian-nei-rong/blocks/embed-a-url.md) 以支持更多工具。
3. 无法移除已发布文档中显示的“小小的 “Powered by 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://gitbook.com/docs/documentation/zh/manage-your-site/customization.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
