图标、颜色与主题

自定义已发布文档中的图标、颜色、主题及更细粒度的设置

标题、图标和徽标

标题

您可以为您的空间设置任意标题。注意：此设置仅会影响显示的标题 在已发布的文档中。如果您想在 GitBook 应用内编辑标题，请关闭自定义菜单并在空间顶部进行编辑。

图标

您可以设置表情符号，或上传您自己的图标。您在 自定义 菜单中设置的图标将被用作您文档站点的网站图标（favicon）。

此设置仅会影响显示的图标 在已发布的文档中。如果您想编辑在 GitBook 应用中使用的图标，可以在直接编辑空间内容时进行。

自定义徽标 （高级版与终极版）

您可以替换 两者 已发布空间的标题和图标为自定义徽标，使您的文档更符合您自己的品牌形象 — 您可以上传两个版本：一个用于亮色模式，另一个用于暗色模式。

图标选项和徽标选项有什么区别？

图标设置允许您上传一个小型的 132×132 px 图像，该图像将显示 在...旁边 您的空间标题并作为您站点的 favicon。自定义徽标选项允许您上传更大的图像（我们建议宽度至少 600 px），它会完全替换您已设置的任何图标和标题。

主题

主题让您可以自定义已发布内容在亮色和暗色模式下的配色方案。共有四种主题可供选择。您站点的颜色将直接受您所选的 主色 和 色调 的影响。这两个选择会影响界面的各个部分，并能完全改变您站点的外观与感受。

清爽（Clean）

一种以半透明效果和极简样式元素为特色的现代主题。您的主色（或色调）会影响链接及其他强调的界面元素。

清爽（Clean）适用于所有站点，并为默认主题。

柔和（Muted）

一种降低元素对比度的精致主题。站点背景更为明显并与前景融合，部分元素呈现反转外观——这一切均基于您的主色（或色调）。

柔和（Muted）适用于所有站点。

大胆（Bold） （高级版与终极版）

一种高冲击力的主题，具有醒目的颜色和强烈对比。您的主色（或色调）将用于站点的页眉，图标等其他强调元素也会随之着色。

大胆（Bold）仅适用于高级版或终极版站点。

渐变（Gradient） （高级版与终极版）

一种引领潮流的主题，具有渐变背景和色彩点缀。渐变和强调元素将以您的主色（或色调）着色。

渐变（Gradient）仅适用于高级版或终极版站点。

颜色

主色

您站点的主色将影响强调界面项和导航元素的样式，例如链接、当前页面和章节、面包屑以及主要页眉按钮。

如果与背景的对比度过低或访问者的系统请求更高对比度，GitBook 会自动调整各个元素的颜色以提高可读性。

色调颜色

您站点的色调颜色会微妙地改变整个站点中所有文本和图标的颜色——包括页眉链接、图标颜色以及诸如 提问或搜索 栏。

色调颜色将 不 影响像链接和按钮这样的导航元素，它们始终使用主色。

在 色调颜色 部分您将看到基于主色选择的建议颜色。您可以选择其中一个进行预览，将主色选为您的色调，或使用颜色选择器选取完全自定义的颜色。

语义颜色 （高级版与终极版）

语义颜色应用于已发布内容中的提示块，并且也可以应用于代码块。

您可以更改每种提示样式的背景颜色；这些更改将在您正在自定义的已发布站点上反映出来。

注意： GitBook 编辑器中的提示块将始终保持其标准颜色，不会与您站点的语义颜色匹配。

代码主题 （高级版与终极版）

代码主题会更改已发布文档中代码块和 API 块的外观。

主题列表包括：

• 自适应主题 – 这些标准的亮暗模式主题使用您站点的配色以匹配您的品牌。

• Shiki 主题 – 在亮暗两种模式下从 60 多个预设主题中进行选择。

您可以为文档的亮色和暗色模式选择单独的代码主题。并且您可以在任一模式中使用任意亮色或暗色色方案——例如在文档为亮色模式时使用暗色代码主题。

默认情况下，您选择的主题将同时应用于代码块和 OpenAPI 块。如果您想为 OpenAPI 块设置不同的主题，请点击 按块类型自定义 按钮。

模式

显示模式切换

如果您希望访客手动在亮色和暗色模式之间切换，请启用此项。读者可以在任何已发布页面的底部（桌面和移动端）找到该切换。

默认模式

选择访客默认看到您的内容为亮色还是暗色模式。如果 显示模式切换 已启用，他们可以切换模式；如果禁用，他们将只能看到您在此处选择的模式。

注意：要在 GitBook 应用内更改主题，请转到侧边栏底部的设置菜单。

站点样式

字体系列 （高级版与终极版）

从精心挑选的流行选项列表中为已发布内容选择常规和等宽字体系列。

等宽字体用于您文档站点中的代码块和 OpenAPI 块。

自定义字体 （仅终极版）

上传您自己的常规和等宽字体，以使已发布内容与您品牌的风格指南一致。要上传字体，请点击 添加自定义字体 并按照说明操作。您必须为常规和粗体字重各上传一个字体文件。

GitBook 当前支持 .woff 和 .woff2。对于其他格式，请联系 [e-mail].

图标 （高级版与终极版）

在使用页面图标时，请在此处设置显示图标的粗细和样式。

角样式

选择圆角或直角以匹配您品牌的样式偏好。

深度样式

在两种深度样式之间进行选择，这些样式适用于卡片、按钮以及任何带阴影的其他元素：

• 细微： 一些阴影和漂浮感。

• 平面： 无阴影或漂浮感。

链接样式

在两种链接设计之间选择：

• 默认： 以主色或色调颜色突出显示整个链接。

• 强调： 为链接添加彩色下划线，保持文本颜色不变。

侧边栏样式

此菜单可让您直观了解不同样式将如何改变侧边栏的外观。

背景样式

选择侧边栏容器的背景样式。颜色取自您所选的主题。

有两个选项 — 默认 和 填充 — 每个都有如何改变目录的可视化表示。

列表样式

为侧边栏列表及其选中项选择样式。有三种选项 — 默认, 胶囊（Pill） 和 线条（Line） — 每个都有显示如何改变目录的可视化表示。