内容变体

在一个站点中发布多个产品版本或语言的文档

您可以将同一文档的多个版本作为单个文档站点的一部分发布。这些变体将可供最终用户通过已发布站点目录顶部的变体选择器访问。

如果您需要将内容的不同变体放在一起，一个包含多个变体的站点会很有用——例如，当您记录某个 API 的多个版本（v1、v2、v3 等），或者以不同语言记录内容时。

变体可以包含任何内容，但建议将其用作 相同内容的不同版本。如果您的内容在语义上不同，请考虑将其添加为章节代替。

当将翻译或多种语言作为变体添加时，最佳做法是为您的变体设置语言，这样用户在浏览文档时能获得最佳体验。

为多个已设置语言的变体进行添加，会将语言选择器移至右上角，相比默认的变体选择器，提供更简洁、更直接的体验。

从以下位置打开结构编辑器 站点结构 在站点侧边栏中。您可以在此查看站点的全部内容。

要添加变体，请单击 添加变体 按钮，在您想添加到的部分中，然后选择要添加的内容。新变体随后会被添加到所选部分内的变体列表中，并可供访问者在您站点上的变体下拉菜单中使用。

您可以通过单击编辑按钮来更改每个变体的名称和 slug，该按钮位于您想编辑的变体所在的表格行中。这将打开一个弹窗。编辑您想更改的字段，然后单击保存按钮以保存。您也可以通过单击 删除变体 按钮，位于左下角。

如果您的站点支持多种语言，您还可以翻译变体标题，以便选择器显示本地化标签。参见多语言分区.

更改变体的 slug 将更改其规范 URL。GitBook 会自动将旧 URL 重定向到新 URL。您也可以手动创建重定向.

要替换某个变体的内容，请先通过单击其编辑按钮将其删除，然后点击删除按钮，在弹窗左下角将其删除。一旦删除了该变体，请单击 添加变体 按钮以添加新内容。

您的站点会按它们在您的 站点结构 表格中出现的顺序显示变体。变体可以通过抓住 拖拽手柄 并上下移动来重新排序。更改后的顺序会立即反映在你的网站上。

您也可以使用键盘来选择并移动内容：按空格键选择一个部分或变体，然后使用方向键将其上移或下移。再次按空格键确认新位置。

如果某个部分中有多个变体，其中一个会被标记为默认变体。访问者进入您的站点（或访问某个部分）时会显示此变体。其他每个变体都有一个附加到站点 URL 的 slug。

要将某个变体设为默认，请单击 操作菜单 在该变体的表格行中，然后单击 设为默认.

将变体设为默认会移除其 slug 字段，因为它将改为从该部分根目录提供。GitBook 会将该变体的 slug 重定向到相应路径，以确保访问者继续看到您的内容。

要从站点中移除变体，请从 站点结构 在网站侧边栏中打开结构编辑器，并找到你想移除的内容。

打开 操作菜单 打开该变体的结构编辑器，并选择移除.

从您的站点中移除变体会将其从已发布站点中删除，但 不会删除内容本身 ——你仍然可以在全部内容.

最后更新于 9天前

这有帮助吗？