# General Translation Platform: Définir le contexte des traductions
URL: https://generaltranslation.com/fr/docs/platform/dashboard/guides/defining-context-for-translations.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Comment assurer la cohérence de la terminologie, du ton et du style dans toutes vos traductions à l’aide des groupes de contexte.

Définissez des traductions de qualité optimale pour votre produit, y compris la terminologie clé, la voix de votre marque et le style. Utilisez les groupes de contexte pour appliquer des consignes communes à votre application, votre site web, votre documentation, vos diapositives et tous les autres espaces destinés aux utilisateurs.

## Workflow contextuel de base [#basic-context-workflow]

1. Ouvrez votre organisation dans le **[Dashboard](https://dash.generaltranslation.com)**.
2. Accédez à la page **contexte**.
3. Créez un **groupe de contexte**.
4. Ajoutez un **glossaire** (pour la terminologie) et des **instructions personnalisées** (pour le style et le ton).
5. **Associez** votre groupe de contexte aux projets concernés.
6. Générez vos traductions ou appliquez les mises à jour aux traductions existantes.

## Que sont les groupes de contexte ? [#context-groups]

Les **groupes de contexte** sont des ensembles d’instructions réutilisables pour la traduction. Attribuez un groupe à un ou plusieurs projets afin d’assurer une terminologie et un ton cohérents dans l’ensemble des traductions. *Par exemple, un même groupe de contexte peut être appliqué à votre application, votre site web, votre documentation et vos présentations commerciales.*

a) Le **glossaire** définit la terminologie à utiliser et la manière de traiter les termes clés, notamment les termes relatifs aux produits, les noms de marque, les fonctionnalités et les termes techniques. *Exemple : conservez « Locadex » non traduit dans tous les paramètres régionaux.*

b) Les **instructions personnalisées** définissent le style des traductions, notamment le public cible, le niveau de formalité, le ton, les conventions et le formatage. *Exemple : utilisez la voix active, évitez le jargon et employez le vouvoiement formel « Sie ».*

Les groupes de contexte sont définis au niveau de l’organisation. Nous vous recommandons d’appliquer un groupe de contexte à l’ensemble de vos projets, puis d’ajouter des groupes de contexte spécifiques à certains projets si les différentes interfaces présentent des différences de terminologie ou de style.

## Utiliser des termes clés dans le glossaire [#using-key-terms]

Utilisez le glossaire pour les mots et expressions qui nécessitent un traitement cohérent dans l’ensemble des traductions. Les termes du glossaire sont utiles pour :

* Noms de marques
* Noms de produits
* Noms de fonctionnalités
* Termes techniques
* Expressions qui doivent rester non traduites

