Indietro

gt@2.11.0

Fernando Aviles avatarFernando Aviles
gt-clicdnpublishfilesjsonmdxyamli18n

Panoramica

La CLI di GT può ora pubblicare qualsiasi tipo di file tradotto sulla CDN di GT. I file JSON, MDX, YAML e tutti gli altri formati di file supportati possono ora essere pubblicati direttamente tramite i comandi translate, upload e save-local.

Configurazione

Flag globale di pubblicazione

Aggiungi --publish a qualsiasi comando supportato:

npx gt translate --publish

Oppure impostalo in gt.config.json:

{
  "publish": true
}

Questo pubblica tutti i file tradotti (inclusi i file JSON di GT) sulla CDN.

Controllo della pubblicazione per singolo file

Puoi includere o escludere singoli file usando la sintassi dei pattern include. Invece di una semplice stringa glob, usa un oggetto con il flag publish:

{
  "defaultLocale": "en",
  "locales": ["fr", "es"],
  "files": {
    "json": {
      "include": [
        { "pattern": "locales/[locale]/*.json", "publish": true },
        { "pattern": "locales/[locale]/internal/**/*.json", "publish": false }
      ]
    }
  }
}

In questo esempio, tutti i file JSON in locales/[locale]/ vengono pubblicati sulla CDN, ad eccezione dei file nella sottodirectory internal/.

Controllo della pubblicazione JSON di GT

Il formato interno di GT include un proprio flag di pubblicazione nella chiave gt:

{
  "files": {
    "gt": {
      "output": "public/i18n/[locale].json",
      "publish": true
    }
  }
}

Ordine di risoluzione

Per ogni file, la CLI determina se pubblicarlo in questo ordine:

  1. Esclusione esplicita — il file corrisponde a una voce di include con "publish": false → non viene pubblicato oppure viene rimosso dalla CDN
  2. Inclusione esplicita — il file corrisponde a una voce di include con "publish": true → viene pubblicato sulla CDN
  3. Fallback globale — usa l'impostazione publish di primo livello (il valore predefinito è false se non è impostata)

Se non è impostata alcuna configurazione di pubblicazione a nessun livello, il passaggio di pubblicazione viene completamente saltato — non viene effettuata alcuna chiamata API.

Comandi che supportano la pubblicazione

ComandoComportamento
gt translatePubblica dopo il download delle traduzioni
gt uploadPubblica dopo il caricamento dei file sorgente
gt save-localPubblica dopo il salvataggio delle local edits