Retour

gt@2.11.0

Fernando Aviles avatarFernando Aviles
gt-clicdnpublishfilesjsonmdxyamli18n

Vue d’ensemble

Le GT CLI peut désormais publier tout type de fichier traduit sur le CDN GT. Les fichiers JSON, MDX, YAML et tous les autres types de fichiers pris en charge peuvent désormais être publiés directement depuis les commandes translate, upload et save-local.

Configuration

Indicateur de publication global

Ajoutez --publish à toute commande prise en charge :

npx gt translate --publish

Ou définissez cela dans gt.config.json :

{
  "publish": true
}

Cela publie tous les fichiers traduits (y compris les fichiers GT JSON) sur le CDN.

Contrôle de publication par fichier

Vous pouvez inclure ou exclure des fichiers individuellement à l’aide de la syntaxe du modèle include. Au lieu d’une simple chaîne glob, utilisez un objet avec un indicateur publish :

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

Dans cet exemple, tous les fichiers JSON dans locales/[locale]/ sont publiés sur le CDN, à l’exception des fichiers du sous-répertoire internal/.

Contrôle de publication du JSON GT

Le format interne de GT possède son propre indicateur de publication sous la clé gt :

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

Ordre de résolution

Pour un fichier donné, la CLI détermine l’intention de publication dans cet ordre :

  1. Exclusion explicite — le fichier correspond à une entrée include avec "publish": false → n’est pas publié ou est supprimé du CDN
  2. Inclusion explicite — le fichier correspond à une entrée include avec "publish": true → est publié sur le CDN
  3. Repli global — utilise le paramètre publish de niveau supérieur (qui vaut false par défaut s’il n’est pas défini)

Si aucune configuration de publication n’est définie à quelque niveau que ce soit, l’étape de publication est entièrement ignorée — aucun appel d’API n’est effectué.

Commandes prenant en charge la publication

CommandeComportement
gt translatePublie après avoir téléchargé les traductions
gt uploadPublie après avoir téléversé les fichiers source
gt save-localPublie après avoir enregistré les modifications locales

Liens