# gt: General Translation CLI tool: Lottie
URL: https://generaltranslation.com/es/docs/cli/reference/formats/lottie-files.mdx
---

title: Lottie
description: Traduce archivos de animación dotLottie con la CLI de General Translation. Referencia de la API para el formato de archivo Lottie.

---

La CLI traduce el texto de archivos de animación binarios dotLottie (`.lottie`) y guarda cada resultado como un archivo `.lottie` completo. Los trabajos de Lottie incluyen una fase asíncrona de Procesamiento de diseño, por lo que utilizan el flujo de trabajo dividido de preparación y descarga.

## Descripción general [#overview]

| Tema                                        | Descripción                                                                 |
| ------------------------------------------- | --------------------------------------------------------------------------- |
| [Configuración](#config)                    | Configure las rutas de los archivos `.lottie` de origen y traducidos.       |
| [Flujo de trabajo de traducción](#workflow) | Prepare tareas asíncronas y descargue las animaciones completadas.          |
| [Procesamiento de diseño](#layout)          | Ajuste el texto traducido preservando el diseño de la animación.            |
| [Expresiones](#expressions)                 | Elimine las expresiones ejecutables de After Effects antes de traducir.     |
| [Fuentes](#fonts)                           | Cargue las fuentes utilizadas durante el Procesamiento de diseño traducido. |
| [Salida binaria](#binary)                   | Gestione la transferencia en base64 y los archivos `.lottie` decodificados. |

## Configuración [#config]

Agrega una entrada `lottie` en `files` con un array `include` de patrones glob. Usa el marcador de posición `[locale]` para que la CLI pueda encontrar las animaciones de origen y guardar los archivos traducidos en cada configuración regional de destino.

```json title="gt.config.json"
{
  "defaultLocale": "en",
  "locales": ["es", "fr"],
  "files": {
    "lottie": {
      "include": ["animations/[locale]/**/*.lottie"],
      "exclude": ["animations/[locale]/drafts/**"]
    }
  }
}
```

Con esta configuración, las animaciones de origen se obtienen de `animations/en/` y las traducidas se guardan en `animations/es/` y `animations/fr/`. Consulta la [referencia de configuración](/docs/cli/reference/config#files) para ver las claves de archivo compartidas.

## Flujo de trabajo de traducción [#workflow]

Ejecuta [`gt stage`](/docs/cli/reference/commands/stage) para enviar las animaciones y luego ejecuta [`gt download`](/docs/cli/reference/commands/download) hasta que todas las configuraciones regionales estén listas:

```bash
npx gt stage
npx gt download
```

Las traducciones que aún se están procesando se omiten. Vuelve a ejecutar [`gt download`](/docs/cli/reference/commands/download) más tarde para descargarlas; la entrada preparada permanece en `gt-lock.json` hasta que se descarguen todas las configuraciones regionales configuradas.

[`gt translate`](/docs/cli/reference/commands/translate) no puede completar un trabajo de Lottie no preparado en una sola ejecución. Cuando `stageTranslations` es `false` y la configuración incluye archivos Lottie, finaliza indicando que uses [`gt stage`](/docs/cli/reference/commands/stage) y [`gt download`](/docs/cli/reference/commands/download).

## Procesamiento de diseño [#layout]

El procesamiento de diseño conserva los tamaños de fuente de la animación. Redistribuye el texto y ajusta las capas cercanas para acomodar las etiquetas traducidas. Cuando una etiqueta sigue sin caber, el proceso puede acortarla o reformularla en el idioma de destino sin alterar su significado. El truncamiento con puntos suspensivos es el último recurso.

Si los cambios de diseño no se pueden renderizar ni verificar, el trabajo se completa con la animación traducida original en lugar de aplicar cambios no verificados. Revisa la animación descargada antes de publicarla.

## Expresiones [#expressions]

Los archivos Lottie con expresiones de After Effects se rechazan porque contienen JavaScript ejecutable. Vuelve a exportar la animación con las expresiones eliminadas o convertidas en fotogramas clave y luego vuelve a prepararla.

## Fuentes [#fonts]

Agrega una configuración [`fonts`](/docs/cli/reference/config#fonts) de nivel superior cuando una animación use fuentes que podrían no estar disponibles durante el Procesamiento de diseño:

```json title="gt.config.json"
{
  "fonts": {
    "include": ["public/fonts/**/*.{ttf,otf}"]
  }
}
```

La CLI carga las fuentes compatibles antes de poner en cola los trabajos de traducción. Si no se puede sincronizar una fuente, la traducción continúa con fuentes alternativas y se muestra una advertencia.

## Salida binaria [#binary]

La CLI gestiona internamente los archivos `.lottie` como base64 y, después, decodifica los resultados descargados para convertirlos de nuevo en archivos binarios. No trates el contenido descargado como texto UTF-8 ni edites manualmente los datos base64 intermedios.