重定向

redirect 可以写在 .config.yml（目录级）或 Markdown frontmatter（页面级）中。

目录重定向

常用于把一个 collection 的根路径重定向到某篇具体文档：

# content/zh-CN/.config.yml
navigation:
  hidden: true
redirect: /introduction

访问 /zh-CN 会自动跳到 /zh-CN/introduction。

页面重定向

---
redirect: /zh-CN/guide/routing
---

重定向目标的解析规则

• 绝对协议链接（如 https://...、mailto:...）原样保留。
• 以 / 开头的路径会按当前 collection base 解析。例如在 base 为 /zh-CN 的 collection 里写 redirect: /introduction，最终目标是 /zh-CN/introduction。
• 不以 / 开头的路径会按当前目录解析。例如在 content/zh-CN/guide/.config.yml 里写 redirect: test，最终目标是 /zh-CN/guide/test。
• 如果目标已经带了 base 前缀，则不会重复添加。

框架会在构建期收集整个 workspace 的重定向规则；同一来源路径出现冲突的目标时会直接报错，帮助你尽早发现配置问题。