diamond-turn-right站点重定向

设置站点重定向以将流量路由到站点上的任意内容

A GitBook screenshot showing site redirects
站点重定向在迁移文档或重组内容以避免损坏链接时非常有用,因为损坏的链接会影响 SEO。

当您将文档从一个提供商迁移到另一个提供商时(例如刚将文档移到 GitBook),通常会使用重定向。损坏的链接会影响 SEO,因此我们建议在需要的地方设置重定向。

除了 由 GitBook 自动创建的重定向之外,您可以从站点域中的任何路径创建重定向。

重定向可以创建为 实时草稿。草稿重定向允许您在发布之前准备和审查重定向规则。草稿在启用之前不会影响您的实时站点。

在您的站点上管理重定向

要开始,请在 GitBook 中查看您站点的仪表板并打开 设置 选项卡,然后点击 域和重定向.

创建重定向

点击 添加重定向 并选择 手动 选项。

填写 源路径 — 您想要重定向的 URL 段 — 以及 目标 您希望访客转到的内容。您可以选择站点上的任何章节、变体或页面。

点击 启用重定向 以立即启用该重定向。

如果您想创建重定向但尚不使其生效,请点击 另存为草稿 。草稿重定向会出现在 草稿 选项卡中,之后可以启用。

您还可以创建 通配符重定向 ,通过在源路径末尾添加 *,例如:

  • /docs/* 用于匹配 /docs/ 下的所有内容

  • /changelog* 用于匹配以 /changelog 开头的路径

当您的源路径包含通配符 (*) 时,您可以启用 将通配符替换为匹配的文本.

  • 开启: 由 * 匹配的部分会追加到目标路径。

    • 示例:源 /docs/* → 目标 /help /docs/install 重定向到 /help/install

  • 关闭: 所有匹配的 URL 都重定向到相同的固定目标。

    • 示例:源 /docs/* → 目标 /help /docs/install 重定向到 /help

如果您想向同一页面添加另一个重定向,请在点击之前切换 添加另一个重定向启用重定向另存为草稿.

当您添加重定向时,模态窗口将保持打开,目标内容将设置为您之前的选择,以便您可以快速添加另一个源路径。

编辑重定向

要编辑重定向,请在列表中点击其旁边的 编辑 图标。更新重定向并点击 启用重定向 以发布您的更改。

如果该重定向当前是 草稿,您也可以在编辑模态中直接点击发布它,方法是点击 启用重定向.

启用草稿重定向

草稿重定向会显示在重定向表格的 草稿 选项卡中。

您可以通过两种方式发布草稿重定向:

• 打开重定向并在编辑模态中点击 启用重定向 。 • 在表格中使用 切换开关 以直接启用该重定向。

一旦启用,重定向会移动到 实时 选项卡并立即开始路由访客。

从 CSV 导入重定向

点击 添加重定向 并选择 上传 CSV.

上传包含列的 CSV , 目标,以及可选的 意图.

  • 是您想要重定向的路径,例如 /docs/site-redirects

  • 目标 可以是:

    • 一个特定页面,使用截图中显示的页面管理员 URL

    • 外部 URL

    • 空白,取决于意图

  • 意图 可以是:

    • live(实时),留空或完全省略,以创建、更新或删除实时重定向

    • draft(草稿)以创建、更新或删除草稿重定向

    • publish(发布)以将现有草稿重定向发布为实时, 目标 必须为空。

您可以在此菜单中找到页面的 GitBook 管理员 URL

每次导入最多支持 500 行。

如果您的 CSV 包含重复的源值,则仅处理第一行。导入以 upsert 方式运行:具有相同源的现有重定向会被更新,而不存在的源会创建新的重定向。

如果有任何行失败,右下角的通知中会提供错误 CSV。它包括源、目标和每个错误的简短解释,以便您修复,删除错误列并重新导入。

CSV 示例

目标
意图
结果

/docs/site-redirects

https://example.com/page

空白

创建或更新实时重定向

/docs/site-redirects

https://example.com/page

live(实时)

创建或更新实时重定向

/docs/site-redirects

https://example.com/page

草稿

创建或更新草稿重定向

/docs/site-redirects

empty(空)

空白

移除实时重定向

/docs/site-redirects

empty(空)

live(实时)

移除实时重定向

/docs/site-redirects

empty(空)

草稿

移除草稿重定向

/docs/site-redirects

empty(空)

publish(发布)

将现有草稿重定向发布为实时

关于自动重定向

每当页面被移动或重命名时,它们的规范 URL 会随之变化。为了保持内容可访问,GitBook 会自动创建一个 HTTP 307arrow-up-right 从旧 URL 到新 URL 的重定向。

每次加载 URL 时,GitBook 会通过以下步骤解析它:

  1. 站点内容通过遵循任何自动创建的重定向解析为其规范 URL。

  2. 如果无法解析该 URL,则会将 URL 与 空间级别重定向在您的仓库的 .gitbook.yaml 文件中定义的进行匹配检查。

  3. 最后,URL 会与通过上述过程创建的站点级重定向进行检查, 进行匹配。.

最后更新于

这有帮助吗?