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

当你将文档从一个提供商迁移到另一个提供商时,通常会使用重定向——比如你刚把文档迁移到 GitBook 的时候。失效链接会影响 SEO,因此我们建议在需要的地方设置重定向。
除了 GitBook 创建的自动重定向之外,你还可以从站点域名中的任意路径创建重定向。
重定向可以创建为 上线 或 草稿。草稿重定向允许你在发布前准备并审阅重定向规则。草稿在启用之前不会影响你的线上站点。
管理你站点上的重定向
要开始,请在 GitBook 中查看你的站点仪表板并打开 设置 选项卡,然后点击 域名与重定向.
创建重定向
点击 添加重定向 并选择 手动 选项。
填写 源路径 ——你想重定向的 URL 路径段——以及 目标 内容,也就是你希望访客被带到的内容。你可以选择站点上的任意版块、变体或页面。
点击 启用重定向 以立即启用该重定向。
如果你想创建重定向但暂时不让它生效,点击 保存为草稿 即可。草稿重定向会显示在 草稿 选项卡中,并可稍后启用。
你也可以通过在源路径末尾添加 * 来创建 通配符重定向 ,例如:
/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,以将现有草稿重定向发布为上线状态,
目标必须为空。

每次导入最多支持 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
空
空白
移除上线重定向
/docs/site-redirects
空
live
移除上线重定向
/docs/site-redirects
空
草稿
移除草稿重定向
/docs/site-redirects
空
publish
将现有草稿重定向发布为上线
关于自动重定向
每当页面被移动或重命名时,其规范 URL 也会随之改变。为了保持你的内容可访问,GitBook 会自动创建一个 HTTP 307 从旧 URL 到新 URL 的重定向。
每次加载 URL 时,GitBook 都会通过以下步骤解析它:
最后更新于
这有帮助吗?