Descripción general

La CLI de GT ahora puede publicar cualquier tipo de archivo traducido en la CDN de GT. JSON, MDX, YAML y todos los demás formatos de archivo compatibles ahora pueden publicarse directamente desde los comandos translate, upload y save-local.

Configuración

Marca global de publicación

Añade --publish a cualquier comando compatible:

npx gt translate --publish

O bien, configúralo en gt.config.json:

{
  "publish": true
}

Esto publica todos los archivos traducidos (incluidos los archivos JSON de GT) en la CDN.

Control de publicación por archivo

Puedes decidir, archivo por archivo, si se publica o no usando la sintaxis de patrones de include. En lugar de una simple cadena glob, usa un objeto con la marca publish:

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

En este ejemplo, se publican en la CDN todos los archivos JSON de locales/[locale]/, excepto los que están en el subdirectorio internal/.

Control de publicación del JSON de GT

El formato interno de GT tiene su propia marca de publicación bajo la clave gt:

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

Orden de resolución

Para cualquier archivo, la CLI determina si debe publicarse en este orden:

1. Exclusión explícita — el archivo coincide con una entrada de include con "publish": false → no se publica o se elimina de la CDN
2. Inclusión explícita — el archivo coincide con una entrada de include con "publish": true → se publica en la CDN
3. Valor global de respaldo — usa la configuración publish de nivel superior (el valor predeterminado es false si no se establece)

Si no se define ninguna configuración de publicación en ningún nivel, el paso de publicación se omite por completo — no se hace ninguna llamada a la API.

Comandos compatibles con la publicación

Enlaces

• Referencia de configuración de la CLI
• PR #1122 — compatibilidad inicial para publicar archivos
• PR #1132 — corrección de inclusión explícita
• PR #1133 — publicar al guardar o con carga