mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
locadex-agent[bot]
9e5444dbc7
Co-authored-by: locadex-agent[bot] <217277504+locadex-agent[bot]@users.noreply.github.com>
103 lines
2.5 KiB
Plaintext
103 lines
2.5 KiB
Plaintext
---
|
|
title: "Redirecciones"
|
|
description: "Configura redirecciones para páginas movidas, renombradas o eliminadas."
|
|
keywords: ["301", "redirects"]
|
|
---
|
|
|
|
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 301 añadiendo el campo `redirects` a tu archivo `docs.json`.
|
|
|
|
```json
|
|
"redirects": [
|
|
{
|
|
"source": "/source/path",
|
|
"destination": "/destination/path"
|
|
}
|
|
]
|
|
```
|
|
|
|
Esto redirige de forma permanente `/source/path` a `/destination/path` para que no pierdas el SEO previo de la página original.
|
|
|
|
<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/installation).
|
|
|
|
```bash
|
|
mint broken-links
|
|
```
|