# gt-react: General Translation React SDK: gt.config.json
URL: https://generaltranslation.com/ja/docs/react/api/config/gt-config-json.mdx
---
title: gt.config.json
description: gt.config.json ファイル
---

{/* 自動生成: 直接編集しないでください。content/docs-templates/ 内のテンプレートを編集してください。 */}


## 概要

`gt.config.json` ファイルには、プロジェクトの設定が保存されます。
ここには、プロジェクトの `projectId`、サポートしているロケールなどの重要な情報が含まれます。
また、プロジェクトの `versionId` などの重要な内部情報も含まれます。

このファイルは、(1) [`<GTProvider>`](/docs/react/api/components/gtprovider) コンポーネントと、(2) [`gt translate`](/docs/cli/translate) コマンドによって読み込まれます。
そのため、[`<GTProvider>`](/docs/react/api/components/gtprovider) コンポーネントに props として渡すのではなく、設定は `gt.config.json` ファイルに保存することをおすすめします。

一般に、アンダースコアで始まるもの (例: `_versionId`) は内部プロパティなので、変更しないでください。
それ以外は自由に変更できます。

***

## フィールド

| フィールド               | 型          | 説明                                        |
| ------------------- | ---------- | ----------------------------------------- |
| `projectId`         | `string`   | GT システム内のプロジェクトを一意に識別する ID                |
| `locales`           | `string[]` | プロジェクトでサポートされているロケールコードの配列                |
| `defaultLocale`     | `string`   | 翻訳が存在しない場合のフォールバックとして使用されるメインのロケールコード     |
| `cacheUrl`          | `string`   | 翻訳データをキャッシュするための URL エンドポイント              |
| `runtimeUrl`        | `string`   | runtime 翻訳サービスの URL エンドポイント               |
| `stageTranslations` | `boolean`  | ステージング/プレビュー用の翻訳機能に関する設定                  |
| `files`             | `object`   | 開発およびテストで使用するローカル翻訳ファイルへのパス               |
| `_versionId`        | `string`   | プロジェクトのバージョン追跡に使用される内部プロパティ (変更しないでください)  |

### `cacheUrl` と `runtimeUrl`

翻訳をクラウドに保存する場合、`cacheUrl` はキャッシュのベース URL です。
`runtimeUrl` は runtime のベース URL で、開発時の翻訳にのみ適用されます。

### `stageTranslations`

`stageTranslations` は、翻訳をレビュー対象としてマークするために `gt` ツールで使われるフラグです。
つまり、翻訳は [`gt translate`](/docs/cli/translate) コマンドで本番環境にデプロイする前に、手動で承認する必要があります。

### `files`

`files` フィールドは、ローカルに保存した翻訳へのパスを指定します (クラウドに保存する場合とは対照的です) 。
具体的には、`output` フィールドで翻訳の出力先を指定します。

```json
{
  "files": {
    "gt": {
      "output": "public/_gt/[locale].json"
    }
  },
}
```

`files` フィールドの使用方法について詳しくは、CLI ツールの[設定ドキュメント](/docs/cli/reference/config)を参照してください。


#### `parsingFlags`

`files.gt.parsingFlags` オブジェクトは、コンパイラがソースファイルをどのように解析するかを制御します。

| フラグ                      | 型         | デフォルト   | 説明                                                                                                                                                        |
| ------------------------ | --------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `enableAutoJsxInjection` | `boolean` | `false` | ビルド時に、翻訳対象の JSX テキストを翻訳コンポーネントで自動的にラップします。[auto JSX injection](/docs/cli/features/auto-jsx-injection) を参照してください。                                          |
| `autoderive`             | `boolean` | `false` | `t()`、`gt()`、`msg()` の呼び出し内で補間された値を、自動的に [`derive()`](/docs/react/api/strings/derive) の呼び出しとして扱います。[autoderive](/docs/cli/features/autoderive) を参照してください。 |

```json title="gt.config.json"
{
  "files": {
    "gt": {
      "output": "public/_gt/[locale].json",
      "parsingFlags": {
        "enableAutoJsxInjection": true,
        "autoderive": true
      }
    }
  }
}
```

{/* 
  ### `_versionId`

  ポイント:
  - 内部向け
  - 独自のバージョン名を指定できます */}

***

## 例

### ロケールを指定する

```json title="gt.config.json"
{
  "defaultLocale": "en", // 主要ロケールは英語
  "locales": ["fr", "es"] // 副次ロケールはフランス語とスペイン語
}
```

{/* ### 独自の versionId の指定 */}

***


## 注意

* `gt.config.json` ファイルは、プロジェクトの設定を指定するために使用します。
* このファイルは、[`<GTProvider>`](/docs/react/api/components/gtprovider) コンポーネントと [`gt translate`](/docs/cli/translate) コマンドの両方で読み込まれます。
* プロジェクトのルートに配置してください。

## 次のステップ