Traductions

Traduisez automatiquement votre contenu en plusieurs langues à l’aide de l’agent IA de GitBook et gardez-le synchronisé

Seulement les administrateurs de l’organisation peuvent créer et accéder aux traductions, car c’est une fonctionnalité facturable.

Les traductions automatiques facilitent la mise à jour de votre documentation dans plusieurs langues, avec un minimum d’effort manuel. Vous pouvez créer une section en tant que traduction d’une autre, et laisser GitBook Agent s’occuper du reste.

Comment fonctionnent les traductions

• Créer une section de traduction : Configurez une nouvelle section comme traduction d’une section existante. Choisissez votre section 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 l’intégration des modifications, le workflow de traduction s’exécute automatiquement et se synchronise avec sa source, afin que votre section traduite reflète toujours les dernières mises à jour.

Les slugs des pages dans les 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 la traduction. Pour mettre à jour un slug, voir Comment puis-je modifier le slug dans l’URL ?

Configurer une traduction automatique

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

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

• Source — la section que vous souhaitez traduire
• De langue
• À langue

Cliquez sur Créer pour démarrer le workflow de traduction. Ces options seront utilisées pour traduire votre section en une section dupliquée et traduite dans votre organisation.

L’ Traductions écran répertorie également les workflows de traduction configurés, y compris leur statut, leur source, leurs exécutions, ainsi que les pages et mots traduits. Les workflows se relancent à chaque mise à jour du contenu source.

Configuration avancée

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

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 aide à garantir que vos traductions correspondent à votre marque ou à votre public.

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 une section traduite, ajouter du texte supplémentaire ou modifier la structure du contenu source.

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.

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 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.

Ajouter une traduction à une variante

Après avoir créé une traduction, vous pourrez l’ajouter au site de documentation publié en tant que variante. Cela permettra aux utilisateurs de basculer entre les langues dans le coin supérieur droit lorsqu’ils consultent votre site de documentation principal.

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.

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

Tarification

Les traductions sont un mensuel 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 se réinitialise au début de chaque mois.

Lors de votre première traduction, chaque mot sera pris en compte dans votre facture. Ensuite, seuls les pages contenant des mots nouveaux ou mis à jour sont facturées. Par exemple, si vous modifiez votre documentation plus tard, seules les pages contenant de nouveaux mots seront prises en compte dans votre limite de mots — vous ne serez pas facturé à nouveau pour l’ensemble du document.

Soyez prudent lorsque vous travaillez sur plusieurs traductions de pages volumineuses, 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, la page entière sera retraduite.

FAQ

Pourquoi utiliser les traductions automatiques ?

• Documentation multilingue sans effort : Touchez un public mondial sans travail de traduction manuel.
• 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 grâce aux instructions avancées et à la gestion du glossaire.

Puis-je modifier la traduction ?

Vous ne pouvez actuellement pas modifier les traductions.

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

Pour contourner cela, nous recommandons le processus suivant :

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

Combien de traductions dois-je créer ?

Vous ne devriez créer qu’ un 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 dans votre organisation.

Quelles sont les limitations actuelles ?

• Les traductions ne localisent pas automatiquement les éléments de l’interface utilisateur dans votre variante. Ouvrez Personnaliser, sous Outils dans la barre latérale du site, pour localiser l’interface pour une variante spécifique.

  • Cela inclut les personnalisations saisies par l’utilisateur, telles que 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 la section traduite pour le préciser, ou la bannière d’annonce 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 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.