# General Translation Platform: Traduire des chaînes
URL: https://generaltranslation.com/fr/docs/platform/core/guides/translating-strings.mdx
---

title: Traduire des chaînes
description: Comment traduire des chaînes, des chaînes par lots et du contenu structuré directement dans le code avec la bibliothèque generaltranslation.
related:
  links:
    - /docs/platform/core/guides/translating-files
    - /docs/platform/core/guides/locale-codes

---

Vous pouvez utiliser [translate](/docs/platform/core/reference/gt-class-methods/translation/translate) et [translateMany](/docs/platform/core/reference/gt-class-methods/translation/translate-many) pour traduire des chaînes directement dans le code.

Utilisez la traduction de chaînes lorsque votre application, script ou service a besoin de contenu traduit à l’exécution, plutôt que de traduire un fichier entier.

## Avant de commencer [#before-start]

Assurez-vous d'avoir suivi le [Quickstart](/docs/platform/core/quickstart) pour installer `generaltranslation` et initialiser la classe [GT](/docs/platform/core/reference/gt-class/constructor).

## Traduire une chaîne [#translate-one-string]

Appelez [translate](/docs/platform/core/reference/gt-class-methods/translation/translate) avec la chaîne source et le paramètre régional cible.

Si votre instance [GT](/docs/platform/core/reference/gt-class/constructor) possède un [targetLocale](/docs/platform/core/reference/types/gt-constructor-params), vous pouvez omettre le paramètre régional cible dans l’appel de la méthode. C’est utile lorsqu’un script ou un service traduit un grand nombre de chaînes dans le même paramètre régional.

```typescript title="src/index.ts"
const result = await gt.translate('Hello, world!', 'es');

if (result.success) {
  console.log(result.translation); // "¡Hola, mundo!"
} else {
  console.error(`Translation failed: ${result.error}`);
}
```

Consultez la méthode [translate](/docs/platform/core/reference/gt-class-methods/translation/translate) pour en savoir plus.

## Traduire plusieurs chaînes [#translate-many-strings]

Appelez [translateMany](/docs/platform/core/reference/gt-class-methods/translation/translate-many) pour traduire efficacement plusieurs éléments de contenu en une seule requête API. Cette méthode est optimisée pour le traitement par lots et offre de meilleures performances que plusieurs appels individuels à [translate](/docs/platform/core/reference/gt-class-methods/translation/translate).

```typescript title="src/index.ts"
const results = await gt.translateMany(
  ['Hello, world!', 'Welcome to our app', 'Click here to continue'],
  'es'
);
```

Consultez la méthode [translateMany](/docs/platform/core/reference/gt-class-methods/translation/translate-many) pour en savoir plus.

## Ajouter du contexte à l’aide des métadonnées source [#add-context-source]

Utilisez les métadonnées lorsqu’une chaîne nécessite un contexte supplémentaire.

```typescript title="src/index.ts"
const result = await gt.translate(
  {
    source: 'Cells',
    metadata: {
      context: 'Spreadsheet column header',
    },
  },
  'es'
);
```

Les métadonnées sont utiles pour les mots ambigus, les libellés d’interface utilisateur, les termes propres au produit et les chaînes de caractères difficiles à comprendre sans le contexte qui les entoure.
## Next steps

- /docs/platform/core/guides/translating-files
- /docs/platform/core/guides/locale-codes