Cuando cambias la ruta de un archivo en tu carpeta de docs, también cambia la URL de esa página. Esto puede ocurrir al reestructurar tus docs o al cambiar el título de la barra lateral.
Las redirecciones no pueden incluir anclas de URL como path#anchor ni parámetros de consulta como path?query=value.
Configura redirecciones añadiendo el campo redirects a tu archivo docs.json.
"redirects": [
{
"source": "/source/path",
"destination": "/destination/path"
}
]
Esto redirige /source/path a /destination/path.
De forma predeterminada, las redirecciones son permanentes (308). Para usar una redirección temporal (307), establece permanent en false.
"redirects": [
{
"source": "/source/path",
"destination": "/destination/path",
"permanent": false
}
]
Tanto 307 como 308 conservan el método HTTP de la solicitud original (a diferencia de 301 y 302), por lo que son adecuados para redirigir solicitudes POST.
Redirecciones con comodín
Para hacer coincidir una ruta con comodín, usa * después de un parámetro. En este ejemplo, /beta/:slug* coincide con /beta/introduction y la redirige a /v2/introduction.
"redirects": [
{
"source": "/beta/:slug*",
"destination": "/v2/:slug*"
}
]
Redirecciones con comodín parcial
Usa comodines parciales para hacer coincidir los segmentos de la URL que comienzan con un prefijo específico.
"redirects": [
{
"source": "/articles/concepts-*",
"destination": "/collections/overview"
}
]
Esto coincide con cualquier URL con la ruta /articles/concepts-, como /articles/concepts-getting-started y /articles/concepts-overview, y las redirige todas a /collections/overview.
También puedes usar el valor del comodín capturado en el destino.
"redirects": [
{
"source": "/old/article-*",
"destination": "/new/article-*"
}
]
Esto redirige /old/article-123 a /new/article-123, manteniendo el valor capturado después del prefijo.
Evita redirecciones infinitas
Para evitar bucles infinitos, no crees redirecciones circulares en las que las rutas se redirijan unas a otras.
"redirects": [
{
"source": "/docs/:slug*",
"destination": "/help/:slug*"
},
{
"source": "/help/:slug*",
"destination": "/docs/:slug*"
}
]
Detecta enlaces rotos con la CLI.