# gt-next: General Translation Next.js SDK: getGT
URL: https://generaltranslation.com/it/docs/next/api/strings/get-gt.mdx
---
title: getGT
description: Riferimento API per la funzione getGT() di traduzione delle stringhe
---

## Panoramica

La funzione `getGT` è una funzione asincrona che serve a tradurre stringhe in fase di build.

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

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

<Callout>
  **Traduzione in fase di build:**
  Le traduzioni con `getGT` avvengono in fase di build, prima del deployment dell&#39;app.
  Anche se puoi passare variabili alla stringa tradotta, puoi tradurre solo contenuti noti in fase di build.
</Callout>


## Riferimento

### Parametri

Nessuno

### Restituisce

Una promise di una funzione di callback, `gt`, che traduce il contenuto specificato.

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

| Nome       | Tipo                                                                          | Descrizione                                                        |
| ---------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------ |
| `content`  | `string`                                                                      | Il contenuto testuale da tradurre.                                 |
| `options?` | [`InlineTranslationOptions`](/docs/next/api/types/inline-translation-options) | Opzioni di traduzione per personalizzare il comportamento di `gt`. |

***


## Comportamento

### Produzione

Durante il processo di CD, qualsiasi contenuto all&#39;interno di una funzione `gt` verrà tradotto prima del deployment dell&#39;applicazione.
Questo garantisce tempi di caricamento rapidi per tutte le impostazioni regionali, ma può tradurre solo i contenuti noti in fase di build.

Una volta generate, le traduzioni vengono (1) archiviate nella CDN oppure (2) incluse nell&#39;output di build della tua app, in base alla configurazione.
Da lì, il contenuto tradotto viene servito agli utenti.
Se una traduzione non viene trovata, verrà usato come fallback il contenuto originale.

Assicurati di seguire la [guida al deployment qui](/docs/next/tutorials/quickdeploy).

### Sviluppo

Durante lo sviluppo, la funzione `gt` tradurrà i contenuti on demand.
Questo è utile per farti un&#39;idea di come apparirà la tua app in lingue diverse.
Ricorda di aggiungere una chiave API Dev al tuo ambiente per abilitare questo comportamento.

Durante la traduzione on demand in fase di sviluppo noterai un ritardo.
Questo non si verificherà nelle build di produzione, a meno che il contenuto non venga tradotto esplicitamente on demand,
ovvero usando [`tx`](/docs/next/api/strings/tx) o [`<Tx>`](/docs/next/api/components/tx).

***

## Esempio

### Utilizzo di base

Puoi usare `getGT` per tradurre stringhe.

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

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

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

Nota: &quot;Alice&quot; verrà tradotto nella lingua preferita dall&#39;utente.


### Uso delle variabili [#variables]

Puoi passare variabili alle traduzioni del dizionario.

```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>
  );
}
```

Nota: &quot;Alice&quot; non verrà tradotto nella lingua preferita dell&#39;utente perché è una variabile.


### Tradurre i metadati della pagina [#metadata]

Usa `getGT` nella funzione Next.js `generateMetadata` per tradurre titoli di pagina, descrizioni e tag 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'),
    },
  };
}
```


### Uso del formato di messaggi ICU

`gt-next` supporta il formato di messaggi ICU, che consente anche di formattare le variabili.

```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>
  Il formato dei messaggi ICU è un modo potente per formattare le variabili.
  Per ulteriori informazioni, consulta la [documentazione sul formato dei messaggi ICU](https://unicode-org.github.io/icu/userguide/format_parse/messages/).
</Callout>

***


## Note

* `getGT` è una funzione lato server che traduce le stringhe.
* La traduzione delle stringhe con `getGT` avviene prima del runtime, durante il processo di build (tranne che in sviluppo).

## Passaggi successivi

* Consulta [`useGT`](/docs/next/api/strings/use-gt) per la traduzione lato client delle stringhe in fase di build.
* Per le traduzioni runtime, consulta [`tx`](/docs/next/api/strings/tx) e [`<Tx>`](/docs/next/api/components/tx).