Redirections du site

Configurez des redirections de site pour acheminer le trafic vers n’importe quel contenu de votre site

Les redirections de site sont utiles lors de la migration de la documentation ou de la restructuration du contenu afin d'éviter les liens cassés, ce qui peut impacter 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 cassés peuvent nuire au référencement, nous recommandons donc de configurer des redirections si 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, consultez 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 souhaitez pointer. 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 Ajouter une autre redirection avant d'appuyer sur Ajouter. Lorsque vous ajoutez votre redirection, la boîte de dialogue 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 appuyez sur Enregistrer.

Pour supprimer une redirection, appuyez sur le Supprimer la redirection bouton 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 garder votre contenu accessible, 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 en suivant les étapes suivantes :

1. Le contenu du site est résolu vers son URL canonique en suivant toutes les redirections créées automatiquement.

2. Si l'URL ne peut pas être résolue, elle est comparée aux redirections au niveau de l'espace, définies dans le .gitbook.yaml du dépôt.

3. Enfin, l'URL est vérifiée par rapport aux redirections au niveau du site, créées via le processus ci-dessus.