# gt: General Translation CLI tool: Управление переводами
URL: https://generaltranslation.com/ru/docs/cli/guides/managing-translations.mdx
---

title: Управление переводами
description: Как загружать, помещать в очередь, скачивать, отправлять на проверку и синхронизировать локальные правки перевода с помощью CLI General Translation.
related:
  links:
    - /docs/cli/guides/generating-translations
    - /docs/cli/guides/branching
    - /docs/cli/guides/configuring
    - /docs/cli/guides/using-autoderive

---

Команда [`gt translate`](/docs/cli/reference/commands/translate) выполняет весь процесс перевода за один шаг. Когда вам нужен больший контроль — например, отдельные этапы CI или этап ручной проверки, — CLI предоставляет отдельную команду для каждой части этого процесса.

*Примечание: для этих команд требуется production API key. Задайте `GT_API_KEY` и `GT_PROJECT_ID` как переменные окружения.*

## Разнесите перевод по этапам CI [#split]

В CI-конвейере часто нужно загружать контент, переводить его и скачивать результаты в отдельных задачах. Этим этапам соответствуют три команды.

1. [`gt upload`](/docs/cli/reference/commands/upload) загружает исходные файлы (и все существующие переводы) на платформу.
2. [`gt enqueue`](/docs/cli/reference/commands/enqueue) ставит загруженные файлы в очередь на перевод и сразу завершается, не дожидаясь результатов.
3. [`gt download`](/docs/cli/reference/commands/download) скачивает готовые переводы и сохраняет их по путям из вашей конфигурации.

```bash
# Этап 1: загрузка исходных файлов
npx gt upload

# Этап 2: постановка переводов в очередь
npx gt enqueue

# Этап 3: скачивание по готовности
npx gt download
```

Поскольку [`enqueue`](/docs/cli/reference/commands/enqueue) не ждёт завершения, вы можете запустить [`download`](/docs/cli/reference/commands/download) в следующей задаче, когда переводы будут готовы. Это позволяет не держать задачу сборки открытой, пока выполняется перевод.

## Перевод анимаций Lottie [#lottie]

Перевод анимаций Lottie включает асинхронную обработку макета, поэтому [`gt translate`](/docs/cli/reference/commands/translate) не может отправить их и скачать за один запуск. Подготовьте анимации, затем скачайте готовые локали:

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

Если некоторые локали всё ещё обрабатываются, команда скачивания пропустит их. Позже снова выполните [`gt download`](/docs/cli/reference/commands/download); подготовленный файл остаётся в `gt-lock.json`, пока не будут скачаны все настроенные локали. Сведения о конфигурации, шрифтах и ограничениях выражений см. в [справочнике по формату Lottie](/docs/cli/reference/formats/lottie-files).

## Подготовьте переводы для проверки [#review]

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

```bash
npx gt stage
```

Запуск [`stage`](/docs/cli/reference/commands/stage) устанавливает `stageTranslations: true` в вашем `gt.config.json`. После утверждения переводов выполните [`gt download`](/docs/cli/reference/commands/download). [`gt translate`](/docs/cli/reference/commands/translate) также может скачать ранее подготовленную версию. Пока включён `stageTranslations`, [`translate`](/docs/cli/reference/commands/translate) скачивает только те версии, которые вы подготовили с помощью `stage`; если вы ничего не подготовили, команда завершится с ошибкой.

## Сохранение локальных правок [#save-local]

Если вы или переводчик вручную редактируете загруженные файлы перевода, используйте [`gt save-local`](/docs/cli/reference/commands/save-local), чтобы отправить эти изменения обратно на платформу.

```bash
npx gt save-local
```

Команда сравнивает ваши локальные файлы с последними скачанными версиями, вычисляет diff для всех изменений и отправляет его. Она не ставит в очередь новые переводы. [`gt translate`](/docs/cli/reference/commands/translate) по умолчанию выполняет этот шаг сохранения перед постановкой новых задач в очередь; передайте `--no-save-local`, чтобы пропустить его для запуска.
## Next steps

- /docs/cli/guides/generating-translations
- /docs/cli/guides/branching
- /docs/cli/guides/configuring
- /docs/cli/guides/using-autoderive