Redirecciones

Configura redirecciones de URL en docs.json para páginas movidas, renombradas o eliminadas, preservando el SEO y evitando enlaces rotos.

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.

​

Redirecciones

Las redirecciones no pueden incluir anclas de URL como path#anchor ni parámetros de consulta como path?query=value.

Añade el campo redirects al nivel superior de tu archivo docs.json para configurar redirecciones.

docs.json

{
  "name": "My docs",
  "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*"
  }
]

​

Comprobar enlaces rotos

Detecta enlaces rotos con la CLI.

mint broken-links