Atrás

gt@2.11.0

Fernando Aviles avatarFernando Aviles
gt-clicdnpublishfilesjsonmdxyamli18n

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 tipos de archivo compatibles ahora pueden publicarse directamente desde los comandos translate, upload y save-local.

Configuración

Opción global de publicación

Añade --publish a cualquier comando compatible:

npx gt translate --publish

O configúralo en gt.config.json:

{
  "publish": true
}

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

Control de publicación por archivo

Puedes incluir o excluir archivos individuales mediante la sintaxis de patrones de include. En lugar de una simple cadena glob, usa un objeto con una opción 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, todos los archivos JSON de locales/[locale]/ se publican en la CDN, excepto los archivos del subdirectorio internal/.

Control de publicación de JSON de GT

El formato interno de GT tiene su propia opción de publicación en la clave gt:

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

Orden de resolución

Para cualquier archivo, la CLI resuelve la intención de publicación 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 de reserva global — usa la configuración publish de nivel superior (el valor predeterminado es false si no se establece)

Si no se establece ninguna configuración de publicación en ningún nivel, el paso de publicación se omite por completo: no se realizan llamadas a la API.

Comandos que permiten la publicación

ComandoComportamiento
gt translatePublica después de descargar las traducciones
gt uploadPublica después de subir los archivos fuente
gt save-localPublica después de guardar las ediciones locales

Enlaces