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>
119 lines
3.1 KiB
Plaintext
119 lines
3.1 KiB
Plaintext
---
|
|
title: "Redirections"
|
|
description: "Configurez des redirections d'URL dans docs.json pour les pages de documentation déplacées, renommées ou supprimées afin de préserver le référencement SEO et d'éviter les liens brisés."
|
|
keywords: ["redirects"]
|
|
boost: 3
|
|
---
|
|
|
|
Lorsque vous modifiez le chemin d'un fichier dans votre dossier docs, l'URL de cette page change également. Cela peut se produire lors de la restructuration de votre documentation ou de la modification du titre de la barre latérale.
|
|
|
|
<div id="redirects">
|
|
## Redirections
|
|
</div>
|
|
|
|
<Note>
|
|
Les redirections **ne peuvent pas** inclure des ancres d'URL telles que `path#anchor` ni des paramètres de requête tels que `path?query=value`.
|
|
</Note>
|
|
|
|
Configurez des redirections en ajoutant le champ `redirects` à votre fichier `docs.json`.
|
|
|
|
```json
|
|
"redirects": [
|
|
{
|
|
"source": "/source/path",
|
|
"destination": "/destination/path"
|
|
}
|
|
]
|
|
```
|
|
|
|
Cela redirige `/source/path` vers `/destination/path`.
|
|
|
|
Par défaut, les redirections sont permanentes (308). Pour utiliser une redirection temporaire (307), définissez `permanent` sur `false`.
|
|
|
|
```json
|
|
"redirects": [
|
|
{
|
|
"source": "/source/path",
|
|
"destination": "/destination/path",
|
|
"permanent": false
|
|
}
|
|
]
|
|
```
|
|
|
|
Les codes 307 et 308 conservent tous deux la méthode HTTP de la requête d'origine (contrairement à 301 et 302), ce qui les rend adaptés à la redirection des requêtes POST.
|
|
|
|
|
|
<div id="wildcard-redirects">
|
|
### Redirections avec joker
|
|
</div>
|
|
|
|
Pour faire correspondre un chemin avec joker, utilisez `*` après un paramètre. Dans cet exemple, `/beta/:slug*` correspond à `/beta/introduction` et le redirige vers `/v2/introduction`.
|
|
|
|
```json
|
|
"redirects": [
|
|
{
|
|
"source": "/beta/:slug*",
|
|
"destination": "/v2/:slug*"
|
|
}
|
|
]
|
|
```
|
|
|
|
<div id="partial-wildcard-redirects">
|
|
### Redirections avec jokers partiels
|
|
</div>
|
|
|
|
Utilisez des jokers partiels pour faire correspondre les segments d'URL qui commencent par un préfixe donné.
|
|
|
|
```json
|
|
"redirects": [
|
|
{
|
|
"source": "/articles/concepts-*",
|
|
"destination": "/collections/overview"
|
|
}
|
|
]
|
|
```
|
|
|
|
Cela correspond à toutes les URL dont le chemin est `/articles/concepts-`, comme `/articles/concepts-getting-started` et `/articles/concepts-overview`, et les redirige toutes vers `/collections/overview`.
|
|
|
|
Vous pouvez également réutiliser la valeur générique capturée dans la destination.
|
|
|
|
```json
|
|
"redirects": [
|
|
{
|
|
"source": "/old/article-*",
|
|
"destination": "/new/article-*"
|
|
}
|
|
]
|
|
```
|
|
|
|
Cela redirige `/old/article-123` vers `/new/article-123`, tout en conservant la valeur capturée après le préfixe.
|
|
|
|
<div id="avoid-infinite-redirects">
|
|
### Éviter les redirections infinies
|
|
</div>
|
|
|
|
Pour éviter les boucles infinies, ne créez pas de redirections circulaires dans lesquelles les chemins se renvoient les uns aux autres.
|
|
|
|
```json
|
|
"redirects": [
|
|
{
|
|
"source": "/docs/:slug*",
|
|
"destination": "/help/:slug*"
|
|
},
|
|
{
|
|
"source": "/help/:slug*",
|
|
"destination": "/docs/:slug*"
|
|
}
|
|
]
|
|
```
|
|
|
|
<div id="check-for-broken-links">
|
|
## Vérifier les liens cassés
|
|
</div>
|
|
|
|
Détectez les liens cassés avec la [CLI](/fr/cli).
|
|
|
|
```bash
|
|
mint broken-links
|
|
```
|