重定向 | Nimbus 中文文档

三种机制覆盖常见场景：重写侧边栏链接、跨版本重命名页面，以及主机级 URL 重定向。

external_link 可以更改侧边栏中页面的链接目标，而不移动页面的实际构建位置。将已弃用的条目指向其替代页面，或将条目指向外部站点：

---
title: Old guide
external_link: /guides/new-guide
---

它接受绝对 URL（https://…）或站点绝对路径（/foo/bar）。页面仍然在自身路径下构建；只有导航栏链接发生变化。绝对 URL 会以 target="_blank" 方式渲染。

跨版本重命名页面

当页面的 slug 在不同版本之间发生变化时，在新页面上声明旧 slug，使两者关联为同一逻辑页面，并生成规范 URL：

---
title: Configuration
previousSlug: config        # 在 v1 中是 /config，现在是 /configuration
---

previousSlug 接受字符串或数组（用于跨多个版本的重命名）。Nimbus 还会自动为那些 slug 已不存在的旧版本 URL 生成重定向，指向当前版本的对应页面。

对于永久性 URL 迁移，使用 Astro 内置的 redirects 配置——Nimbus 会将其版本重定向与你的配置合并，你手动编写的条目在冲突时优先：

astro.config.tsts

export default defineConfig({
  redirects: {
    "/old-path": "/new-path",
  },
});

在静态主机上，这些会编译为重定向文件；在 Cloudflare 和其他适配器上，它们会变成原生重定向规则。