# gt: General Translation CLI tool: Управление переводами
URL: https://generaltranslation.com/ru/docs/cli/guides/managing-translations.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Как загружать, помещать в очередь, скачивать, отправлять на проверку и синхронизировать локальные правки перевода с помощью CLI General Translation.

Команда [`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) или [`gt stage`](/docs/cli/reference/commands/stage) поставят в очередь новые задачи, передайте `--save-local` или задайте [`options.saveLocal`](/docs/cli/reference/config#save-local) значение `true` в `gt.config.json`.

Для файлов Apple `.strings` и `.stringsdict`, а также файлов Android `strings.xml` платформа проверяет и сохраняет отредактированный документ целиком. Для `.xcstrings` CLI отслеживает и отправляет каждую локаль отдельно, несмотря на то, что все локали хранятся в одном файле.

## Next steps

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

## Sitemap

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