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

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

---

Отправляет ваш проект на перевод и удерживает результаты для ручной проверки вместо скачивания или публикации. Используйте эту команду, если в вашем проекте включена ручная проверка. О процессе проверки см. [Управление переводами](/docs/cli/guides/managing-translations#review).

При запуске `stage` в вашем `gt.config.json` устанавливается `stageTranslations: true`. После этого, если запустить [`gt translate`](/docs/cli/reference/commands/translate) без предварительного выполнения `stage` для данной версии, CLI завершится с ошибкой. После утверждения переводов запустите [`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`, чтобы для будущих запусков требовался staging.

Когда `stageTranslations` включён, запуск `translate` без предварительного staging этой версии приводит к завершению CLI с ошибкой. После утверждения переводов запустите `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 translate
```

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

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