Passer au contenu principal
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.

Redirections

Configurez des redirections 301 en ajoutant le champ redirects à votre fichier docs.json.
"redirects": [
  {
    "source": "/source/path",
    "destination": "/destination/path"
  }
]
Cela redirige de manière permanente /source/path vers /destination/path afin de ne pas perdre le SEO précédemment acquis pour la page d’origine.

Redirections avec joker

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.
"redirects": [
  {
    "source": "/beta/:slug*",
    "destination": "/v2/:slug*"
  }
]

Redirections avec jokers partiels

Utilisez des jokers partiels pour faire correspondre les segments d’URL qui commencent par un préfixe donné.
"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.
"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.

Éviter les redirections infinies

Pour éviter les boucles infinies, le slug de destination ne peut pas être identique au slug source. Par exemple, si votre documentation est hébergée sur /docs, évitez :
"redirects": [
  {
    "source": "/docs/:slug*",
    "destination": "/:slug*"
  }
]
Détectez les liens cassés avec la CLI.
mint broken-links