Redirections du site

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

Les redirections de site sont utiles lors de la migration de la documentation ou de la restructuration du contenu pour éviter les liens brisés, ce qui peut affecter 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 déplacer des docs vers GitBook. Les liens brisé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 Paramètres onglet, puis cliquez sur Domaine et redirections.

Création de redirections

Cliquez sur Ajouter une redirection et sélectionnez l'option Manuelle .

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 lier. Vous pouvez choisir n'importe quelle section, variante, ou page de votre site. Cliquez sur Ajouter pour créer la redirection.

Vous pouvez également créer redirections génériques en ajoutant * à la fin du chemin source, par exemple :

• /docs/* pour correspondre à tout ce qui se trouve sous /docs/

• /changelog* pour correspondre aux chemins qui commencent par /changelog

Lorsque votre chemin source inclut un caractère générique (*), vous pouvez activer Remplacer le 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, 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é de celle-ci dans la liste. Mettez à jour la redirection et appuyez sur Enregistrer.

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

Importer des redirections depuis un CSV

Cliquez sur Ajouter une redirection et choisissez Télécharger le CSV.

Téléchargez un CSV avec exactement deux colonnes nommées : source et destination :

• La source est le chemin que vous souhaitez rediriger (par exemple, /docs/site-redirects)

• La destination peut être :

  • Une page spécifique : utilisez l'URL d'administration de la page, comme indiqué dans la capture d'écran ci-dessous

  • Une URL externe

  • Une chaîne vide ("") : supprime la redirection pour cette source

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 s'exécute en tant qu'upsert : les redirections existantes ayant la même source sont mises à jour, et de nouvelles redirections sont créées pour les sources qui n'existent pas encore.

Si des lignes échouent, un CSV d'erreurs est disponible depuis la notification 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.

À 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 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, 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.