Panoramica

Questo tutorial mostra come gestire automaticamente i file di traduzione del tuo progetto se usi i18next.

Seguiremo questi 4 passaggi:

Passaggio 1: Aggiungi le variabili d’ambiente

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

GT_API_KEY=<your-api-key>
GT_PROJECT_ID=<your-project-id>

Passaggio 2: Installare gtx-cli

Installa lo strumento gtx-cli nel tuo 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 root del tuo progetto.

{
  "defaultLocale": "en",
  "locales": ["zh", "es", "ja"],
  "files": {
    "json": {
      "include": ["messages/[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 && <tuo comando di build>"
  }
}

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

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

Note

• Puoi aggiungere automaticamente le traduzioni al tuo progetto con il comando gtx-cli translate.
• Se vuoi eseguire il commit dei 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.