# gt: General Translation CLI tool: TypeScript
URL: https://generaltranslation.com/it/docs/cli/formats/ts.mdx
---
title: TypeScript
description: Come tradurre automaticamente i file TypeScript e JavaScript con General Translation
---

## Panoramica

`gt` può essere utilizzato per tradurre automaticamente i file JavaScript (js) e TypeScript (ts) del progetto.

<Callout type="info">
  Tutta la sintassi e la formattazione presenti nei file originali verranno mantenute
  nei file tradotti.
</Callout>

Seguiremo questi 4 passaggi:

<Steps>
  <Step>
    Aggiungi le variabili d&#39;ambiente
  </Step>

  <Step>
    Installa [`gt`](/docs/cli)
  </Step>

  <Step>
    Configura il file [`gt.config.json`](/docs/cli/reference/config) del progetto
  </Step>

  <Step>
    Esegui [`gt translate`](/docs/cli/translate#translate)
  </Step>
</Steps>

***

## Passaggio 1: aggiungi le variabili d&#39;ambiente

Aggiungi l&#39;API key di produzione e l&#39;ID del progetto alle variabili d&#39;ambiente.
Questo è necessario per usare lo strumento `gt`.
Puoi recuperarli dalla [dashboard di General Translation](https://generaltranslation.com/dashboard).

```bash title=".env"
GT_API_KEY=<your-api-key>
GT_PROJECT_ID=<your-project-id>
```


## Passaggio 2: Installa `gt`

Installa lo strumento `gt` nel progetto.

<Tabs items={['npm', 'yarn', 'bun', 'pnpm']}>
  <Tab value="npm">
    ```bash
    npm i gt
    ```
  </Tab>

  <Tab value="yarn">
    ```bash
    yarn add --dev gt
    ```
  </Tab>

  <Tab value="bun">
    ```bash
    bun add --dev gt
    ```
  </Tab>

  <Tab value="pnpm">
    ```bash
    pnpm add --save-dev gt
    ```
  </Tab>
</Tabs>

## Passaggio 3: Configura il file `gt.config.json` del progetto

Crea un file `gt.config.json` nella cartella radice del progetto con il seguente contenuto:

```json title="gt.config.json"
{
  "defaultLocale": "en",
  "locales": ["es", "fr"],
  "files": {
    "ts": {
      "include": ["docs/[locale]/**/*.ts"]
    }
  }
}
```

Modifica `defaultLocale` e `locales` in modo che corrispondano alle impostazioni regionali del tuo progetto.

Se i tuoi file sono file JavaScript, puoi usare la chiave `js` invece di `ts`. L&#39;array di stringhe nella chiave `include` deve essere un pattern glob che corrisponda a tutti i file JS del progetto.

Deve usare il segnaposto `[locale]` per corrispondere all&#39;impostazione regionale del file.

Per maggiori informazioni sul file `gt.config.json`, consulta la documentazione di [configurazione](/docs/cli/reference/config).


## Passaggio 4: aggiungi il comando `gt translate` al processo di build

Aggiungi il comando `gt translate` al processo di build o CI prima del comando di build, così da aggiungere automaticamente le traduzioni al progetto.

```json title="package.json"
{
  "scripts": {
    "translate": "npx gt translate",
    "build": "npm run translate && <your build command>"
  }
}
```

Questo genererà le traduzioni per tutte le tue impostazioni regionali e le salverà nel progetto.
Se vuoi eseguire il commit di questi file nel repository, puoi invece eseguire questo comando prima di effettuare il commit.

Hai finito! Ora il tuo progetto aggiornerà automaticamente tutti i file TypeScript ogni volta che viene modificato.

***


## Note

* Puoi aggiungere automaticamente le traduzioni al tuo progetto con il comando [`gt translate`](/docs/cli/translate).
* Se vuoi includere nel commit i file di traduzione, esegui il comando `gt translate` prima del commit.
* Per configurare il percorso di output delle traduzioni, consulta la documentazione sulla [configurazione](/docs/cli/reference/config).

## Passaggi successivi

* Consulta il [comando translate](/docs/cli/translate) per i dettagli sull&#39;utilizzo della CLI.