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 pour éviter les liens brisés, ce qui peut impacter le référencement (SEO).

Les redirections sont couramment utilisées lorsque vous migrez votre documentation d’un prestataire à un autre — par exemple lorsque vous venez de déplacer des docs vers GitBook. Les liens brisés peuvent affecter le SEO, 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.

Les redirections peuvent être créées en tant que En direct ou Brouillon. Les redirections en brouillon vous permettent de préparer et de revoir les règles de redirection avant de les publier. Les brouillons n’affectent pas votre site en direct 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’onglet Paramètres puis cliquez sur Domaine et redirections.

Créer des redirections

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

Remplissez le chemin source — le slug URL que vous souhaitez rediriger — et la destination de contenu vers laquelle 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 activer immédiatement la redirection.

Si vous souhaitez créer la redirection sans la mettre en ligne pour l’instant, cliquez sur Enregistrer comme brouillon à la place. Les redirections en brouillon apparaissent dans l’onglet Brouillon et peuvent être activées ultérieurement.

Vous pouvez également créer des redirections génériques 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 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é : tous les URL correspondant 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 réglé 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’icône Modifier à 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 de modification en cliquant sur Activer la redirection.

Activation des redirections en brouillon

Les redirections en brouillon apparaissent dans l’onglet Brouillon 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 de modification. • Utilisez le interrupteur dans le tableau pour activer la redirection directement.

Une fois activée, la redirection passe à l’onglet En direct 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 éventuellement 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 telle qu’affichée dans la capture d’écran ci‑dessous

  • une URL externe

  • vide, selon l’intention

• intent peut être :

  • live, laisser vide, ou omis entièrement, pour créer, mettre à jour ou supprimer une redirection en direct

  • brouillon pour créer, mettre à jour ou supprimer une redirection en brouillon

  • publish pour publier une redirection brouillon existante en direct, 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 inclut des valeurs source en double, seule la première ligne est traitée. L’importation s’exécute en mode 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 des lignes échouent, un CSV d’erreurs est disponible depuis le 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	https://example.com/page	vide	Créer ou mettre à jour une redirection en direct
/docs/site-redirects	https://example.com/page	live	Créer ou mettre à jour une redirection en direct
/docs/site-redirects	https://example.com/page	brouillon	Créer ou mettre à jour une redirection en brouillon
/docs/site-redirects	empty	vide	Supprimer la redirection en direct
/docs/site-redirects	empty	live	Supprimer la redirection en direct
/docs/site-redirects	empty	brouillon	Supprimer la redirection en brouillon
/docs/site-redirects	empty	publish	Publier la redirection brouillon existante en direct

À 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 HTTP 307 redirection 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, l’URL 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.