> 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/docs-site/site-structure/variants.md).
# Variantes de contenu
Vous pouvez publier plusieurs versions de la même documentation dans le cadre d’un seul site de documentation. Ces variantes seront disponibles pour les utilisateurs finaux via le sélecteur de variantes en haut de la table des matières du site publié.
### Ajouter plusieurs langues ou versions
Un site avec plusieurs variantes est utile si vous devez conserver ensemble différentes versions de votre contenu — par exemple si vous documentez plusieurs versions d’une API (v1, v2, v3, etc.), ou si vous documentez votre contenu dans différentes langues.
{% hint style="info" %}
Les variantes peuvent contenir n’importe quel contenu, mais il est recommandé de les utiliser comme *des variations du même contenu*. Si votre contenu est sémantiquement différent, envisagez de l’ajouter comme [sections](/docs/documentation/fr/docs-site/site-structure/site-sections.md) à la place.
{% endhint %}
Lorsque vous ajoutez une traduction ou plusieurs langues comme variante, il est recommandé de définir la langue de votre variante afin d’offrir à vos utilisateurs la meilleure expérience possible lors de la navigation dans votre documentation.
L’ajout de plusieurs variantes avec des langues définies déplacera le sélecteur de langue en haut à droite, offrant une expérience plus claire et plus directe que le sélecteur de variantes par défaut.
### Ajouter une variante à votre site de documentation
Ouvrez l’éditeur de structure depuis **Structure du site**, sous **Général** dans la barre latérale du site. Ici, vous pouvez voir tout le contenu de votre site.
Pour ajouter une variante, cliquez sur le **Ajouter une variante** bouton dans la section à laquelle vous souhaitez ajouter du contenu, puis choisissez le contenu à ajouter. La nouvelle variante est alors ajoutée à la liste des variantes dans la section choisie et sera disponible pour les visiteurs dans la liste déroulante des variantes sur votre site.
### Modifier une variante
Vous pouvez changer le nom et le slug de chacune de vos variantes en cliquant sur le **Modifier** bouton dans la ligne du tableau de la variante que vous souhaitez modifier. Cela ouvrira une fenêtre modale. Modifiez le ou les champs que vous souhaitez changer, puis cliquez sur le **Enregistrer** bouton pour enregistrer. Vous pouvez également supprimer la variante en cliquant sur le **Supprimer la variante** bouton en bas à gauche.
Si votre site prend en charge plusieurs langues, vous pouvez également traduire les titres des variantes afin que le sélecteur affiche des libellés localisés. Voir [Sections multilingues](/docs/documentation/fr/docs-site/site-structure/multilingual-sections.md).
{% hint style="info" %}
Modifier le slug d’une variante modifiera son URL canonique. GitBook créera automatiquement une redirection de l’ancienne URL vers la nouvelle. Vous pouvez également [créer des redirections manuellement](/docs/documentation/fr/docs-site/site-redirects.md).
{% endhint %}
Pour remplacer le contenu d’une variante, commencez par la supprimer en cliquant sur son **Modifier** bouton, puis cliquez sur le **Supprimer** bouton en bas à gauche de la fenêtre modale. Une fois la variante supprimée, cliquez sur le **Ajouter une variante** bouton pour ajouter le nouveau contenu.
### Réorganiser les variantes
Votre site affiche les variantes dans l’ordre dans lequel elles apparaissent dans votre **Structure du site** tableau. Les variantes peuvent être réorganisées en saisissant le **poignée de déplacement** et en la déplaçant vers le haut ou vers le bas. L’ordre modifié sera reflété immédiatement sur votre site.
Vous pouvez également utiliser le clavier pour sélectionner et déplacer du contenu : sélectionnez une section ou une variante avec la barre d’espace, puis utilisez les touches fléchées pour la déplacer vers le haut ou vers le bas. Appuyez de nouveau sur la barre d’espace pour confirmer la nouvelle position.
### Définir une variante par défaut
Si vous avez plusieurs variantes dans une section, l’une d’elles sera marquée comme variante par défaut. Cette variante s’affiche lorsque les visiteurs arrivent sur votre site (ou lorsqu’ils consultent une section). Les autres variantes ont chacune un slug qui est ajouté à l’URL du site.
Pour définir une variante comme variante par défaut, cliquez sur le **menu Actions** dans la ligne du tableau de la variante, puis cliquez sur **Définir comme valeur par défaut**.
{% hint style="info" %}
Définir une variante comme variante par défaut supprime son champ de slug, car elle sera servie depuis la racine de la section à la place. GitBook redirigera le slug de la variante vers le chemin approprié afin de garantir que les visiteurs continuent de voir votre contenu.
{% endhint %}
### Supprimer une variante d’un site
Pour supprimer une variante d’un site, ouvrez l’éditeur de structure depuis **Structure du site**, sous **Général** dans la barre latérale du site, et trouvez le contenu que vous souhaitez supprimer.
Ouvrez le **menu Actions** pour la variante que vous souhaitez supprimer et choisissez **Supprimer**.
{% hint style="success" %}
Supprimer une variante de votre site la retirera du site publié, mais **ne supprimera pas le contenu lui-même** — vous pouvez toujours le retrouver dans [Tout le contenu](/docs/documentation/fr/creating-content/all-content.md).
{% endhint %}
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://gitbook.com/docs/documentation/fr/docs-site/site-structure/variants.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.