> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/fr/publish/site-redirects.md).

# Redirections du site

Configurez des redirections de site pour acheminer le trafic vers du contenu partout sur votre site

Les redirections sont couramment utilisées lorsque vous migrez votre documentation d’un fournisseur à un autre — par exemple lorsque vous venez de déplacer la documentation vers GitBook. Les liens cassés peuvent avoir un impact sur le SEO, c’est pourquoi nous recommandons de mettre en place des redirections lorsque c’est nécessaire.

En plus des [redirections automatiques créées par GitBook](#about-automatic-redirects), vous pouvez créer une redirection depuis n’importe quel chemin de votre domaine. GitBook peut également suggérer des redirections pour les URL de votre site auxquelles les visiteurs accèdent, mais qui renvoient une erreur 404. Voir [Liens cassés](https://gitbook.com/docs/documentation/fr/analytics/broken-links.md).

Les redirections peuvent être créées à l’état **Actif** ou **Brouillon**. Les redirections à l’état de brouillon vous permettent de préparer et de vérifier les règles de redirection avant de les publier. Les brouillons n’ont aucun effet sur votre site en ligne tant qu’ils ne sont pas activés.

<figure><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-0b5f1f472dbf1a51f65ba2fd752290a1aae1b7fe%2F26_01_06_redirects%402x.png?alt=media" alt="A GitBook screenshot showing site redirects"><figcaption><p>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, qui peuvent avoir un impact sur le SEO.</p></figcaption></figure>

## Gérer les redirections sur votre site

Pour commencer, ouvrez les **Paramètres** de votre site dans la barre latérale, puis cliquez sur **Redirections**.

### Créer des redirections

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

Renseignez le **chemin source** — le segment d’URL que vous souhaitez rediriger — ainsi que le **contenu de destination** vers lequel vous souhaitez rediriger les visiteurs. Vous pouvez sélectionner n’importe quelle section, variante ou page de votre site.

La sélection d’une page enregistre la destination comme une référence de page, qui continue de résoudre vers cette page même après que vous l’avez déplacée dans la structure de votre site. Saisir plutôt un chemin d’URL correspond exactement à ce chemin, donc la redirection cesse de fonctionner si la page se déplace et que son chemin change. Sélectionnez la page dans la mesure du possible.

### Choisir un statut de redirection

Lorsque vous créez ou modifiez une redirection, choisissez son statut HTTP :

* **Temporaire (307)** indique aux navigateurs et aux moteurs de recherche que la destination peut changer. Utilisez cette option pour un déplacement temporaire.
* **Permanente (308)** indique aux navigateurs et aux moteurs de recherche que l’URL source a été déplacée de façon permanente. Utilisez cette option si vous ne prévoyez pas de rétablir l’ancienne URL.

Les deux codes d’état conservent la méthode et le corps de la requête lors de la redirection.

GitBook envoie le 308 pour une redirection permanente uniquement aux vues non authentifiées du contenu public en ligne, ce qui inclut les moteurs de recherche et les visiteurs anonymes ; la redirection compte donc pour le SEO. Les requêtes provenant de l’application GitBook, des aperçus et des sessions authentifiées en tant que visiteur reçoivent à la place un 307, ce qui évite une mise en cache locale involontaire.

Cliquez sur **Activer la redirection** pour activer immédiatement la redirection.

Pour créer la redirection sans la mettre en ligne tout de suite, cliquez plutôt sur **Enregistrer comme brouillon** . Les redirections à l’état de 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 le chemin source contient un caractère générique (\*), vous pouvez activer l’option **Remplacer le caractère générique par le texte correspondant**.

* **Activée :** la partie correspondant à \* est ajoutée au chemin de destination.
  * Exemple : source /docs/\* → destination /help\
    /docs/install redirige vers /help/install
* **Désactivée :** toutes les URL correspondantes redirigent vers la même destination fixe.
  * Exemple : source /docs/\* → destination /help\
    /docs/install redirige vers /help

Pour ajouter une autre redirection vers la même page, activez l’option **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.

{% hint style="warning" %}
**Remarque :** GitBook résout les URL publiées sans tenir compte de la casse. Deux redirections qui ne diffèrent que par les majuscules et les minuscules sont donc considérées comme un même chemin. Si vous migrez depuis une plateforme qui distingue les majuscules des minuscules dans les URL, vous devrez peut-être regrouper les redirections avant de les importer.
{% endhint %}

### Modifier des redirections

Pour modifier une redirection, cliquez sur l’icône **Modifier** à côté de celle-ci dans la liste. Mettez à jour la redirection, puis cliquez sur **Activer la redirection** pour publier vos modifications.

Si la redirection est actuellement à l’état de **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 à l’état de brouillon apparaissent dans l’onglet **Brouillons** 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 **bouton bascule du tableau** pour activer directement la redirection.

Une fois activée, la redirection passe dans l’onglet **Actives** et commence immédiatement à rediriger les visiteurs.

### Importer des redirections depuis un CSV

Cliquez sur **Ajouter une redirection** et choisissez **Importer un fichier CSV**.

Importez un fichier CSV contenant 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 de l’application 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, pour créer, mettre à jour ou supprimer une redirection active
  * `draft` pour créer, mettre à jour ou supprimer une redirection à l’état de brouillon
  * `publish` pour publier une redirection existante à l’état de brouillon. Avec `publish`, `destination` doit être vide.

<div data-with-frame="true"><figure><img src="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-1811bdc6a92d7e88fd724f3249aaae4a9350f1c0%2Fimage.png?alt=media" alt=""><figcaption><p>Vous pouvez trouver l’URL de l’application GitBook d’une page dans ce menu</p></figcaption></figure></div>

Une URL d’application stocke la destination sous forme de référence à une page, ce qui présente le même avantage par rapport à un chemin fixe que celui décrit dans [Créer des redirections](#creating-redirects).

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 via le toast en bas à droite. Il inclut la source, la destination et une brève explication de chaque erreur afin que vous puissiez corriger ces lignes, supprimer la colonne des erreurs, puis réimporter.

#### Exemples de CSV

## À propos des redirections automatiques

Lorsque des pages sont déplacées ou renommées, leur URL canonique change en conséquence. Pour que votre contenu reste 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 l’une des 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 la section, définies dans le dépôt de votre `.gitbook.yaml`  fichier.
3. Enfin, l’URL est vérifiée par rapport aux redirections au niveau du site, créées selon [le processus décrit ci-dessus](#creating-redirects).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://gitbook.com/docs/documentation/fr/publish/site-redirects.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
