Traduction IA
Activez les langues souhaitées : Jamdesk traduit votre documentation après chaque build et envoie les pages traduites vers votre propre dépôt GitHub.
Jamdesk peut traduire votre documentation pour vous. Choisissez les langues que vous voulez dans les paramètres du projet, et après chaque build, Jamdesk traduit vos pages en anglais et envoie les résultats vers 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 langue et le sélecteur de langue, consultez Prise en charge multilingue. Cette configuration s'applique que les traductions viennent de Jamdesk, de vos propres traducteurs, ou d'un autre outil.
Prérequis
- Un dépôt GitHub connecté pour le projet. Les pages traduites sont envoyées vers votre dépôt, donc un projet déployé depuis la CLI ou un tarball ne peut pas utiliser cette fonctionnalité.
- Un accès en écriture pour la GitHub App Jamdesk, afin qu'elle puisse effectuer ce commit. Si l'accès est manquant, le panneau Translations l'indique et propose un lien vers un administrateur GitHub pour l'accorder. C'est une étape unique par compte GitHub.
Chaque plan inclut la traduction automatique, y compris les essais. Il n'y a pas de tarification au mot, ni de crédits à acheter.
Activer la traduction
Accédez à votre projet dans le dashboard Jamdesk, ouvrez Settings, puis faites défiler jusqu'à Translations.
Activez Translate my documentation et cochez les langues que vous voulez. Chacune est répertoriée par son nom natif, avec le nom anglais à côté.
La traduction s'exécute après la fin d'un build. La première exécution traduit toutes les pages et envoie les fichiers traduits vers votre dépôt, où vous pouvez les examiner comme n'importe quel autre commit.
Limites
Les deux limites sont par projet :
| Limite | Valeur |
|---|---|
| Langues par projet | Jusqu'à 5 |
| Pages traduites par mois | 10 000 |
Seul ce qui a changé
La première exécution traduit tout. Ensuite, Jamdesk retraduit uniquement les pages dont la source anglaise a changé, de sorte que corriger une faute de frappe sur une page ne coûte qu'une page, et non l'ensemble de votre site. Un site qui s'est stabilisé n'utilise qu'une petite fraction du quota mensuel.
Traductions que Jamdesk laisse intactes
Deux types de traduction sont considérés comme écrits par vous, et Jamdesk ne remplace jamais l'un ou l'autre de sa propre initiative :
- Les traductions que vous aviez déjà. 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 le travail que vous avez écrit vous-même, ou fait traduire par un prestataire, exactement tel quel.
- Les traductions que vous modifiez. Modifiez une page traduite à la main et Jamdesk le remarque, de sorte que votre formulation survit à chaque exécution ultérieure.
Les deux sont enregistrées de la même manière, et il s'agit d'un blocage permanent : ces pages ne sont plus jamais traduites automatiquement, même après que leur source anglaise a changé. 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 renvoie cette page à l'IA. Votre version est abandonnée et la page est de nouveau traduite lors de votre prochain build, donc rien ne change au moment où vous cliquez. Ce bouton est le seul moyen de lever le blocage.
C'est pourquoi « Seul ce qui a changé » ne s'applique pas à ces pages. Une page traduite par Jamdesk se met à jour automatiquement lorsque sa source anglaise change ; une page que vous avez écrite ou modifiée attend que vous le demandiez.
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à envoyées restent dans votre dépôt, exactement comme elles étaient.