# General Translation Platform: Traduire des chaînes
URL: https://generaltranslation.com/fr/docs/platform/core/guides/translating-strings.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Comment traduire des chaînes et du contenu structuré dans le code avec la bibliothèque generaltranslation.

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 de caractères [#translate-one-string]

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

Indiquez explicitement un paramètre régional cible, même si l’instance en définit un par défaut. La signature TypeScript exige le second argument ; sous forme d’objet, [`TranslateOptions`](/docs/platform/core/reference/types/translation-config#translate-options) exige `targetLocale`.

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

## Sitemap

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