# gt: General Translation CLI tool: CLI の設定
URL: https://generaltranslation.com/ja/docs/cli/guides/configuring.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: General Translation の gt.config.json をロケール、ファイル、保存オプションとともに設定する方法。

CLI は、プロジェクトのルートにある `gt.config.json` ファイルを読み取り、何を翻訳するかと、結果の保存先を決定します。このガイドでは、そのファイルの作成方法と編集方法を説明します。

*注: このガイドでは、一般的な設定項目を扱います。利用可能なすべてのフィールドについては、[設定リファレンス](/docs/cli/reference/config)を参照してください。*

## 設定ファイルを作成する [#create]

`gt.config.json` は、3つの方法で作成できます。ワークフローに合った方法を選んでください。

### a) セットアップウィザードを一括で実行する

[`gt init`](/docs/cli/reference/commands/init) を実行すると、フレームワークの検出、依存関係のインストール、設定ファイルの作成、必要に応じた認証情報の生成を行えます。

```bash
npx gt init
```

モノレポでは、ワークスペースのルートではなく、ローカライズするアプリのディレクトリでコマンドを実行してください。Vite React アプリの場合、ウィザードは `gt-react` をインストールし、既存のアプリのエントリより前に [`initializeGTSPA`](/docs/react/reference/config#initialize-spa) を設定して、ローカルまたは CDN から翻訳を読み込むようにセットアップします。

### b) 設定ファイル のみを作成する

依存関係をインストールしたり、フレームワークのセットアップを変更したりせずに `gt.config.json` のみを作成するには、[`gt configure`](/docs/cli/reference/commands/configure) を実行します。

```bash
npx gt configure
```

### c) 手動で記述する

自分でファイルを作成し、エディタでの検証や自動補完のために`$schema`参照を追加します。

```json title="gt.config.json"
{
  "$schema": "https://assets.gtx.dev/config-schema.json",
  "defaultLocale": "en",
  "locales": ["fr", "es"]
}
```

## ロケールを設定する [#locales]

`defaultLocale` にはソースコンテンツの言語を設定し、`locales` には対象の言語を列挙します。

```json title="gt.config.json"
{
  "defaultLocale": "en",
  "locales": ["fr", "es", "ja"]
}
```

どちらも `en`、`en-US`、`zh` のような標準的なロケールコードを使用します。完全な一覧は、[対応ロケール](/docs/platform/dashboard/reference/supported-locales)を参照してください。

ロケールにカスタムのエイリアスを使うには — たとえば `zh` の代わりに `cn` を使う場合 — 正式なコードを指す `customMapping` エントリを追加してください。

```json title="gt.config.json"
{
  "customMapping": {
    "cn": { "code": "zh" }
  }
}
```

## 翻訳するファイルを選択する [#files]

翻訳したいファイルタイプごとにキーを持つ `files` オブジェクトを追加します。ほとんどのタイプでは、`include` 配列に glob パターンを指定します。このパターンでは `[locale]` プレースホルダーを使ってソースファイルの場所を特定し、翻訳後のファイルの保存先も指定します。ただし [`.xcstrings` catalogs](/docs/cli/reference/formats/xcstrings-files) は例外で、すべてのロケールが 1 つのファイルに保存され、そのファイルがインプレースで更新されます。

```json title="gt.config.json"
{
  "defaultLocale": "en",
  "locales": ["fr", "es"],
  "files": {
    "json": {
      "include": ["locales/[locale]/**/*.json"]
    },
    "mdx": {
      "include": ["content/docs/[locale]/**/*.mdx"]
    }
  }
}
```

CLI は、ソースファイルを検索する際は `[locale]` を `defaultLocale` に置き換え、翻訳を保存する際は各ターゲットコードに置き換えます。タイプごとのオプションは [File formats](/docs/cli/reference/formats/gt-jsx-files) に、詳細なマッチングは [`include`](/docs/cli/reference/config#files) に記載されています。

## 翻訳の保存先を選択する [#storage]

`gt-next`、`gt-react`、または `gt-react-native` を使用している場合は、翻訳をどのように配信するかを決めます。

* アプリに翻訳をバンドルするには、**ローカルに保存**します。`[locale]` を含む `output` パスを指定した `gt` エントリを追加します。
* 翻訳をバンドルせずに Runtime で読み込むには、**CDN に公開**します。`publish` を `true` に設定します。

```json title="gt.config.json"
{
  "files": {
    "gt": {
      "output": "public/i18n/[locale].json"
    }
  }
}
```

 (公開をグローバル、ファイルごと、またはコマンドごとに制御するには、[CDN 公開](/docs/cli/reference/config#cdn-publishing)を参照してください) 。

## 認証情報を追加する [#credentials]

[`translate`](/docs/cli/reference/commands/translate) コマンドの実行には、本番用の API キーとプロジェクト ID が必要です。これらは `gt.config.json` には含めず、代わりに環境変数として設定してください。

```bash title=".env"
GT_API_KEY=your-api-key
GT_PROJECT_ID=your-project-id
```

[`gt auth`](/docs/cli/reference/commands/auth) を実行すると、これらが生成されて `.env.local` に自動的に書き込まれます。

## Next steps

- /docs/cli/guides/generating-translations
- /docs/cli/guides/managing-translations
- /docs/cli/guides/using-auto-jsx
- /docs/cli/guides/branching

## Sitemap

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