# Redirections du site
A GitBook screenshot showing site redirects

Les redirections de site sont utiles lors de la migration de la documentation ou de la restructuration du contenu afin d’éviter les liens brisés, qui peuvent avoir un impact sur le référencement.

Les redirections sont couramment utilisées lorsque vous migrez votre documentation d’un fournisseur à un autre — par exemple lorsque vous venez de տեղափոխer la documentation vers GitBook. Les liens brisés peuvent avoir un impact sur le référencement, c’est pourquoi nous recommandons de configurer des redirections lorsque c’est nécessaire. En plus de [la création automatique de redirections par GitBook](#about-automatic-redirects), vous pouvez créer une redirection à partir de n’importe quel chemin dans le domaine de votre site. Les redirections peuvent être créées soit en **Publié** ou **Brouillon**. Les redirections en brouillon vous permettent de préparer et de vérifier les règles de redirection avant de les publier. Les brouillons n’affectent pas votre site en ligne tant qu’ils ne sont pas activés. ## Gérer les redirections sur votre site Pour commencer, consultez le tableau de bord de votre site dans GitBook et ouvrez l’ **Paramètres** onglet, puis cliquez sur **Domaine et redirections**. ### Créer des redirections Cliquez sur **Ajouter une redirection** et sélectionnez le **Manuel** . Renseignez le **chemin source** — le slug d’URL que vous souhaitez rediriger — et la **destination** le contenu vers lequel vous souhaitez envoyer les visiteurs. Vous pouvez sélectionner n’importe quelle section, variante ou page de votre site. Cliquez sur **Activer la redirection** pour l’activer immédiatement. Si vous souhaitez créer la redirection sans la mettre encore en ligne, cliquez plutôt sur **Enregistrer comme brouillon** . Les redirections en brouillon apparaissent dans l’ **Brouillon** onglet et peuvent être activées plus tard. Vous pouvez également créer des **redirections avec caractère générique** en ajoutant \* à la fin du chemin source, par exemple : * /docs/\* pour faire correspondre tout ce qui se trouve sous /docs/ * /changelog\* pour faire correspondre les chemins qui commencent par /changelog Lorsque votre chemin source contient un caractère générique (\*), vous pouvez activer **Remplacer le caractère générique par le texte correspondant**. * **Activé :** la partie correspondant à \* est ajoutée au chemin de destination. * Exemple : source /docs/\* → destination /help\ /docs/install redirige vers /help/install * **Désactivé :** toutes les URL correspondantes redirigent vers la même destination fixe. * Exemple : source /docs/\* → destination /help\ /docs/install redirige vers /help Si vous souhaitez ajouter une autre redirection vers la même page, activez **Ajouter une autre redirection** avant de cliquer sur **Activer la redirection** ou **Enregistrer comme brouillon**. Lorsque vous ajoutez la redirection, la fenêtre modale restera ouverte avec le contenu de destination défini sur votre sélection précédente afin que vous puissiez ajouter rapidement un autre chemin source. ### Modifier des redirections Pour modifier une redirection, cliquez sur l’ **Modifier** icône à côté dans la liste. Mettez à jour la redirection et cliquez sur **Activer la redirection** pour publier vos modifications. Si la redirection est actuellement un **brouillon**, vous pouvez également la publier directement depuis la fenêtre modale d’édition en cliquant sur **Activer la redirection**. ### Activation des redirections en brouillon Les redirections en brouillon apparaissent dans l’ **Brouillon** onglet du tableau des redirections. Vous pouvez publier une redirection en brouillon de deux façons : • Ouvrez la redirection et cliquez sur **Activer la redirection** dans la fenêtre modale d’édition.\ • Utilisez le **interrupteur dans le tableau** pour activer directement la redirection. Une fois activée, la redirection passe dans l’ **Publié** onglet et commence immédiatement à rediriger les visiteurs. ### Importer des redirections depuis un CSV Cliquez sur **Ajouter une redirection** et choisissez **Téléverser un CSV**. Téléversez un CSV avec les colonnes `source`, `destination`, et la colonne facultative `intent`. * `source` est le chemin que vous souhaitez rediriger, par exemple /docs/site-redirects * `destination` peut être : * une page spécifique, en utilisant l’URL d’administration de la page comme indiqué dans la capture d’écran ci-dessous * une URL externe * vide, selon l’intention * `intent` peut être : * live, laissé vide ou omis entièrement, pour créer, mettre à jour ou supprimer une redirection active * draft pour créer, mettre à jour ou supprimer une redirection en brouillon * publish pour publier une redirection en brouillon existante en version active, `destination` doit être vide.

Vous pouvez trouver l’URL d’administration GitBook d’une page dans ce menu

Un maximum de 500 lignes est pris en charge par importation. Si votre CSV contient des valeurs source en double, seule la première ligne est traitée. L’importation fonctionne comme une opération d’upsert : les redirections existantes avec la même source sont mises à jour, et de nouvelles redirections sont créées pour les sources qui n’existent pas encore. Si certaines lignes échouent, un CSV d’erreurs est disponible depuis la notification toast en bas à droite. Il inclut la source, la destination et une brève explication de chaque erreur afin que vous puissiez corriger, supprimer la colonne des erreurs et réimporter. #### Exemples de CSV | source | destination | intent | Résultat | | -------------------- | -------------------------- | --------- | --------------------------------------------------------------- | | /docs/site-redirects | | vide | Créer ou mettre à jour une redirection active | | /docs/site-redirects | | live | Créer ou mettre à jour une redirection active | | /docs/site-redirects | | brouillon | Créer ou mettre à jour une redirection en brouillon | | /docs/site-redirects | vide | vide | Supprimer la redirection active | | /docs/site-redirects | vide | live | Supprimer la redirection active | | /docs/site-redirects | vide | brouillon | Supprimer la redirection en brouillon | | /docs/site-redirects | vide | publish | Publier la redirection en brouillon existante en version active | ## À propos des redirections automatiques Chaque fois que des pages sont déplacées ou renommées, leur URL canonique change avec elles. Afin de garder votre contenu accessible, GitBook crée automatiquement une [redirection HTTP 307](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/307) de l’ancienne URL vers la nouvelle. Chaque fois qu’une URL est chargée, GitBook la résout selon les étapes suivantes : 1. Le contenu du site est résolu vers son URL canonique en suivant les redirections créées automatiquement. 2. Si l’URL ne peut pas être résolue, elle est vérifiée par rapport aux [redirections au niveau de l’espace](https://gitbook-v2-q67etdj25-gitbook.vercel.app/url/gitbook.com/docs/documentation/fr/getting-started/git-sync/content-configuration#redirects), définies dans le `.gitbook.yaml` fichier. 3. Enfin, l’URL est vérifiée par rapport aux redirections au niveau du site, créées via [le processus ci-dessus](#creating-redirects).