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

Используйте `gt git setup`, чтобы при слиянии `gt-lock.json` и сгенерированные файлы GTJSON обрабатывались с учётом их структурированного содержимого, а не как обычный текст.

## Обзор [#overview]

```bash
npx gt git setup [options]
```

Запускайте команду из рабочего дерева Git, в котором есть файл `gt.config.json`.

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

1. Находит корень текущего рабочего дерева Git.
2. Добавляет в корневой файл `.gitattributes` записи драйверов слияния для `gt-lock.json` и для шаблона, заданного в `files.gt.output`.
3. Регистрирует оба драйвера слияния в локальной конфигурации Git репозитория.
4. При необходимости устанавливает [`omitConfigIds: true`](/docs/cli/reference/config#omit-config-ids) и удаляет сгенерированные идентификаторы конфигурации.

Команда сохраняет существующее содержимое `.gitattributes` и добавляет только недостающие записи, поэтому после изменения выходного пути GTJSON её можно запустить повторно.

## Флаги [#flags]

| Параметр                     | Описание                                                                   | Тип       | Необязательно | По умолчанию                                       |
| ---------------------------- | -------------------------------------------------------------------------- | --------- | ------------- | -------------------------------------------------- |
| `-c, --config <path>`        | Путь к `gt.config.json`.                                                   | `string`  | Да            | Определяется автоматически                         |
| `--dry-run`                  | Выводит запланированные изменения файлов и конфигурации Git без их записи. | `boolean` | Да            | `false`                                            |
| `--omit-config-ids`          | Устанавливает `omitConfigIds: true` и удаляет `_versionId` и `_branchId`.  | `boolean` | Да            | `false`                                            |
| `--driver-command <command>` | Команда, с помощью которой Git вызывает установленный CLI.                 | `string`  | Да            | Локальный двоичный файл `gt`, затем `gt` из `PATH` |

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

Просмотрите сгенерированные атрибуты и локальную конфигурацию Git:

```bash
npx gt git setup --dry-run
```

Примените конфигурацию и не допускайте попадания сгенерированных идентификаторов в `gt.config.json`:

```bash
npx gt git setup --omit-config-ids
```

Если в pnpm-проекте CLI не установлен локально, укажите, как Git должен его вызывать:

```bash
npx gt git setup --driver-command "pnpm exec gt"
```

## Прочие заметки [#notes]

* **Интерактивная конфигурация:** если `omitConfigIds` ещё не включён, при интерактивном запуске команда предложит его включить (по умолчанию — «да»). При неинтерактивном и пробном запуске вопрос не задаётся; чтобы включить параметр, передайте флаг `--omit-config-ids`.
* **Конфликты GTJSON:** изменения в разных ключах верхнего уровня объединяются автоматически. Если обе ветки по-разному изменяют один и тот же ключ, Git сообщает об обычном конфликте слияния.
* **Конфликты lock-файла:** драйверу lock-файла требуется `gt-lock.json` версии 2. Чтобы пересоздать lock-файл старой версии, перед слиянием запустите [`gt translate`](/docs/cli/reference/commands/translate) или [`gt stage`](/docs/cli/reference/commands/stage).
* **Область действия:** команда записывает настройки драйвера слияния через `git config --local`, поэтому настройку нужно выполнить отдельно в каждом клоне.

### История версий

| Версия    | Изменения                                                                                                          |
| --------- | ------------------------------------------------------------------------------------------------------------------ |
| `2.14.53` | Добавлены команда `gt git setup`, структурированные драйверы слияния и возможность не указывать ID в конфигурации. |

## Sitemap

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