Panoramica

In questo tutorial vedrai come gestire automaticamente i file di traduzione del tuo progetto se utilizzi next-intl.

Segui questi 4 passaggi:

Passaggio 1: aggiungi le variabili d’ambiente

Aggiungi la chiave API di produzione e l’ID progetto alle variabili d’ambiente. Questo è necessario per utilizzare lo strumento gtx-cli. Puoi recuperarli dalla dashboard di General Translation.

GT_API_KEY=<tua-chiave-api>
GT_PROJECT_ID=<tuo-id-progetto>

Passaggio 2: installa gtx-cli

Installa lo strumento gtx-cli nel progetto.

npm i gtx-cli

yarn add --dev gtx-cli

bun add --dev gtx-cli

pnpm add --save-dev gtx-cli

Passaggio 3: crea un file gt.config.json

Crea un file gt.config.json nella directory principale del tuo progetto.

{
  "defaultLocale": "it",
  "locales": ["zh", "es", "ja"],
  "files": {
    "json": {
      "include": ["i18n/[locale]/*.json"]
    },
  },
}

Puoi personalizzare il file gt.config.json in base alle tue esigenze. Consulta la documentazione di configurazione per maggiori informazioni.

Aggiorna il formato del file json in modo che il percorso include corrisponda alla struttura del tuo progetto.

Passaggio 4: aggiungi il comando gtx-cli translate al processo di build

Aggiungi il comando gtx-cli translate al processo di build o di CI prima del comando di build per aggiungere automaticamente le traduzioni al progetto.

{
  "scripts": {
    "translate": "npx gtx-cli translate",
    "build": "npm run translate && <il tuo comando di compilazione>"
  }
}

Questo genererà le traduzioni per tutte le tue lingue locali e le salverà nel progetto. Se vuoi aggiungere questi file al tuo repository, puoi eseguire questo comando prima di effettuare il commit.

Tutto fatto! Ora il progetto aggiornerà automaticamente tutti i file JSON di traduzione ogni volta che ci saranno modifiche.

Note

• Puoi aggiungere automaticamente le traduzioni al tuo progetto con il comando gtx-cli translate.
• Se vuoi includere nei commit i file di traduzione, puoi eseguire il comando gtx-cli translate prima di effettuare il commit.
• Per configurare il percorso di output delle traduzioni, consulta la documentazione di configurazione.

Prossimi passi

• Consulta la guida all’utilizzo dello strumento CLI.