# gt: General Translation CLI tool: gt stage
URL: https://generaltranslation.com/ru/docs/cli/reference/commands/stage.mdx
Docs index: https://generaltranslation.com/llms.txt
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) скачивает только подготовленные версии. Если ни одна версия не подготовлена, команда завершается без скачивания файлов. Когда переводы будут готовы — и утверждены, если требуется проверка, — запустите [`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) скачивает только подготовленные версии. Если подготовленных версий нет, команда завершается без скачивания файлов. Скачайте готовые переводы с помощью [`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`                     | Выполнить разбор и проверку без загрузки и постановки переводов в очередь.                                                                                   | `boolean`  | Да       | `false`          |
| `--save-local, --no-save-local` | Включить или отключить сохранение локальных правок перед постановкой в очередь. Переопределяет [`options.saveLocal`](/docs/cli/reference/config#save-local). | `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).

## Sitemap

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