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

title: Управление переводами
description: "Как управлять переводами с помощью CLI General Translation: в этом руководстве рассматриваются разбиение процесса на этапы upload, enqueue и download, отправка переводов на проверку и синхронизация локальных правок."
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` не ждёт завершения, вы можете запустить `download` в следующей задаче, когда переводы будут готовы. Это позволяет не держать задачу сборки открытой, пока выполняется перевод.

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

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

```bash
npx gt stage
```

Запуск `stage` устанавливает `stageTranslations: true` в вашем `gt.config.json`. После утверждения переводов выполните `gt translate`, чтобы скачать их. Пока включён `stageTranslations`, `translate` скачивает только те версии, которые вы подготовили с помощью `stage`; если вы ничего не подготовили, скачивать нечего.

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

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

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

Команда сравнивает ваши локальные файлы с последними скачанными версиями, вычисляет diff для всех изменений и отправляет его. Она не ставит в очередь новые переводы. Чтобы вместо этого включить локальные правки в запуск перевода, передайте `--save-local` команде `translate`.
## Next steps

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