Dashboard
Config

gt.config.json

File gt.config.json

Panoramica

Il file gt.config.json memorizza la configurazione del tuo progetto. Contiene informazioni importanti come il projectId del progetto, i locali supportati e altro ancora. Include anche informazioni interne rilevanti, come il versionId del progetto.

Questo file viene letto (1) dal componente withGTConfig e (2) dal comando gtx-cli translate. Per questo motivo, consigliamo di conservare la configurazione nel file gt.config.json invece di passarla come prop al componente withGTConfig.

In generale, qualsiasi elemento che inizi con un underscore (ad es. _versionId) è una proprietà interna e non dovrebbe essere modificata. Tutto il resto può essere gestito liberamente.

Campi

CampoTipoDescrizione
projectIdstringIdentificatore univoco del progetto nel sistema GT
localesstring[]Elenco dei codici locale supportati per il progetto
defaultLocalestringCodice locale principale usato come fallback quando mancano traduzioni
cacheUrlstringEndpoint URL per la cache dei dati di traduzione
runtimeUrlstringEndpoint URL per i servizi di traduzione in runtime
stageTranslationsbooleanConfigurazione per le funzionalità di traduzione in staging/anteprima
filesobjectPercorso dei file di traduzione locali per sviluppo e test
_versionIdstringProprietà interna usata per tenere traccia della versione del progetto (non modificare)

cacheUrl e runtimeUrl

Se archivi le traduzioni nel cloud, cacheUrl è l’URL di base della cache. runtimeUrl è l’URL di base del runtime e si applica solo alle traduzioni in sviluppo.

stageTranslations

stageTranslations è un flag utilizzato dallo strumento gtx-cli per contrassegnare le traduzioni come da revisionare. Questo significa che devono essere approvate manualmente prima di poter essere distribuite in produzione tramite il comando gtx-cli translate.

files

Il campo files indica il percorso delle traduzioni archiviate localmente (anziché nel cloud). In particolare, il campo output indica dove verranno scritte le traduzioni.

{
  "files": {
    "gt": {
      "output": "public/_gt/[locale].json"
    }
  },
}

Consulta la documentazione di configurazione dello strumento CLI per ulteriori informazioni su come utilizzare il campo files.

Esempi

Specificare le proprie locale

gt.config.json
{
  "defaultLocale": "en", // La locale principale è l'inglese
  "locales": ["fr", "es"] // Le locale secondarie sono francese e spagnolo
}

Note

  • Il file gt.config.json viene usato per specificare la configurazione del progetto.
  • Viene letto sia dal componente withGTConfig sia dal comando gtx-cli translate.

Passaggi successivi

Come valuti questa guida?

In questa pagina

Panoramica
Campi
cacheUrl e runtimeUrl
stageTranslations
files
Esempi
Specificare le proprie locale
Note
Passaggi successivi
gt.config.json