mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
4b465465dd
Generated-By: mintlify-agent Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
118 lines
2.9 KiB
Plaintext
118 lines
2.9 KiB
Plaintext
---
|
|
title: "Redirecciones"
|
|
description: "Configura redirecciones de URL en docs.json para páginas de documentación movidas, renombradas o eliminadas con el fin de preservar el posicionamiento SEO y evitar enlaces rotos."
|
|
keywords: ["redirects"]
|
|
boost: 3
|
|
---
|
|
|
|
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.
|
|
|
|
<div id="redirects">
|
|
## Redirecciones
|
|
</div>
|
|
|
|
<Note>
|
|
Las redirecciones **no pueden** incluir anclas de URL como `path#anchor` ni parámetros de consulta como `path?query=value`.
|
|
</Note>
|
|
|
|
Configura redirecciones añadiendo el campo `redirects` a tu archivo `docs.json`.
|
|
|
|
```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`.
|
|
|
|
```json
|
|
"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.
|
|
|
|
<div id="wildcard-redirects">
|
|
### Redirecciones con comodín
|
|
</div>
|
|
|
|
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`.
|
|
|
|
```json
|
|
"redirects": [
|
|
{
|
|
"source": "/beta/:slug*",
|
|
"destination": "/v2/:slug*"
|
|
}
|
|
]
|
|
```
|
|
|
|
<div id="partial-wildcard-redirects">
|
|
### Redirecciones con comodín parcial
|
|
</div>
|
|
|
|
Usa comodines parciales para hacer coincidir los segmentos de la URL que comienzan con un prefijo específico.
|
|
|
|
```json
|
|
"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.
|
|
|
|
```json
|
|
"redirects": [
|
|
{
|
|
"source": "/old/article-*",
|
|
"destination": "/new/article-*"
|
|
}
|
|
]
|
|
```
|
|
|
|
Esto redirige `/old/article-123` a `/new/article-123`, manteniendo el valor capturado después del prefijo.
|
|
|
|
<div id="avoid-infinite-redirects">
|
|
### Evita redirecciones infinitas
|
|
</div>
|
|
|
|
Para evitar bucles infinitos, no crees redirecciones circulares en las que las rutas se redirijan unas a otras.
|
|
|
|
```json
|
|
"redirects": [
|
|
{
|
|
"source": "/docs/:slug*",
|
|
"destination": "/help/:slug*"
|
|
},
|
|
{
|
|
"source": "/help/:slug*",
|
|
"destination": "/docs/:slug*"
|
|
}
|
|
]
|
|
```
|
|
|
|
<div id="check-for-broken-links">
|
|
## Comprobar enlaces rotos
|
|
</div>
|
|
|
|
Detecta enlaces rotos con la [CLI](/es/cli).
|
|
|
|
```bash
|
|
mint broken-links
|
|
```
|