# gt: General Translation CLI tool: gt git setup
URL: https://generaltranslation.com/ja/docs/cli/reference/commands/git-setup.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 生成された翻訳ファイル用の Git マージドライバーを設定します。gt git setup コマンドの API リファレンスです。

`gt git setup` を使用すると、`gt-lock.json` と生成された GTJSON ファイルを、プレーンテキストとしてではなく、構造化されたコンテンツ単位でマージできます。

## 概要 [#overview]

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

`gt.config.json` ファイルが含まれている Git ワークツリー内でコマンドを実行してください。

## 仕組み [#how-it-works]

1. 現在の Git ワークツリーのルートを特定します。
2. `gt-lock.json` と、設定済みの `files.gt.output` パターンに対するマージドライバーのエントリを、ルートの `.gitattributes` ファイルに追加します。
3. 両方のマージドライバーをリポジトリのローカル Git 設定に登録します。
4. 必要に応じて [`omitConfigIds: true`](/docs/cli/reference/config#omit-config-ids) を設定し、生成された設定 ID を削除します。

このコマンドは既存の `.gitattributes` の内容を保持したまま、不足しているエントリのみを追記します。そのため、GTJSON の `output` パスを変更した後も、再度実行して問題ありません。

## フラグ [#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` バイナリ。見つからない場合は `PATH` 上の `gt` |

## 例 [#example]

生成された属性とローカルの Git 設定をプレビューします：

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

設定を適用し、生成された ID は `gt.config.json` に含めないようにします：

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

CLI がローカルにインストールされていない pnpm プロジェクトでは、Git から CLI を呼び出す方法を次のように指定します：

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

## その他の注意事項 [#notes]

* **対話型の設定:** `omitConfigIds` がまだ有効になっていない場合、対話型の実行では有効にするかどうかを確認します (デフォルトは「はい」) 。非対話型の実行やドライランでは確認は行われません。有効にするには `--omit-config-ids` を指定してください。
* **GTJSON のコンフリクト:** 異なるトップレベルキーへの変更は自動的にマージされます。両方のブランチで同じキーが異なる内容に変更された場合は、Git が通常のマージコンフリクトとして報告します。
* **ロックファイルのコンフリクト:** ロックファイルドライバーには `gt-lock.json` のバージョン 2 が必要です。古いロックファイルは、マージ前に [`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.