> 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/agent-gitbook/translations.md).

# Traductions

Traduisez automatiquement votre contenu en plusieurs langues grâce à GitBook Agent et gardez-le synchronisé

{% hint style="info" %}
Seuls les [administrateurs de l’organisation](https://gitbook.com/docs/documentation/fr/collaborate/member-management/roles.md#admin) peuvent créer et accéder aux traductions, car il s’agit [d’une fonctionnalité payante](#pricing).
{% endhint %}

Les auto-traductions facilitent la mise à jour de votre documentation dans plusieurs langues, avec un minimum d’efforts manuels. Vous pouvez créer une section comme traduction d’une autre et laisser GitBook Agent s’occuper du reste.

<figure><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-3777238cc7776f4b7fc0f67870454e27b06d7578%2F25_12_10_create_translation%402x.png?alt=media" alt=""><figcaption></figcaption></figure>

## Comment fonctionnent les traductions

* **Créer une section traduite :** Configurez une nouvelle section en tant que traduction d’une section existante. Choisissez votre section source et la langue cible.
* **Mises à jour continues :** Chaque fois que vous modifiez le contenu source, le processus de traduction ne s’exécute que pour les **pages qui ont été modifiées**.
* **Synchronisation automatique :** Une fois les modifications fusionnées, le processus de traduction **s’exécute automatiquement** et se synchronise avec la source, afin que votre section traduite reflète toujours les dernières mises à jour.

{% hint style="info" %}
Les slugs des pages des sections traduites automatiquement peuvent changer, sauf si la page a un slug fixe. Pour conserver des URL stables d’une langue à l’autre, définissez un slug fixe avant de lancer la traduction. Pour modifier un slug, consultez [Comment modifier le slug dans l’URL ?](https://app.gitbook.com/s/Ua3kTfM3iWAoECzM0u90/published-documentation/custom-domains/how-can-i-change-the-slug-in-the-url)
{% endhint %}

## Configurer une traduction automatique

Pour traduire une section dans une nouvelle langue, retournez à l’accueil de votre organisation **Accueil** et cliquez sur **Traductions** dans la barre latérale, puis cliquez sur **Créer une traduction**.

Dans la fenêtre modale **Créer une traduction** , choisissez :

* **Source** — la section que vous souhaitez traduire.
* **De** langue.
* **Vers** langue.

Cliquez sur **Créer** pour lancer le processus de traduction. Ces options serviront à traduire votre section en une section dupliquée et traduite dans votre organisation.

L’écran **Traductions** répertorie également vos processus de traduction configurés, avec leur état, leur source, leurs exécutions, ainsi que les pages et les mots traduits. Les processus sont relancés chaque fois que le contenu source est mis à jour.

### Configuration avancée

Cliquez sur **Afficher les instructions avancées** dans la fenêtre modale **Créer une traduction** pour configurer ces options.

**Instructions personnalisées pour l’IA :** Ajoutez des instructions avancées pour orienter l’IA sur le ton, le style ou d’autres préférences. Cela permet de garantir que vos traductions correspondent à votre marque ou à votre public.

{% hint style="info" %}
L’ajout d’instructions personnalisées à votre flux de travail de traduction peut être utile, mais il est limité dans certains cas.

Les instructions personnalisées ne peuvent pas être utilisées pour créer de nouveaux éléments dans une section traduite, ajouter du texte supplémentaire ou modifier la structure du contenu source.
{% endhint %}

**Prise en charge du glossaire :** Définissez un glossaire pour contrôler la traduction de termes spécifiques. Cela garantit la cohérence de la terminologie dans toutes les langues prises en charge.

Les termes de votre glossaire doivent correspondre au libellé dans la langue source que vous souhaitez contrôler. GitBook les applique pendant les exécutions de traduction afin de maintenir une terminologie cohérente.

Par exemple, si votre langue source est l’anglais et que votre glossaire contient `SSO` → `SSO` et `Git Sync` → `Git Sync`, une phrase comme « Configurer le SSO avec Git Sync » conserve ces termes tels quels dans la traduction.

{% hint style="warning" %}
**La modification de votre glossaire déclenchera une retraduction complète de votre contenu**. Il n’existe actuellement aucune solution de contournement : nous ne pouvons pas détecter de manière fiable les pages susceptibles de contenir un terme du glossaire. L’approche la plus sûre consiste donc à retraduire toutes les pages. La mise à jour du glossaire peut ainsi prendre du temps et coûter cher.
{% endhint %}

## Ajouter une traduction à une variante

Après avoir créé une traduction, vous pourrez l’ajouter à un site de documentation publié en tant que [variante](https://gitbook.com/docs/documentation/fr/manage-your-site/site-structure/variants.md). Les utilisateurs pourront ainsi passer d’une langue à l’autre dans le coin supérieur droit lorsqu’ils consulteront votre site de documentation principal.

{% hint style="info" %}
Pour offrir la meilleure expérience à vos utilisateurs, vous pouvez définir la langue par défaut d’une variante lors de sa configuration dans vos paramètres.

Il est recommandé d’ajouter la langue de votre section traduite lors de la configuration de votre variante.
{% endhint %}

Pour configurer une nouvelle variante pour une traduction, ouvrez l’éditeur de structure depuis **Structure du site** dans la barre latérale du site.

## Tarification

Les traductions sont une option payante. Nous facturons les traductions selon le même cycle mensuel ou annuel que votre abonnement principal.

* Tarif mensuel : 25 $ par mois pour jusqu’à 50 000 mots traduits chaque mois.
* Tarif annuel : 250 $ par an pour jusqu’à 50 000 mots traduits chaque mois.
* 0,20 $ par tranche supplémentaire de 1 000 mots.

Le quota mensuel se réinitialise au début de chaque mois. Le tarif de 0,20 $ s’applique à chaque tranche supplémentaire de 1 000 mots, y compris pour les abonnements annuels.

« Mensuel » décrit le tarif et le quota de mots. Cela ne décrit pas le cycle de facturation.

Pour votre première traduction, chaque mot sera pris en compte dans votre facture. Ensuite, seuls les **pages** contenant de nouveaux mots ou des mots modifiés sont facturées. Par exemple, si vous modifiez votre documentation par la suite, seules les pages contenant de nouveaux mots seront prises en compte dans votre limite de mots : vous ne serez pas facturé une deuxième fois pour l’ensemble du document.

{% hint style="warning" %}
Faites preuve de prudence lorsque vous travaillez sur plusieurs traductions avec de grandes pages, car le nombre de mots traduits inclut tous les mots d’une page qui contient une modification — ce qui signifie que si seuls quelques mots changent dans une grande page, la page entière sera retraduite.
{% endhint %}

## FAQ

<details>

<summary>Pourquoi utiliser les traductions automatiques ?</summary>

* **Une documentation multilingue sans effort :** Touchez un public international sans travail de traduction manuel.
* **Mises à jour intelligentes :** Seules les pages modifiées sont retraduites, ce qui vous fait gagner du temps et économiser des ressources.
* **Contrôle total :** Personnalisez les traductions grâce à des instructions avancées et à la gestion du glossaire.

</details>

<details>

<summary>Puis-je modifier la traduction ?</summary>

Vous ne pouvez pas modifier les traductions.

Comme les traductions sont réalisées comme une transformation pure du contenu source, nous ne pouvons pas concilier d’éventuelles modifications apportées au résultat traduit avec une nouvelle traduction.

Pour le contourner, nous recommandons le processus suivant :

* Utilisez le glossaire pour définir les traductions spécifiques que vous souhaitez voir l’IA utiliser
* Utilisez les instructions personnalisées pour itérer sur le résultat

</details>

<details>

<summary>Combien de traductions dois-je créer ?</summary>

Vous ne devez créer qu’ **un seul workflow de traduction par langue** pour un contenu source donné. La création de plusieurs workflows entraînera des coûts supplémentaires et redondants pour votre organisation.

</details>

<details>

<summary>Quelles sont les limitations actuelles ?</summary>

* Les traductions ne localisent pas automatiquement les éléments d’interface de votre variante. Ouvrez **Personnaliser** dans la barre latérale du site pour [localiser l’interface](https://gitbook.com/docs/documentation/fr/manage-your-site/customization/extra-configuration.md#localize-user-interface) pour une [variante spécifique](https://gitbook.com/docs/documentation/fr/manage-your-site/customization.md#customizing-sites-with-multiple-sections-or-variants).
  * Cela inclut les personnalisations saisies par l’utilisateur, comme les bannières d’annonce.
* Les traductions ne peuvent pas ajouter de contenu supplémentaire à la page, comme une remarque ou une bannière indiquant qu’une page a été traduite par une IA. Vous pouvez ajouter une page supplémentaire à la section traduite pour le préciser, ou utiliser la [bannière d’annonce](https://gitbook.com/docs/documentation/fr/manage-your-site/customization/layout-and-structure.md#announcement-premium-and-ultimate) dans votre variante de site.
* La modification du glossaire déclenche une retraduction complète de toutes les pages, ce qui peut augmenter le temps de traitement et le coût. Il n’existe actuellement aucune retraduction partielle basée sur l’utilisation du glossaire.

</details>

Si vous avez besoin d’aide pour démarrer ou souhaitez en savoir plus sur la configuration des traductions automatiques, [contactez notre équipe d’assistance](broken://pages/4afd87f6e45ac8235e009664242ddf1579458590).


---

# 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/agent-gitbook/translations.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.
