JSON
Come tradurre automaticamente file JSON con General Translation
Panoramica
gtx-cli può essere usato per tradurre automaticamente i file JSON del tuo progetto, indipendentemente dalla libreria i18n che utilizzi.
Nota:
Al momento supportiamo la sintassi e la formattazione personalizzate delle stringhe per le seguenti librerie i18n: next-intl, i18next, gt-next, gt-react.
Se utilizzi un’altra libreria i18n, i risultati della traduzione potrebbero non essere accurati per stringhe con sintassi e formattazioni personalizzate (ad esempio, messaggi ICU). Non vedi la tua libreria preferita? Faccelo sapere e la aggiungeremo appena possibile!
Segui questi 4 passaggi:
Suggerimento:
Evita la gestione dei file di traduzione usando il componente <T>.
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=<your-api-key>
GT_PROJECT_ID=<your-project-id>Passaggio 2: installa gtx-cli
Installa lo strumento gtx-cli nel tuo progetto.
npm i gtx-cliyarn add --dev gtx-clibun add --dev gtx-clipnpm add --save-dev gtx-cliPassaggio 3: crea un file gt.config.json
Crea un file gt.config.json nella radice del tuo progetto.
{
"defaultLocale": "en",
"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 ulteriori informazioni.
Aggiorna il formato del file json in modo che il percorso include rispecchi la struttura del tuo progetto.
Le traduzioni manterranno la sintassi originale delle stringhe.
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 tuo progetto. Se vuoi fare il commit di questi file nel tuo repo, puoi invece eseguire questo comando prima di confermare.
Hai finito! Ora il tuo progetto aggiornerà automaticamente tutti i file JSON di traduzione ogni volta che il progetto cambia.
Note
- Puoi aggiungere automaticamente le traduzioni al tuo progetto con il comando
gtx-cli translate. - Se vuoi includere i file di traduzione nel commit, esegui il comando
gtx-cli translateprima di effettuare il commit. - Per configurare il percorso di output delle traduzioni, consulta la documentazione di configurazione.
Prossimi passaggi
- Consulta la guida all'uso dello strumento CLI.
Come valuti questa guida?