> 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/guides.md).

# 指南

探索用于自定义和组织你的 GitBook 文档站点的指南

### 探索

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4><i class="fa-wand-magic-sparkles">:wand-magic-sparkles:</i></h4></td><td><h4>如何打造视觉效果出色的文档站点</h4><p>为文档打造精致的视觉体验。</p></td><td><a href="https://gitbook.com/docs/guides/customizing-your-site/how-to-make-a-great-looking-docs-site.md">How to make a great-looking docs site</a></td></tr><tr><td><h4><i class="fa-palette">:palette:</i></h4></td><td><h4>如何自定义站点主题</h4><p>设置徽标、颜色、字体排版和导航样式。</p></td><td><a href="https://gitbook.com/docs/guides/customizing-your-site/how-to-customize-your-sites-theme.md">How to customize your site’s theme</a></td></tr><tr><td><h4><i class="fa-table-columns">:table-columns:</i></h4></td><td><h4>如何自定义站点布局</h4><p>安排文档的各个版块和导航。</p></td><td><a href="https://gitbook.com/docs/guides/customizing-your-site/how-to-customize-your-sites-layout.md">How to customize your site’s layout</a></td></tr><tr><td><h4><i class="fa-sliders">:sliders:</i></h4></td><td><h4>如何自定义站点配置</h4><p>配置站点行为和访客体验。</p></td><td><a href="https://gitbook.com/docs/guides/customizing-your-site/how-to-customize-your-sites-configuration.md">How to customize your site’s configuration</a></td></tr><tr><td><h4><i class="fa-layer-group">:layer-group:</i></h4></td><td><h4>使用站点版块将多个现有站点合并为一个</h4><p>将相关文档整合到一个已发布的站点中。</p></td><td><a href="https://gitbook.com/docs/guides/content-organization-and-localization/combine-multiple-docs-sites-using-sections.md">How to organize docs with sections</a></td></tr><tr><td><h4><i class="fa-language">:language:</i></h4></td><td><h4>使用 GitBook 的变体本地化文档</h4><p>使用变体发布本地化或带版本的文档。</p></td><td><a href="https://gitbook.com/docs/guides/content-organization-and-localization/localize-your-docs-with-variants-in-gitbook.md">How to organize docs with variants</a></td></tr></tbody></table>

#### 快速指南

<details>

<summary>自定义文档站点</summary>

自定义站点的品牌形象、导航和共享设置。

本指南介绍颜色、字体排版、布局和站点配置。

<button type="button" class="button secondary" data-action="ask" data-query="Write a step-by-step guide to customizing a GitBook documentation site. Cover updating branding, choosing a layout, configuring navigation, and reviewing site settings. Include links to the relevant docs pages." data-icon="gitbook-assistant">打开指南</button>

</details>

<details>

<summary>使用版块和变体组织内容</summary>

版块和变体可帮助你按产品、受众、语言和版本来组织内容。

本指南介绍如何创建版块、组织导航和配置变体。

<button type="button" class="button secondary" data-action="ask" data-query="Write a step-by-step guide to organizing a GitBook site with sections and content variants. Cover planning the structure, creating sections, configuring variants, and checking navigation. Include links to the relevant docs pages." data-icon="gitbook-assistant">打开指南</button>

</details>

<details>

<summary>控制站点访问权限</summary>

站点受众设置用于控制谁可以查看已发布的文档。

本指南介绍访问选项、身份验证访问，以及如何测试访客体验。

<button type="button" class="button secondary" data-action="ask" data-query="Write a step-by-step guide to controlling access to a GitBook documentation site. Cover choosing an audience, configuring authenticated access when needed, and testing access as a visitor. Include links to the relevant docs pages." data-icon="gitbook-assistant">打开指南</button>

</details>

<details>

<summary>设置自定义域名</summary>

自定义域名可为已发布的站点提供带有品牌标识的网址。

本指南介绍如何选择子域名、添加 DNS 记录并验证设置。

<button type="button" class="button secondary" data-action="ask" data-query="Write a step-by-step guide to setting up a custom domain for a GitBook documentation site. Cover choosing a subdomain, starting setup in GitBook, adding the required DNS record, and verifying the domain. Include links to the relevant docs pages." data-icon="gitbook-assistant">打开指南</button>

</details>

<details>

<summary>安装并配置集成</summary>

集成可为文档添加分析、交互式内容和其他工具。

本指南介绍如何选择集成、指定其作用范围并完成配置。

<button type="button" class="button secondary" data-action="ask" data-query="Write a step-by-step guide to installing and configuring a GitBook integration. Cover choosing an integration, selecting its scope, installing it, and completing any required configuration. Include links to the relevant docs pages." data-icon="gitbook-assistant">打开指南</button>

</details>


---

# 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/guides.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.
