# gt-next: General Translation Next.js SDK: getGT
URL: https://generaltranslation.com/fr/docs/next/api/strings/get-gt.mdx
---
title: getGT
description: Référence d’API de la fonction getGT() de traduction de chaînes
---

## Vue d’ensemble

La fonction `getGT` est une fonction asynchrone qui permet de traduire des chaînes au moment du build.

```jsx
const gt = await getGT();

<p>{  gt('This text will be translated')  }</p>;
```

<Callout>
  **Traduction au build :**
  Les traductions `getGT` sont effectuées au build, avant le déploiement de votre application.
  Bien que vous puissiez passer des variables à la chaîne traduite, vous ne pouvez traduire que du contenu connu au moment du build.
</Callout>


## Référence

### Paramètres

Aucun

### Renvoie

Une promesse d’une fonction de rappel, `gt`, qui traduit le contenu fourni.

```jsx
Promise<(content: string, options?: InlineTranslationOptions) => string>
```

| Nom        | Type                                                                          | Description                                                       |
| ---------- | ----------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| `content`  | `string`                                                                      | Le contenu textuel à traduire.                                    |
| `options?` | [`InlineTranslationOptions`](/docs/next/api/types/inline-translation-options) | Options de traduction pour personnaliser le comportement de `gt`. |

***


## Fonctionnement

### Production

Pendant le processus de CD, tout contenu dans une fonction `gt` est traduit avant le déploiement de votre application.
Cela garantit des temps de chargement rapides pour tous les paramètres régionaux, mais ne permet de traduire que le contenu connu au moment du build.

Une fois générées, les traductions sont soit (1) stockées dans le CDN, soit (2) stockées dans la sortie de build de votre application, selon votre configuration.
À partir de là, le contenu traduit est servi à vos utilisateurs.
Si aucune traduction n’est trouvée, le contenu d’origine sera utilisé.

Veillez à consulter le [guide de déploiement ici](/docs/next/tutorials/quickdeploy).

### Développement

Pendant le développement, la fonction `gt` traduit le contenu à la demande.
C’est utile pour visualiser l’apparence de votre application dans différentes langues.
N’oubliez pas d’ajouter une clé d’API de développement à votre environnement pour activer ce comportement.

En développement, la traduction à la demande entraîne un délai.
Cela ne se produit pas dans les builds de production, sauf si le contenu est explicitement traduit à la demande,
c.-à-d. en utilisant [`tx`](/docs/next/api/strings/tx) ou [`<Tx>`](/docs/next/api/components/tx).

***

## Exemple

### Utilisation de base

Vous pouvez utiliser `getGT` pour traduire des chaînes.

```javascript copy
import { getGT } from 'gt-next/server';

export default async function TranslateGreeting() {
  const gt = await getGT();

  return (
    <p>
      {gt('Hello, Alice!')}
    </p>
  );
}
```

Remarque : &quot;Alice&quot; sera traduit dans la langue préférée de l’utilisateur.


### Utiliser des variables [#variables]

Vous pouvez passer des variables aux traductions du dictionnaire.

```javascript copy
import { getGT } from 'gt-next/server';

export default async function TranslateGreeting() {
  const gt = await getGT();

  return (
    <p>
      {gt('Hello, {name}!', { name: 'Alice' })}
    </p>
  );
}
```

Remarque : &quot;Alice&quot; ne sera pas traduit dans la langue préférée de l&#39;utilisateur, car c&#39;est une variable.


### Traduire les métadonnées de page [#metadata]

Utilisez `getGT` dans la fonction `generateMetadata` de Next.js pour traduire les titres de page, les descriptions et les balises Open Graph.

```javascript copy
import { getGT } from 'gt-next/server';
import { Metadata } from 'next';

export async function generateMetadata(): Promise<Metadata> {
  const gt = await getGT();
  return {
    title: gt('My App'),
    description: gt('A fast, modern web application'),
    openGraph: {
      title: gt('My App'),
      description: gt('A fast, modern web application'),
    },
  };
}
```


### Utilisation du format de message ICU

`gt-next` prend en charge le format de message ICU, ce qui vous permet aussi de mettre en forme vos variables.

```javascript copy
import { getGT } from 'gt-next/server';

export default async function TranslateGreeting() {
  const gt = await getGT();
  return (
    <p>
      {gt('There are {count, plural, =0 {no items} =1 {one item} other {{count} items}} in the cart', { count: 10 })}
    </p>
  );
}
```

<Callout>
  Le format de message ICU est un moyen efficace de formater vos variables.
  Pour en savoir plus, consultez la [documentation sur le format de message ICU](https://unicode-org.github.io/icu/userguide/format_parse/messages/).
</Callout>

***


## Notes

* La fonction `getGT` est une fonction côté serveur qui traduit des chaînes de caractères.
* Les traductions de chaînes avec `getGT` ont lieu avant runtime, pendant le processus de build (sauf en développement).

## Étapes suivantes

* Consultez [`useGT`](/docs/next/api/strings/use-gt) pour la traduction des chaînes côté client au build.
* Pour les traductions en runtime, consultez [`tx`](/docs/next/api/strings/tx) et [`<Tx>`](/docs/next/api/components/tx).