页眉选项
页眉是 Docsbook 文档网站的顶部导航栏。它包含您的项目名称和徽标、自定义链接、社交图标，以及搜索、Ask AI、主题和语言控件。本页面上的每项设置都属于显示选项——更改页眉不会消耗您的项目余额。
页眉设置#
| 设置 | 功能 |
|---|---|
| 页眉布局预设 | 将页眉区块（主题、搜索、Ask AI、导航链接）排列为 5 种预设布局之一 |
| 显示页眉 | 显示或隐藏整个顶部导航栏 |
| 页眉链接 | 页眉导航中的自定义文本链接 |
| 社交链接 | GitHub、Twitter、Discord 的图标链接 |
| 页眉中的主题切换 | 在页眉中显示浅色/深色模式切换器 |
| 页眉中的语言选择器 | 在页眉中显示语言切换器 |
| 页眉中的搜索按钮 | 在页眉中显示搜索图标/按钮 |
| 搜索按钮背景颜色 | 自定义页眉搜索按钮的背景颜色 — 见下文 |
| Ask AI 按钮背景颜色 | 自定义页眉 Ask AI 按钮的背景颜色 — 见下文 |
如何配置页眉#
- 打开您的文档站点。
- 依次点击浮动小部件 → 设计 → 页眉选项卡。
- 填写字段并切换选项。
- 保存。
从页面编辑页眉#
你也可以在查看页眉的位置更改它。在文档站点上，点击工具栏中的 编辑器，然后点击你想要更改的部分：
| 点击对象 | 你可以 |
|---|---|
| 项目名称或徽标 | 更改名称、徽标或图标 |
| 页眉链接 | 更改其文本或 URL，或将其转换为实心按钮 |
| 搜索 / 询问 AI / 语言 / 主题 | 隐藏它 |
| 社交图标 | 将其指向其他位置，或移除它 |
| 栏中的空白区域 | 切换布局预设 |
每个操作都会作为请求发送到 AI 聊天中，然后由 AI 应用该操作 — 因此你可以 看到发出了什么请求以及发生了什么变化，并且可以在同一 次对话中撤销操作。
页眉布局预设#
页眉布局卡片是“页眉”选项卡中的第一张卡片。它会为顶部导航中的各个区块选择预设排列方式——主题切换、搜索、Ask AI 和导航链接——但不会改变显示哪些区块。
| 预设 | 排列方式 | 适用场景 |
|---|---|---|
| 经典（默认） | 主题、Ask AI 和搜索集中在右侧 | 通用默认设置——适用于大多数文档网站 |
| 以搜索为中心 | 宽搜索栏居中显示在页眉中，Ask AI 位于右侧 | 以搜索为主的内容密集型文档 |
| 搜索 + Ask AI | 宽搜索栏居中显示，Ask AI 按钮紧邻其右侧 | 询问 AI 与搜索同等重要的文档 |
| 居中 | 左侧为徽标，中间为导航链接，右侧为功能项 | 包含 3–5 个链接的着陆页风格页面 |
| 极简 | Ask AI 和搜索以纯图标形式显示 | 为导航链接和社交图标留出最大空间 |
点击某个预设即可应用——一次点击会同时设置底层的六个位置字段（主题所在侧、搜索宽度、Ask AI 位置、仅图标显示 Ask AI、仅图标显示搜索、导航链接位置）。
将 Ask AI 放在搜索旁边仅在搜索栏较宽时生效。使用紧凑型搜索栏时，没有可供按钮加入的中心区域，因此它会保留在右侧分组中。
布局 ≠ 可见性。预设只控制区块的位置，不会控制区块是否显示。如果你通过区块自身的开关关闭某个区块（例如页眉中的主题切换），该区块会消失，而页眉的其余部分仍会遵循相同的预设——剩余区块不会移入其位置，也不会改变排列方式。
页眉按钮背景颜色#
在页眉中搜索和在页眉中询问 AI卡片各自都有一个背景颜色字段，以十六进制代码设置（例如 #5B47E0）。在此处设置的颜色会覆盖按钮的默认柔和背景；文本会自动切换为黑色或白色，以确保在该背景上清晰可读。
将字段留空可保留默认背景 — 无需设置站点的强调色，设置强调色也不会改变背景颜色。
页眉链接#
页眉链接是 Docsbook 网站顶部栏中的自定义文本链接。添加显示在顶部栏中的链接，可用于链接到您的产品、博客、更新日志或支持页面。
格式：每个链接包含一个标签和一个URL。
示例：
| 标签 | URL |
|---|---|
| 产品 | https://yourapp.com |
| 更新日志 | https://yourapp.com/changelog |
| 支持 | https://yourapp.com/support |
社交链接#
社交链接是 Docsbook 标题栏中的图标链接，指向您的社区，包括 GitHub、Twitter / X 和 Discord。每个平台添加一个链接。
支持的平台：
- GitHub — 链接到您的代码仓库或组织
- Twitter / X — 链接到您的 Twitter 个人资料
- Discord — 链接到您的社区服务器
社交链接会以小图标的形式显示在标题栏中。它们可以帮助读者找到您的社区，同时避免在导航中加入过多文本链接。
页眉中的主题和语言控件#
您可以将主题切换器和语言切换器放置在页眉中，而不是（或除了）侧边栏中。
如需更精细地控制主题切换器和搜索框在页眉中的位置（相对于导航链接），请参阅上面的页眉布局预设。
建议：为每个控件选择一个位置，以避免重复。
隐藏页眉#
将显示页眉设置为关闭会移除整个顶部导航栏。
仅在嵌入式或信息亭使用场景中执行此操作，即文档被嵌入其他产品中时。对于独立的文档网站，请始终保持页眉可见。
相关内容#
- 侧边栏布局和配置 — 导航的另一半
- 主题 — 浅色、深色、跟随系统 — 页眉中的主题切换按钮所切换的主题
- 品牌 — 名称、徽标、颜色、字体 — 页眉显示的名称和徽标
- 翻译设置 — 页眉中的语言切换器提供的语言