# gt: General Translation CLI tool: gt git setup
URL: https://generaltranslation.com/es/docs/cli/reference/commands/git-setup.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Configura los controladores de fusión de Git para los archivos de traducción generados. Referencia de la API del comando gt git setup.

Usa `gt git setup` para fusionar `gt-lock.json` y los archivos GTJSON generados a partir de su contenido estructurado, en lugar de tratarlos como texto plano.

## Descripción general [#overview]

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

Ejecuta el comando desde un worktree de Git que contenga un archivo `gt.config.json`.

## Cómo funciona [#how-it-works]

1. Localiza la raíz del worktree de Git actual.
2. Añade al archivo `.gitattributes` de la raíz entradas de controlador de fusión para `gt-lock.json` y para el patrón `files.gt.output` configurado.
3. Registra ambos controladores de fusión en la configuración local de Git del repositorio.
4. Opcionalmente, establece [`omitConfigIds: true`](/docs/cli/reference/config#omit-config-ids) y elimina los ID de configuración generados.

El comando conserva el contenido existente de `.gitattributes` y solo añade las entradas que falten, así que puedes volver a ejecutarlo si cambias la ruta de salida de GTJSON.

## Flags [#flags]

| Parámetro                    | Descripción                                                                                | Tipo      | Opcional | Valor predeterminado                                  |
| ---------------------------- | ------------------------------------------------------------------------------------------ | --------- | -------- | ----------------------------------------------------- |
| `-c, --config <path>`        | Ruta a `gt.config.json`.                                                                   | `string`  | Sí       | Se resuelve automáticamente                           |
| `--dry-run`                  | Muestra los cambios previstos en los archivos y en la configuración de Git sin aplicarlos. | `boolean` | Sí       | `false`                                               |
| `--omit-config-ids`          | Establece `omitConfigIds: true` y elimina `_versionId` y `_branchId`.                      | `boolean` | Sí       | `false`                                               |
| `--driver-command <command>` | Comando que usa Git para invocar la CLI instalada.                                         | `string`  | Sí       | Binario local de `gt` y, si no existe, `gt` en `PATH` |

## Ejemplo [#example]

Consulta una vista previa de los atributos generados y de la configuración local de Git:

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

Aplica la configuración y no incluyas los IDs generados en `gt.config.json`:

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

En un proyecto de pnpm en el que la CLI no está instalada localmente, especifica cómo debe invocarla Git:

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

## Otras notas [#notes]

* **Configuración interactiva:** si `omitConfigIds` aún no está habilitado, una ejecución interactiva pregunta si quieres habilitarlo, con «sí» como opción predeterminada. Las ejecuciones no interactivas y de prueba (dry run) no muestran ninguna pregunta; pasa `--omit-config-ids` para habilitarlo.
* **Conflictos en GTJSON:** los cambios en claves de nivel superior distintas se fusionan automáticamente. Si ambas ramas modifican la misma clave de forma diferente, Git notifica un conflicto de fusión normal.
* **Conflictos en el archivo de bloqueo:** el driver del archivo de bloqueo requiere la versión 2 de `gt-lock.json`. Ejecuta [`gt translate`](/docs/cli/reference/commands/translate) o [`gt stage`](/docs/cli/reference/commands/stage) para regenerar un archivo de bloqueo antiguo antes de fusionar.
* **Alcance:** el comando guarda la configuración del controlador de fusión con `git config --local`, por lo que la configuración debe ejecutarse por separado en cada clon.

### Historial de versiones

| Versión   | Cambios                                                                                                                  |
| --------- | ------------------------------------------------------------------------------------------------------------------------ |
| `2.14.53` | Se añadieron `gt git setup`, controladores de fusión estructurados y la posibilidad de omitir el ID en la configuración. |

## Sitemap

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