Ajoutez les termes au groupe de contexte qui doit les gérer. Si le même terme apparaît dans plusieurs groupes attribués, le groupe ayant la priorité la plus élevée prévaut. Si ce groupe ne propose aucune traduction pour une locale cible, c’est la traduction d’un groupe de priorité inférieure qui est utilisée, tandis que la définition du groupe prioritaire continue de s’appliquer (voir [Définir la priorité lorsque les groupes se chevauchent](#priority)).

Utilisez **Rechercher des termes** pour trouver une entrée existante dans le glossaire.

Les termes créés à partir des fichiers sources affichent l’indicateur **Ajouté automatiquement**. Utilisez le filtre situé à côté de la recherche pour n’afficher que les termes **Ajoutés manuellement** ou **Ajoutés automatiquement**. Si vous renommez un terme ajouté automatiquement, modifiez sa définition ou ajoutez une traduction manuellement, il devient un terme ajouté manuellement lors de l’enregistrement.

## Utiliser le style et le ton dans les instructions personnalisées [#using-style-tone]

Utilisez des instructions personnalisées pour définir des consignes de traduction plus générales qu’un seul terme. Les instructions personnalisées sont utiles pour :

* Le style et le ton
* Le public cible
* Le vouvoiement ou le tutoiement
* Les règles de style propres au paramètre régional
* Les consignes propres à un produit ou à un domaine

Chaque instruction personnalisée peut s’appliquer globalement ou à un seul paramètre régional. Utilisez une instruction personnalisée propre à un paramètre régional lorsque les consignes ne doivent s’appliquer qu’à une seule langue cible ou région.

<Callout type="info">
  Lorsque les paramètres régionaux source et cible partagent la même langue et le même système d’écriture, comme `en-US` et `en-GB`, la traduction se limite à une adaptation régionale : elle conserve la formulation source et ne modifie un mot que pour des raisons d’orthographe, de vocabulaire régional, de grammaire, de ponctuation ou de conventions de date, de nombre et d’unité. Les instructions portant sur le ton et le choix des mots ne s’appliquent qu’à ces modifications. Les paramètres régionaux qui partagent une langue mais utilisent des systèmes d’écriture différents, comme `zh-Hans` et `zh-Hant`, sont traduits normalement.
</Callout>

Utilisez **Rechercher des instructions personnalisées** pour filtrer le groupe de contexte actuel.

## Comment créer et attribuer un groupe de contexte [#create-assign-context]

Vous pouvez créer un groupe de contexte depuis la page de votre organisation ou depuis la page d’un projet spécifique.

*Remarque : les groupes de contexte s’appliquent aux nouvelles traductions, mais ne mettent pas automatiquement à jour les traductions existantes. (Consultez [Appliquer les traductions du glossaire](#apply-glossary)).*

### a) Créer un groupe de contexte pour plusieurs projets

*Utilisez le parcours au niveau de l’organisation si vous souhaitez d’abord créer un groupe partagé, puis l’attribuer à un ou plusieurs projets.*

1. Ouvrez **Contexte** dans la barre latérale de l’**[Organisation](https://dash.generaltranslation.com)**.
2. Cliquez sur le signe plus, puis sur **Créer un groupe**.
3. Saisissez un nom et confirmez.
4. Utilisez les onglets **Glossaire** et **Instructions personnalisées** pour ajouter le contexte pertinent.
5. Ouvrez chaque projet concerné.
6. Attribuez le groupe depuis l’onglet **Contexte** du projet.
7. Utilisez le bouton **Traduire** pour générer avec l’IA les traductions des termes du glossaire pour chaque paramètre régional cible.

Les groupes de contexte attribués orientent les nouvelles traductions, y compris celles générées par Locadex.

### b) Créer un groupe de contexte pour votre projet actuel

*Utilisez le parcours au niveau du projet si vous travaillez déjà dans un projet et souhaitez que le groupe lui soit immédiatement attribué.*

1. Ouvrez **Contexte** dans la barre latérale du projet.
2. Cliquez sur le signe plus, puis sur **Créer un groupe**.
3. Saisissez un nom. Pour alimenter le groupe à partir des fichiers sources actuels du projet, sélectionnez **Générer automatiquement à partir des fichiers du projet**. Cliquez ensuite sur **Créer**.
4. Utilisez les onglets **Glossaire** et **Instructions personnalisées** pour ajouter du contexte pertinent.
5. Utilisez le bouton **Traduire** pour générer, à l’aide de l’IA, les traductions des termes du glossaire pour chaque locale cible.

Lorsque vous créez un groupe de contexte depuis un projet, il est toujours créé au niveau de l’organisation. Le Dashboard l’attribue automatiquement au projet actuel.

### c) Importer ou exporter un groupe de contexte existant

*Utilisez le parcours d’importation/exportation pour gérer des groupes de contexte existants.*

<Callout type="info">
  **Développeurs :** pour automatiser les importations, les exportations ou toute autre modification d’un groupe de contexte, utilisez l’[API de gestion du contexte](/docs/platform/openapi/reference/context-groups/list-context-groups) ou ses outils MCP avec une clé d’organisation disposant des permissions **contexte**.
</Callout>

Dans la plupart des cas, vous devez attribuer ou réattribuer directement des projets à des groupes de contexte.

Toutefois, pour des modifications importantes, vous pouvez également utiliser **Exporter** pour télécharger le glossaire et les instructions personnalisées d’un groupe. **Importer** accepte les fichiers CSV, TSV, JSON et texte. Son aperçu ignore les instructions personnalisées, les définitions et les traductions déjà existantes, mais peut inclure les traductions manquantes d’un terme existant.

Le CSV exporté comporte deux sections :

* Les instructions personnalisées, avec les colonnes `name`, `description`, `locale` et `value`.
* Le glossaire, avec les colonnes `term`, `definition` et une colonne `translation_<locale>` par paramètre régional traduit. Un glossaire sans colonne de traduction est également valide.

L’importateur lit ce format à l’identique, y compris les CSV comportant des en-têtes de feuille de calcul empilés. Il accepte également les exportations antérieures qui nomment la section des instructions Directives. Le contenu situé en dehors du format reconnu est interprété par l’IA. Chaque colonne `translation_<locale>` conserve dans son en-tête le code de langue exact, y compris les variantes régionales et d’écriture, et tout [paramètre régional pris en charge](/docs/platform/dashboard/reference/supported-locales) peut être importé, même si le projet ne le cible pas.

Vérifiez le **Résumé d’importation** avant de confirmer. Il répertorie les instructions personnalisées, les termes, les définitions et les traductions qui seront ajoutés. Dans le résumé, sélectionnez un paramètre régional importé pour réaffecter ses traductions avant d’enregistrer. Vous pouvez choisir n’importe quel paramètre régional pris en charge, à l’exception du paramètre régional source ou d’un paramètre régional déjà utilisé par une autre colonne importée. Les traductions du glossaire correspondant à des paramètres régionaux non prises en charge sont ignorées, et ces paramètres régionaux sont répertoriés dans l’aperçu.

## Définir la priorité en cas de chevauchement des groupes [#priority]

Lorsqu’un projet comporte plusieurs groupes attribués, la priorité de contexte détermine quelles instructions prévalent en cas de chevauchement.

* Réorganisez les groupes dans **Projet &gt; Contexte** (le groupe situé en haut a la priorité la plus élevée).
* Les termes nouvellement générés sont enregistrés dans le groupe non verrouillé ayant la priorité la plus élevée. (Voir [Contrôler les mises à jour automatiques](#automatic-updates)).

## Contrôler les mises à jour automatiques [#automatic-updates]

Activez **Automatic Context Update** dans **Projet &gt; Paramètres** pour permettre aux exécutions de traduction d&#39;ajouter du contexte et des termes au glossaire à partir de vos fichiers sources. Par défaut, les nouveaux groupes de contexte acceptent les mises à jour automatiques.

Pour protéger un groupe des modifications automatiques, ouvrez son menu d&#39;actions dans **Projet &gt; Contexte** ou **Organisation &gt; Contexte** et choisissez **Lock**. Une icône de cadenas apparaît alors sur le groupe. Les groupes verrouillés continuent de guider les traductions et peuvent toujours être modifiés manuellement, mais les exécutions de traduction n&#39;y ajoutent ni contexte, ni termes, ni traductions manquantes du glossaire. Choisissez **Unlock** pour réactiver les mises à jour automatiques.

Le contexte et les termes nouvellement générés sont ajoutés au groupe déverrouillé de plus haute priorité assigné au projet. Les traductions manquantes des termes existants du glossaire peuvent également être complétées dans les autres groupes déverrouillés assignés au projet. Si tous les groupes assignés sont verrouillés, aucune modification n&#39;est enregistrée. Si aucun groupe n&#39;est assigné au projet, la première mise à jour automatique en crée un et l&#39;assigne au projet.

## Générer les traductions du glossaire [#generate-glossary]

Utilisez le bouton **Traduire** de la page **Contexte** du projet pour générer des traductions par IA des termes de votre glossaire pour chaque paramètre régional cible.

## Appliquer les traductions du glossaire [#apply-glossary]

*La modification d’un groupe de contexte s’applique à toutes les nouvelles traductions, mais ne met pas automatiquement à jour les traductions existantes.*

Utilisez le bouton **Appliquer** de la page **Contexte** du projet pour mettre à jour le contenu déjà traduit à l’aide des termes du glossaire et des paramètres régionaux sélectionnés.

Pour les fichiers HTML, **Appliquer** met à jour les termes du glossaire sélectionnés dans la traduction existante. L’IA a pour consigne de conserver le texte non concerné, y compris les modifications manuelles ; relisez le résultat une fois les modifications appliquées.

Pour retraduire entièrement un fichier, utilisez plutôt la [CLI](/docs/cli/quickstart) ou lancez une traduction avec [Locadex](/docs/platform/locadex/quickstart).

## Next steps

- /docs/platform/dashboard/guides/reviewing-translations
- /docs/platform/dashboard/guides/adding-annotations
- /docs/platform/dashboard/guides/using-ask-ai
- /docs/platform/dashboard/guides/managing-billing

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.
