---
title: Traduction IA
sidebarTitle: Traduction IA
description: "Activez les langues de votre choix : Jamdesk traduit votre documentation après chaque build et commite les pages traduites dans votre propre dépôt GitHub."
---

> **For AI agents:** the complete documentation index is at [llms.txt](/docs/llms.txt). Append `.md` to any page URL for its markdown version.

Jamdesk peut traduire votre documentation à votre place. Choisissez les langues voulues dans les paramètres du projet, et après chaque build, Jamdesk traduit vos pages anglaises et commite les résultats dans votre propre dépôt GitHub, dans des répertoires préfixés par la langue. Les traductions vous appartiennent : elles se trouvent dans votre dépôt et votre historique Git, et vous pouvez les modifier comme n'importe quel autre fichier.

Les captures d'écran montrent l'interface en anglais.

Pour la navigation par locale et le sélecteur de langue, consultez [Support multi-langue](/fr/setup/languages). Cette configuration s'applique que les traductions proviennent de Jamdesk, de vos propres traducteurs ou d'un autre outil.

## Prérequis

- Un [dépôt GitHub connecté](/fr/setup/connecting-github) pour le projet. Les pages traduites sont commitées dans votre dépôt, donc un projet déployé depuis la CLI ou une archive tarball ne peut pas utiliser cette fonctionnalité.
- Un accès en écriture pour la GitHub App de Jamdesk, afin qu'elle puisse effectuer ce commit. Si l'accès est manquant, le panneau Translations l'indique et fournit à un administrateur GitHub un lien pour l'accorder. C'est une étape à effectuer une seule fois par compte GitHub.

Chaque forfait inclut la traduction automatique, y compris les essais. Il n'y a pas de tarification au mot ni de crédits à acheter.

## Activer la fonctionnalité

<Steps>
  <Step title="Ouvrir le panneau Translations">
    Accédez à votre projet dans le [dashboard Jamdesk](https://dashboard.jamdesk.com), ouvrez **Settings**, puis faites défiler jusqu'à **Translations**.
  </Step>

  <Step title="Choisir vos langues">
    Activez **Translate my documentation** et cochez les langues voulues. Chacune est listée par son nom natif, avec le nom anglais à côté.

    <Frame>
      <img src="/images/translations/translations-settings.webp" alt="Le panneau Translations dans les paramètres du projet. Un interrupteur Translate my documentation est activé, au-dessus d'une liste de langues sur deux colonnes avec des cases à cocher. Le chinois simplifié, le portugais, l'allemand et l'italien sont sélectionnés. Chaque langue est listée par son nom natif, avec le nom anglais à côté." />
    </Frame>
  </Step>

  <Step title="Build">
    La traduction s'exécute après la fin d'un build. La première exécution traduit chaque page et commite les fichiers traduits dans votre dépôt, où vous pouvez les examiner comme n'importe quel autre commit.
  </Step>
</Steps>

## Limites

Les deux limites sont par projet :

| Limite | Valeur |
|-------|-------|
| Langues par projet | Jusqu'à 5 |
| Pages traduites par mois | 10 000 |

## Seulement ce qui a changé

La première exécution traduit tout. Ensuite, Jamdesk retraduit uniquement les pages dont la source anglaise a changé, si bien que corriger une faute de frappe sur une page ne coûte qu'une page plutôt que tout votre site. Un site stabilisé n'utilise qu'une petite fraction du quota mensuel.

## Traductions que Jamdesk laisse intactes

Deux types de traduction sont considérés comme rédigés par vous, et Jamdesk ne remplace jamais l'un ou l'autre de sa propre initiative :

- **Traductions déjà existantes.** Si votre dépôt contient déjà des pages traduites lorsque vous activez la fonctionnalité, Jamdesk les adopte au lieu de les écraser. Il conserve exactement le travail que vous avez rédigé vous-même, ou payé un prestataire pour réaliser.
- **Traductions que vous modifiez.** Modifiez une page traduite à la main et Jamdesk le remarque, afin que votre texte survive à chaque exécution ultérieure.

Les deux sont enregistrées de la même façon, et il s'agit d'un blocage permanent : ces pages ne sont plus jamais traduites automatiquement, même après un changement de leur source anglaise. Lorsque l'anglais change, elles apparaissent dans le panneau Translations sous **Edited by hand**.

Chaque page qui y figure dispose d'un bouton **Replace with AI translation**, qui rend cette page à l'IA. Votre version est abandonnée et la page est retraduite lors de votre prochain build, donc rien ne change au moment où vous cliquez. Ce bouton est la seule chose qui lève le blocage.

<Note>
  C'est pourquoi « Seulement ce qui a changé » ne s'applique pas à ces pages. Une page traduite par Jamdesk se met à jour automatiquement quand sa source anglaise change ; une page que vous avez rédigée ou modifiée attend votre demande.
</Note>

## Désactiver une langue

Décocher une langue arrête la traduction de Jamdesk vers celle-ci. Rien n'est supprimé : les pages déjà commitées restent dans votre dépôt, exactement comme elles étaient.

## Et ensuite ?

<Columns cols={2}>
  <Card title="Support multi-langue" icon="language" href="/fr/setup/languages">
    Navigation par locale, sélecteur de langue et style RTL
  </Card>
  <Card title="Connecter GitHub" icon="github" href="/fr/setup/connecting-github">
    Installez la GitHub App et accordez-lui l'accès nécessaire à la traduction
  </Card>
</Columns>
