# Traductions {% hint style="info" %} Seuls [administrateurs de l’organisation](/docs/documentation/fr/collaboration/member-management/roles.md#admin) peuvent créer et accéder aux traductions, car c’est [une fonctionnalité payante](#pricing). {% endhint %} Les traductions automatiques facilitent la mise à jour de votre documentation en plusieurs langues, avec un minimum d’effort manuel. Vous pouvez créer un espace comme traduction d’un autre, et laisser GitBook Agent s’occuper du reste.
## Comment fonctionnent les traductions * **Créer un espace de traduction :** Configurez un nouvel espace comme traduction d’un espace existant. Choisissez votre espace source et la langue cible. * **Mises à jour continues :** Chaque fois que vous apportez des modifications au contenu source, le workflow de traduction ne s’exécute que pour les **pages qui ont été modifiées**. * **Synchronisation automatique :** Après la fusion des modifications, le workflow de traduction **s’exécute automatiquement** et se synchronise avec sa source, afin que votre espace traduit reflète toujours les dernières mises à jour. ## Configurer une traduction automatique Pour traduire un espace dans une nouvelle langue, commencez par créer un nouvel [espace](/docs/documentation/fr/creating-content/content-structure/space.md#create-a-space) dans votre organisation. Dans la fenêtre modale qui apparaît, cliquez sur **Traduction** dans le menu des actions rapides. Dans la fenêtre modale qui apparaît, vous devrez choisir : * Source * Langue source * Langue cible Ces options seront utilisées pour traduire votre espace en un espace dupliqué et traduit dans votre organisation. Vous verrez également un aperçu rapide du coût de la traduction de votre espace. ### Configuration avancée **Instructions IA personnalisées :** Ajoutez des instructions avancées pour guider 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 workflow 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 un espace traduit, 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 manière dont des termes spécifiques sont traduits. Cela permet de conserver une terminologie cohérente dans toutes les langues prises en charge. {% hint style="warning" %} **Modifier 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 quelles pages pourraient contenir un mot-clé du glossaire, donc l’approche la plus sûre consiste à retraduire toutes les pages. La mise à jour du glossaire peut donc être longue et coûteuse. {% endhint %} ## Ajouter une traduction à un variant Après avoir créé une traduction, vous pourrez l’ajouter au site de documentation publié en tant que [variante](/docs/documentation/fr/docs-site/site-structure/variants.md). Cela permettra aux utilisateurs de basculer entre les langues dans le coin supérieur droit lorsqu’ils consultent 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’un variant lors de sa configuration dans vos paramètres. Il est recommandé d’ajouter la langue de votre espace traduit lors de la configuration de votre variant. {% endhint %} Rendez-vous dans les paramètres de votre site, sous l’onglet Structure, pour configurer un nouveau variant pour les traductions que vous avez. ## Tarification Les traductions sont un **mensuellement** module complémentaire payant : * 25 $ pour jusqu’à 50 000 mots traduits * 0,20 $ par tranche supplémentaire de 1 000 mots Chaque mois comprend 50 000 mots de traduction pour 25 $. Au-delà, chaque tranche supplémentaire de 1 000 mots coûte 0,20 $. Votre quota de 50 000 mots est réinitialisé au début de chaque mois. Lors de votre première traduction, chaque mot comptera dans votre facture. Ensuite, seuls **pages** les mots nouveaux ou mis à jour sont facturés. Par exemple, si vous modifiez vos docs plus tard, seules les pages contenant de nouveaux mots seront comptabilisées dans votre limite de mots — vous ne serez pas refacturé pour l’ensemble du document. {% hint style="warning" %} Soyez prudent lorsque vous travaillez sur plusieurs traductions comportant de grandes pages, car le nombre de mots traduits inclut tous les mots d’une page contenant une modification — ce qui signifie que si seuls quelques mots sont modifiés dans une grande page, l’intégralité de la page sera retraduite. {% endhint %} ## FAQ
Pourquoi utiliser les traductions automatiques ? * **Documentation multilingue sans effort :** Atteignez un public mondial sans travail de traduction manuelle. * **Mises à jour intelligentes :** Seules les pages modifiées sont retraduites, ce qui permet d’économiser du temps et des ressources. * **Contrôle total :** Personnalisez les traductions avec des instructions avancées et la gestion du glossaire.
Puis-je modifier la traduction ? Vous ne pouvez pas encore modifier les traductions. Comme les traductions sont effectuées comme une simple transformation du contenu source, nous ne pouvons pas réconcilier d’éventuelles modifications apportées au résultat de la traduction avec une nouvelle traduction. Pour contourner ce problème, nous recommandons le processus suivant : * Utilisez le glossaire pour définir les traductions spécifiques que vous souhaitez que l’IA utilise * Utilisez les instructions personnalisées pour itérer sur le résultat
Combien de traductions dois-je créer ? Vous ne devriez créer que **un workflow de traduction par langue** pour tout contenu source donné. La création de plusieurs workflows entraînera des coûts supplémentaires et dupliqués dans votre organisation.
Quelles sont les limitations actuelles ? * Les traductions ne localisent pas automatiquement les éléments d’interface utilisateur dans votre variant. Rendez-vous dans les paramètres de personnalisation de votre site pour [localiser l’interface](/docs/documentation/fr/docs-site/customization/extra-configuration.md#localize-user-interface) pour un [variant spécifique](/docs/documentation/fr/docs-site/customization.md#customizing-sites-with-multiple-sections). * Cela inclut les personnalisations saisies par les utilisateurs, comme les bannières d’annonce. * Les traductions ne peuvent pas ajouter de contenu supplémentaire à la page — comme un conseil ou une bannière indiquant qu’une page a été traduite par l’IA. Envisagez d’ajouter une page supplémentaire dans l’espace traduit pour le préciser, ou la [bannière d’annonce](/docs/documentation/fr/docs-site/customization/layout-and-structure.md#announcement-premium-and-ultimate) dans le variant de votre site. * Modifier le 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 pas à ce jour de retraduction partielle basée sur l’utilisation du glossaire.
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](https://gitbook.com/docs/help-center/further-help/how-do-i-contact-support). --- # Agent Instructions: 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: ``` GET https://gitbook.com/docs/documentation/fr/gitbook-agent/translations.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.