# gt: General Translation CLI tool: Lottie
URL: https://generaltranslation.com/ru/docs/cli/reference/formats/lottie-files.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Перевод анимационных файлов dotLottie с помощью General Translation CLI. Справочник API по формату файлов Lottie.

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

## Обзор [#overview]

| Тема                          | Описание                                                                    |
| ----------------------------- | --------------------------------------------------------------------------- |
| [Конфигурация](#config)       | Настройте пути к исходным и переведённым файлам `.lottie`.                  |
| [Процесс перевода](#workflow) | Подготавливайте асинхронные задачи и скачивайте готовые анимации.           |
| [Обработка макета](#layout)   | Подгоняйте переведённый текст, сохраняя дизайн анимации.                    |
| [Выражения](#expressions)     | Удаляйте исполняемые выражения After Effects перед переводом.               |
| [Шрифты](#fonts)              | Загружайте шрифты, используемые при обработке макета переведённой анимации. |
| [Двоичный вывод](#binary)     | Обрабатывайте передачу в base64 и декодированные файлы `.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).

## Обработка макета [#layout]

Обработка макета сохраняет размеры шрифтов в анимации. Она перераспределяет текст и корректирует соседние слои, чтобы переведённые подписи поместились. Если подпись всё равно не помещается, её могут сократить или перефразировать на целевом языке, сохранив смысл. Усечение с многоточием используется в крайнем случае.

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

Если изменения макета невозможно отрисовать и проверить, задача завершается с базовой переведённой анимацией без применения непроверенных изменений. Проверьте скачанную анимацию перед публикацией.

## Выражения [#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.

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.