# gt: General Translation CLI tool: gt stage
URL: https://generaltranslation.com/ru/docs/cli/reference/commands/stage.mdx
---

title: gt stage
description: Отправьте проект на асинхронный перевод и скачайте результаты позже. Справочник API для команды gt stage.

---

Отправляет ваш проект на асинхронный перевод без скачивания или публикации результатов в рамках того же запуска. Используйте эту команду, если в вашем проекте включена ручная проверка или если такой формат, как Lottie, не может быть обработан за один запуск [`gt translate`](/docs/cli/reference/commands/translate). Оба процесса описаны в разделе [Управление переводами](/docs/cli/guides/managing-translations).

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

*Примечание: только для использования в Production. Требуются production `GT_API_KEY` и `GT_PROJECT_ID`.*

```bash
npx gt stage
```

## Как это работает [#how-it-works]

1. Считывает `gt.config.json`, сканирует исходный код на наличие встроенного контента в проектах на поддерживаемых фреймворках и собирает файлы — так же, как [`gt translate`](/docs/cli/reference/commands/translate) делает.
2. Отправляет контент в API General Translation, не скачивая и не публикуя результаты в рамках того же запуска. Проекты с обязательной проверкой удерживают готовые переводы до утверждения.
3. Устанавливает `stageTranslations: true` в `gt.config.json`, чтобы для будущих запусков требовалось выполнение `stage`.

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

## Флаги [#flags]

`stage` принимает те же флаги, что и [`gt translate`](/docs/cli/reference/commands/translate#flags), включая флаги сканирования исходников для проектов на фреймворках. Ниже перечислены флаги, которые чаще всего используются с этой командой; полный список приведён по ссылке выше.

| Parameter                   | Description                                                                              | Type       | Optional | Default          |
| --------------------------- | ---------------------------------------------------------------------------------------- | ---------- | -------- | ---------------- |
| `--api-key <key>`           | API-ключ Production.                                                                     | `string`   | Да       | `GT_API_KEY`     |
| `--project-id <id>`         | ID проекта.                                                                              | `string`   | Да       | `GT_PROJECT_ID`  |
| `-c, --config <path>`       | Путь к конфигурационному файлу.                                                          | `string`   | Да       | `gt.config.json` |
| `--locales <locales...>`    | Дополнительные целевые локали, добавляемые к `locales` из конфигурации.                  | `string[]` | Да       | —                |
| `--default-locale <locale>` | Исходная локаль проекта.                                                                 | `string`   | Да       | `en`             |
| `--dry-run`                 | Выполнить разбор и проверку без вызова API.                                              | `boolean`  | Да       | `false`          |
| `--tag [value]`             | Добавить тег к запуску; если значение не указано, оно автоматически определяется из git. | `string`   | Да       | —                |
| `-m, --message <message>`   | Сообщение, прикреплённое к тегу перевода.                                                | `string`   | Да       | —                |

## Пример [#example]

```bash
# Подготовить переводы к ручной проверке
npx gt stage

# Подготовить и пометить запуск для отслеживания в dashboard
npx gt stage --tag v2.1.0 -m "Q3 release"

# Когда переводы будут готовы, скачать их
npx gt download
```

## Другие примечания [#notes]

* Используйте `stage`, если включена ручная проверка или при переводе асинхронных форматов, таких как [Lottie](/docs/cli/reference/formats/lottie-files).
* При выполнении `stage` задается ключ конфигурации [`stageTranslations`](/docs/cli/reference/config#stage). См. [Подготовка переводов к проверке](/docs/cli/guides/managing-translations#review).