# gt: General Translation CLI tool: HTML
URL: https://generaltranslation.com/it/docs/cli/formats/html.mdx
---
title: HTML
description: Come usare General Translation per impostare la traduzione automatica dei file HTML
---

## Panoramica

`gt` può essere utilizzato per tradurre automaticamente i file HTML.

<Callout type="info">
  Tutta la sintassi e la formattazione presenti nei file originali saranno 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 la chiave API 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 principale del progetto con il seguente contenuto:

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

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

L&#39;array di stringhe nella chiave `include` deve essere un pattern glob che corrisponda a tutti i file HTML.

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

Per ulteriori 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ì le traduzioni verranno aggiunte automaticamente 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 impostazioni regionali del tuo progetto e le salverà nel progetto.
Se vuoi eseguire il commit di questi file nel repository, puoi invece usare questo comando prima di effettuare il commit.

Hai finito! Ora il tuo progetto aggiornerà automaticamente tutti i file HTML a ogni modifica del progetto.

***


## 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 d&#39;uso della CLI.