---
title: "重定向"
description: "将旧 URL 指向新地址——侧边栏重写、页面重命名和主机级重定向。"
---

> Documentation Index
> Fetch the complete documentation index at: https://nimbus-docs.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 重定向

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

<h2 id="rewrite-a-sidebar-link">重写侧边栏链接</h2>

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

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

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

<h2 id="renamed-pages-across-versions">跨版本重命名页面</h2>

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

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

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

<h2 id="host-level-redirects">主机级重定向</h2>

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

```ts title="astro.config.ts"
export default defineConfig({
  redirects: {
"/old-path": "/new-path",
  },
});
```

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

Source: https://nimbus-docs.cn/navigation/redirects/index.mdx