Retour

gt@2.11.0

Fernando Aviles avatarFernando Aviles
gt-clicdnpublishfilesjsonmdxyamli18n

Vue d’ensemble

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

Configuration

Indicateur publish global

Ajoutez --publish à n’importe quelle commande prise en charge :

npx gt translate --publish

Ou configurez-le dans gt.config.json :

{
  "publish": true
}

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

Contrôle de publication par fichier

Vous pouvez inclure ou exclure chaque fichier individuellement à l’aide de la syntaxe de motif include. Au lieu d’une simple chaîne glob, utilisez un objet avec l’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 sous locales/[locale]/ sont publiés sur le CDN, à l’exception de ceux du sous-répertoire internal/.

Contrôle de publication du JSON GT

Le format interne de GT dispose 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 selon cet ordre :

  1. Désactivation explicite — le fichier correspond à une entrée include avec "publish": false → non publié ou retiré du CDN
  2. Activation explicite — le fichier correspond à une entrée include avec "publish": true → publié sur le CDN
  3. Valeur de repli globale — utilise le paramètre publish de niveau supérieur (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 le téléchargement des traductions
gt uploadPublie après l’envoi des fichiers source
gt save-localPublie après l’enregistrement des modifications locales

Liens