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

title: Lottie
description: Перевод анимационных файлов dotLottie с помощью General Translation CLI. Справочник API по формату файлов Lottie.

---

CLI переводит текст в двоичных файлах анимации dotLottie (`.lottie`) и сохраняет каждый результат как отдельный полный файл `.lottie`. Задачи Lottie включают асинхронный этап обработки макета, поэтому используют разделённый рабочий процесс подготовки и скачивания.

## Конфигурация [#config]

Добавьте в раздел `files` запись `lottie` с массивом glob-шаблонов `include`. Используйте placeholder `[locale]`, чтобы CLI мог находить исходные анимации и сохранять переведённые файлы для каждой целевой локали.

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

При такой конфигурации исходные анимации берутся из `animations/en/`, а переведённые сохраняются в `animations/es/` и `animations/fr/`. Общие ключи файлов см. в [справочнике по конфигурации](/docs/cli/reference/config#files).

## Процесс перевода [#workflow]

Выполните [`gt stage`](/docs/cli/reference/commands/stage), чтобы отправить анимации, затем запускайте [`gt download`](/docs/cli/reference/commands/download), пока не будут завершены все локали:

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

Переводы, которые ещё обрабатываются, пропускаются. Позже повторно запустите [`gt download`](/docs/cli/reference/commands/download), чтобы скачать их; подготовленная запись остаётся в `gt-lock.json`, пока не будут скачаны все настроенные локали.

[`gt translate`](/docs/cli/reference/commands/translate) не может завершить неподготовленную задачу Lottie за один запуск. Если `stageTranslations` имеет значение `false` и конфигурация включает файлы Lottie, команда завершится с рекомендацией использовать [`gt stage`](/docs/cli/reference/commands/stage) и [`gt download`](/docs/cli/reference/commands/download).

## Выражения [#expressions]

Файлы Lottie с выражениями After Effects отклоняются, поскольку выражения содержат исполняемый JavaScript. Повторно экспортируйте анимацию, удалив выражения или преобразовав их в ключевые кадры, а затем снова подготовьте её к проверке.

## Шрифты [#fonts]

Добавьте конфигурацию [`fonts`](/docs/cli/reference/config#fonts) верхнего уровня, если в анимации используются шрифты, которые могут быть недоступны при обработке макета:

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

CLI загружает соответствующие шрифты перед добавлением задач перевода в очередь. Если шрифт не удаётся синхронизировать, перевод продолжается с резервными шрифтами, а CLI выводит предупреждение.

## Двоичный вывод [#binary]

CLI передаёт файлы `.lottie` в виде base64, а затем декодирует скачанные результаты обратно в двоичные файлы. Не обрабатывайте скачанный контент как текст UTF-8 и не редактируйте вручную промежуточные данные base64.