diamond-turn-right站点重定向

设置站点重定向,将流量路由到你网站任意位置的内容

A GitBook screenshot showing site redirects
当迁移文档或重组内容以避免失效链接时,站点重定向很有用,因为失效链接会影响 SEO。

当你将文档从一个提供商迁移到另一个提供商时,通常会使用重定向——比如你刚把文档迁移到 GitBook 的时候。失效链接会影响 SEO,因此我们建议在需要的地方设置重定向。

GitBook 创建的自动重定向之外,你还可以为站点域名中的任意路径创建重定向。

重定向可以创建为 生效 或者 草稿。草稿重定向允许你在发布前准备并审核重定向规则。草稿在启用之前不会影响你的线上站点。

管理站点上的重定向

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

创建重定向

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

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

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

如果你想先创建重定向但暂时不让它上线,请改为点击 另存为草稿 。草稿重定向会出现在 草稿 选项卡中,并可稍后启用。

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

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

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

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

  • 开启: 被 * 匹配到的部分会附加到目标路径后面。

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

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

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

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

当你添加重定向时,弹窗会保持打开,并将目标内容设置为你上一次的选择,这样你就可以快速添加另一个源路径。

编辑重定向

要编辑重定向,请点击列表中它旁边的 编辑 图标。更新重定向后点击 启用重定向 以发布你的更改。

如果该重定向当前是 草稿,你也可以在编辑弹窗中直接点击 启用重定向.

启用草稿重定向

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

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

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

一旦启用,该重定向会移至 生效 选项卡,并立即开始路由访客。

从 CSV 导入重定向

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

上传一个包含以下列的 CSV: source, 目标,以及可选的 intent.

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

  • 目标 可以是:

    • 一个具体页面,使用该页面的管理 URL,如下方截图所示

    • 一个外部 URL

    • 为空,具体取决于 intent

  • intent 可以是:

    • live,留空,或完全省略,用于创建、更新或移除生效重定向

    • draft,用于创建、更新或移除草稿重定向

    • publish,用于将现有草稿重定向发布为生效状态, 目标 必须为空。

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

每次导入最多支持 500 行。

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

如果有任何行失败,可以从右下角的提示气泡中下载错误 CSV。它包含源、目标以及每个错误的简短说明,方便你修复后,删除错误列并重新导入。

CSV 示例

source
目标
intent
结果

/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

空白

移除生效重定向

/docs/site-redirects

live

移除生效重定向

/docs/site-redirects

草稿

移除草稿重定向

/docs/site-redirects

publish

将现有草稿重定向发布为生效状态

关于自动重定向

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

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

  1. 站点内容会通过跟随任何自动创建的重定向解析到其规范 URL。

  2. 如果无法解析该 URL,则会检查该 URL 是否匹配 空间级重定向,这些重定向定义在你的仓库的 .gitbook.yaml 文件的子目录。

  3. 最后,URL 会检查站点级重定向,这些重定向通过 上面的流程.

最后更新于

这有帮助吗?