# gt: General Translation CLI tool: gt setup
URL: https://generaltranslation.com/ru/docs/cli/reference/commands/setup.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Загрузка исходных файлов и регистрация проекта в General Translation. Справка по API для команды gt setup.

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

Используйте `setup`, если хотите зарегистрировать исходный контент на платформе как отдельный этап — например, в начале разделённого CI-пайплайна. Для этого требуются production API key и ID проекта.

*Примечание: `setup` доступен для базовых проектов (без фреймворка) и фреймворков семейства React — `gt-react`, `gt-next`, `gt-react-native` и `gt-tanstack-start`. Для проектов `gt-node` и Python он не поддерживается.*

```bash
npx gt setup
```

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

1. Читает `gt.config.json`, чтобы определить, какие исходные файлы нужно собрать.
2. Собирает и хеширует ваши исходные файлы с переводимым содержимым — так же, как [`gt translate`](/docs/cli/reference/commands/translate) перед переводом.
3. Загружает новые и изменённые исходные файлы, регистрируя проект на платформе.
4. Завершается, не ставя переводы в очередь и не загружая результаты.

## Флаги [#flags]

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

| Параметр              | Описание                                     | Тип       | Необязательный | По умолчанию     |
| --------------------- | -------------------------------------------- | --------- | -------------- | ---------------- |
| `--api-key <key>`     | Production API key.                          | `string`  | Да             | `GT_API_KEY`     |
| `--project-id <id>`   | ID проекта.                                  | `string`  | Да             | `GT_PROJECT_ID`  |
| `-c, --config <path>` | Путь к файлу конфигурации.                   | `string`  | Да             | `gt.config.json` |
| `--dry-run`           | Собирает файлы и выводит отчёт без загрузки. | `boolean` | Да             | `false`          |

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

```bash
# Загрузить и зарегистрировать исходные файлы на платформе
npx gt setup

# Показать файлы, которые были бы загружены, без их фактической загрузки
npx gt setup --dry-run
```

## Другие заметки [#notes]

* `setup` также используется в мастере [`gt init`](/docs/cli/reference/commands/init) на этапе регистрации исходных файлов.
* После регистрации исходных файлов добавьте переводы в очередь и скачайте их с помощью [`gt enqueue`](/docs/cli/reference/commands/enqueue) и [`gt download`](/docs/cli/reference/commands/download) либо запустите [`gt translate`](/docs/cli/reference/commands/translate), чтобы выполнить перевод за один шаг.

## Sitemap

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