Redirections du site

Configurez des redirections de site pour diriger le trafic vers du contenu n’importe où sur votre site.

This feature is available on Premium and Ultimate site plans.

Les redirections de site sont utiles lors de la migration de documentation ou de la restructuration de contenu pour éviter les liens brisés, ce qui peut affecter le référencement (SEO).

Les redirections sont couramment utilisées lorsque vous migrez votre documentation d'un fournisseur à un autre — comme lorsque vous venez de déplacer des docs vers GitBook. Les liens brisés peuvent nuire au référencement, nous recommandons donc de configurer des redirections là où cela est nécessaire.

En plus de redirections automatiques créées par GitBook, vous pouvez créer une redirection depuis n'importe quel chemin du domaine de votre site.

Gestion des redirections sur votre site

Pour commencer, affichez le tableau de bord de votre site dans GitBook et ouvrez l'onglet Paramètres , puis cliquez sur Domaine et redirections.

Création de redirections

Cliquez sur Ajouter une redirection pour commencer. Remplissez le chemin source — c'est‑à‑dire le slug d'URL que vous souhaitez rediriger ailleurs — et le contenu de destination vers lequel vous voulez renvoyer. Vous pouvez choisir n'importe quelle section, variante, ou page de votre site. Cliquez sur Ajouter pour créer la redirection.

Si vous souhaitez ajouter une autre redirection vers la même page, vous pouvez activer l'option Ajouter une autre redirection avant d'appuyer sur Ajouter. Lorsque vous ajoutez votre redirection, la fenêtre modale restera ouverte avec le contenu de destination défini sur la sélection précédente afin que vous puissiez ajouter immédiatement un autre slug d'URL.

Modification des redirections

Pour modifier une redirection, appuyez sur l'icône Modifier à côté dans la liste. Mettez à jour la redirection et cliquez sur Enregistrer.

Pour supprimer une redirection, appuyez sur le bouton Supprimer la redirection et confirmez.

À propos des redirections automatiques

Chaque fois que des pages sont déplacées ou renommées, leur URL canonique change avec elles. Afin de conserver l'accès à votre contenu, GitBook crée automatiquement une redirection HTTP 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 automatiquement créées.

2. Si l'URL ne peut pas être résolue, elle est vérifiée par rapport aux redirections au niveau de l'espace, 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.