# gt: General Translation CLI tool: Подготавливать переводы
URL: https://generaltranslation.com/ru/docs/cli/stage.mdx
---
title: Подготавливать переводы
description: Как подготавливать переводы к проверке
---

## Обзор

`gt stage` — команда, которая генерирует переводы для вашего проекта и подготавливает их к проверке.

Эта команда полезна только в том случае, если в вашем проекте включена проверка человеком.

## Использование

<Callout type="error">
  Выполните это в вашем CI-процессе **до** сборки приложения для продакшена.
</Callout>

```bash
npx gt stage
```

<Callout type="info">
  **Примечание:**
  Для этой команды требуется API-ключ для продакшена! Получить его можно на [платформе](https://generaltranslation.com/dashboard).
</Callout>

Команда `gt stage` работает так же, как `translate`, но вместо загрузки готовых переводов или их публикации в CDN подготавливает их к проверке.

После выполнения `gt stage` следует запустить `gt translate`, чтобы завершить процесс и загрузить переводы (если это настроено).

<Callout type="warn">
  **Только для использования в продакшене!**

  Эта команда предназначена для продакшен-сборок и **не должна использоваться в среде разработки**.
  Перед запуском этой команды убедитесь, что вы находитесь в ветке, которая будет использоваться для продакшена.
  Не забудьте также указать в переменных окружения API-ключ для продакшена (`GT_API_KEY`) и ID проекта (`GT_PROJECT_ID`).
</Callout>

***


## Флаги

| Параметр                        | Описание                                                                                                                           | Тип        | Необязательный | По умолчанию                                                                                                                    |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | ---------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `--api-key`                     | Укажите API-ключ для продакшена                                                                                                    | `string`   | `true`         |                                                                                                                                 |
| `--project-id`                  | Укажите ID проекта                                                                                                                 | `string`   | `true`         |                                                                                                                                 |
| `--version-id`                  | Укажите ID версии (по умолчанию — хеш содержимого)                                                                                 | `string`   | `true`         |                                                                                                                                 |
| `--config <path>`               | Укажите путь к файлу конфигурации GT                                                                                               | `string`   | `true`         | `"gt.config.json"`                                                                                                              |
| `--tsconfig, --jsconfig <path>` | Укажите путь к файлу конфигурации TS или JS                                                                                        | `string`   | `true`         |                                                                                                                                 |
| `--src <paths>`                 | Список glob-шаблонов, разделённых пробелами, для поиска исходных файлов. Пути должны быть указаны относительно корневого каталога. | `[string]` | `true`         | `[  'src/**/*.{js,jsx,ts,tsx}', 'app/**/*.{js,jsx,ts,tsx}', 'pages/**/*.{js,jsx,ts,tsx}', 'components/**/*.{js,jsx,ts,tsx}', ]` |
| `--dictionary <path>`           | Укажите путь к файлу словаря                                                                                                       | `string`   | `true`         |                                                                                                                                 |
| `--inline`                      | Включить встроенные теги `<T>` помимо словаря                                                                                      | `boolean`  | `true`         | `true`                                                                                                                          |
| `--timeout`                     | Тайм-аут запроса на перевод в секундах                                                                                             | `number`   | `true`         | `900`                                                                                                                           |
| `--new, --locales <locales>`    | Локали, на которые нужно перевести проект                                                                                          | `[string]` | `true`         |                                                                                                                                 |
| `--default-locale <locale>`     | Исходная локаль проекта                                                                                                            | `string`   | `true`         | `en`                                                                                                                            |
| `--ignore-errors`               | Игнорировать ошибки и принудительно перевести корректное содержимое                                                                | `flag`     | `true`         | `false`                                                                                                                         |
| `--tag [value]`                 | Пометить этот запуск перевода тегом (если значение не указано, автоматически определяется из git)                                  | `string`   | `true`         |                                                                                                                                 |
| `-m, --message <message>`       | Сообщение, которое нужно прикрепить к тегу перевода                                                                                | `string`   | `true`         |                                                                                                                                 |
| `--dry-run`                     | Выполнить команду в режиме пробного запуска                                                                                        | `flag`     | `true`         | `false`                                                                                                                         |

Все эти параметры необязательны.

<Callout type="warn">
  Не добавляйте API-ключ в файл `gt.config.json`!
  Вместо этого задайте его через переменную окружения. CLI автоматически прочитает `GT_API_KEY`, если она установлена.
</Callout>

Есть несколько ключевых параметров:

| Параметр                     | Описание                                                                                                                     |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `--dry-run`                  | Этот флаг заставит CLI разобрать и проверить проект, но не будет обращаться к GT API. Это полезно для проверки кодовой базы. |
| `--api-key`                  | Если вы не используете `--dry-run`, необходимо указать API-ключ для продакшена.                                              |
| `--project-id`               | Аналогично, если вы не используете `--dry-run`, необходимо указать ID проекта.                                               |
| `--new, --locales <locales>` | Локали, на которые нужно перевести проект. Они будут добавлены к локалям, указанным в файле `gt.config.json`.                |

### Файл конфигурации

При запуске `gt stage` CLI автоматически добавляет свойство `stageTranslations : true` в файл `gt.config.json`.

Это свойство гарантирует, что если команду `translate` запустить без предварительного запуска `stage` для конкретной версии развертывания,
CLI завершит работу с ошибкой.