> 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/gitbook-agent/translations.md). # Traductions {% hint style="info" %} Uniquement [administrateurs de l’organisation](/docs/documentation/fr/collaborer/member-management/roles.md#admin) peuvent créer et accéder aux traductions, car c’est [une fonctionnalité facturable](#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 une section comme traduction d’une autre, et laisser GitBook Agent s’occuper du reste.
## Comment fonctionnent les traductions * **Créez 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 flux de travail de traduction ne s’exécute que pour les **pages qui ont été modifiées**. * **Synchronisation automatique :** Une fois les changements fusionnés, le flux de travail de traduction **s’exécute automatiquement** et se synchronise avec sa source, de sorte que votre section traduite reflète toujours les dernières mises à jour. {% hint style="info" %} Les identifiants d’URL des pages dans les sections traduites automatiquement peuvent changer, sauf si la page possède un identifiant fixe. Pour conserver des URL stables d’une langue à l’autre, définissez un identifiant fixe avant de traduire. Pour mettre à jour un identifiant, voir [Comment puis-je changer l’identifiant dans l’URL ?](https://app.gitbook.com/s/Ua3kTfM3iWAoECzM0u90/published-documentation/custom-domains/how-can-i-change-the-slug-in-the-url) {% endhint %} ## Configurez une traduction automatique Pour traduire une section dans une nouvelle langue, revenez à votre organisation **Accueil** 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 lancer le flux de travail de traduction. Ces options seront utilisées pour traduire votre section en une section dupliquée et traduite dans votre organisation. Le **Traductions** l’écran répertorie également vos flux de travail de traduction configurés, y compris leur statut, leur source, leurs exécutions, ainsi que les pages et les mots traduits. Les flux de travail sont relancés chaque fois que le contenu source est mis à jour. ### 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. {% hint style="info" %} L’ajout d’instructions personnalisées à votre flux de travail de traduction peut être utile, mais 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 manière dont certains termes sont traduits. Cela permet de conserver une terminologie cohérente 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 lors des exécutions de traduction afin de maintenir une terminologie cohérente. Par exemple, si votre langue source est l’anglais et que votre glossaire inclut `SSO` → `SSO` et `Git Sync` → `Git Sync`, une phrase comme « Set up SSO with Git Sync » conserve ces termes inchangés dans le résultat traduit. {% 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 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 demander beaucoup de temps et coûter cher. {% endhint %} ## Ajouter une traduction à une variante Après avoir créé une traduction, vous pourrez l’ajouter au site de documentation publié en tant que [variante](/docs/documentation/fr/gerer-votre-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 principal de documentation. {% 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**, sous **Général** la barre latérale du site. ## Tarifs 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 par mois * Tarif annuel : 250 $ par an pour jusqu’à 50 000 mots traduits par mois * 0,20 $ par tranche supplémentaire de 1 000 mots Le quota mensuel est réinitialisé 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. Lors de votre première traduction, chaque mot comptera dans votre facture. Ensuite, seuls **les pages** les mots nouveaux ou mis à jour sont facturés. Par exemple, si vous modifiez ensuite votre documentation, seules les pages contenant de nouveaux mots compteront dans votre limite de mots — vous ne serez pas refacturé pour l’ensemble du document. {% hint style="warning" %} Faites preuve de prudence lorsque vous travaillez sur plusieurs traductions comportant 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 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 :** 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 à des 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 transformation pure du contenu source, nous ne pouvons pas concilier d’éventuelles modifications apportées au résultat traduit avec une nouvelle traduction. Pour contourner cela, nous recommandons le flux 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 devriez créer uniquement **un flux de travail de traduction par langue** pour un même contenu source. La création de plusieurs flux de travail 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 **menu Personnaliser**, sous **Outils** dans la barre latérale du site, pour [localiser l’interface](/docs/documentation/fr/gerer-votre-site/customization/extra-configuration.md#localize-user-interface) pour une [variante spécifique](/docs/documentation/fr/gerer-votre-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 un indice ou une bannière indiquant qu’une page a été traduite par l’IA. Pensez à ajouter une page supplémentaire dans la section traduite pour le signaler, ou la [bannière d’annonce](/docs/documentation/fr/gerer-votre-site/customization/layout-and-structure.md#announcement-premium-and-ultimate) dans votre variante du 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 actuellement 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](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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://gitbook.com/docs/documentation/fr/gitbook-agent/translations.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.