# General Translation Platform: Traduzione delle stringhe
URL: https://generaltranslation.com/it/docs/platform/core/guides/translating-strings.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Come tradurre stringhe e contenuti strutturati dal codice con la libreria generaltranslation.

Puoi usare [translate](/docs/platform/core/reference/gt-class-methods/translation/translate) e [translateMany](/docs/platform/core/reference/gt-class-methods/translation/translate-many) per tradurre le stringhe direttamente dal codice.

Usa la traduzione delle stringhe quando la tua app, il tuo script o il tuo servizio richiede contenuti tradotti in fase di esecuzione, invece di tradurre un intero file.

## Prima di iniziare [#before-start]

Assicurati di aver completato il [Quickstart](/docs/platform/core/quickstart) per installare `generaltranslation` e inizializzare la classe [GT](/docs/platform/core/reference/gt-class/constructor).

## Traduci una stringa [#translate-one-string]

Chiama [translate](/docs/platform/core/reference/gt-class-methods/translation/translate) con la stringa sorgente e l'impostazione regionale di destinazione.

Se la tua istanza di [GT](/docs/platform/core/reference/gt-class/constructor) ha un [targetLocale](/docs/platform/core/reference/types/gt-constructor-params), puoi omettere l'impostazione regionale di destinazione dalla chiamata del metodo. Questo è utile quando uno script o un servizio traduce molte stringhe nella stessa impostazione regionale.

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

(Per maggiori informazioni, consulta il metodo [translate](/docs/platform/core/reference/gt-class-methods/translation/translate)).

## Traduci molte stringhe [#translate-many-strings]

Chiama [translateMany](/docs/platform/core/reference/gt-class-methods/translation/translate-many) per tradurre in modo efficiente più contenuti in un'unica richiesta API. È ottimizzato per l'elaborazione in batch e offre prestazioni migliori rispetto a più chiamate singole a [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'
);
```

(Per maggiori informazioni, consulta il metodo [translateMany](/docs/platform/core/reference/gt-class-methods/translation/translate-many)).

## Aggiungi contesto con i metadati sorgente [#add-context-source]

Usa i metadati quando una stringa necessita di ulteriore contesto.

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

I metadati sono utili per parole ambigue, etichette dell'interfaccia utente, termini specifici del prodotto e stringhe difficili da comprendere senza il contesto in cui compaiono.

## 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.