站点重定向
设置站点重定向,将流量导向你站点任意位置的内容

当你将文档从一个提供商迁移到另一个提供商时,重定向通常很有用——比如你刚把文档迁移到 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 包含重复的 source 值,则只处理第一行。导入会以 upsert 方式运行:具有相同 source 的现有重定向会被更新,而尚不存在的 source 会创建新的重定向。
如果有任何行失败,可以从右下角的提示通知中获取错误 CSV。它包含 source、destination 以及每个错误的简短说明,方便你修复、删除错误列并重新导入。
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 会按以下步骤解析它:
最后更新于
这有帮助吗?