# gt: General Translation CLI tool: gt generate
URL: https://generaltranslation.com/ja/docs/cli/reference/commands/generate.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 手動翻訳用のソーステンプレートを生成します。gt generate コマンドの API リファレンスです。

デフォルトロケールとターゲットロケール用のローカルテンプレートファイルを生成します。General Translation API を使わず、翻訳を自分で管理する場合に使用します。

*注: このコマンドは、CLI が `gt-next`、`gt-react`、`gt-react-native`、`gt-tanstack-start`、`gt-node`、`gt-vue`、`gt-flask`、`gt-fastapi` のいずれかを検出した場合に利用できます。これらのライブラリを含まないプロジェクトでは登録されません。General Translation API を使用する場合は、代わりに [`gt translate`](/docs/cli/reference/commands/translate) を使用してください。*

## 概要 [#overview]

まずプロジェクトを設定してから、テンプレートを生成します。

```bash
npx gt configure
npx gt generate
```

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

1. `gt.config.json` を読み込み、デフォルトロケールとターゲットロケール、ソースパス、dictionary、`files.gt.output` のパスを特定します。
2. 検出されたライブラリのパーサーを使用して、インラインコンテンツと設定済みのdictionaryをスキャンします。コンテンツの収集方法は [`gt translate`](/docs/cli/reference/commands/translate) と同じです。
3. デフォルトロケールのテンプレートを現在のソースエントリで置き換えます。
4. それらのエントリを各ターゲットロケールのファイルにマージします。既存のターゲット値は保持され、新しいエントリにはソーステキストが使用され、不要になったエントリは削除されます。

このコマンドは General Translation API を呼び出しません。`files.gt.output` が設定されていない場合は、プロジェクトをスキャンしたうえで、テンプレートを書き出さずに終了します。

## フラグ [#flags]

### テンプレート生成フラグ

| パラメータ                                           | 説明                                                          | 型          | 任意 | デフォルト                                 |
| ----------------------------------------------- | ----------------------------------------------------------- | ---------- | -- | ------------------------------------- |
| `-c, --config <path>`                           | `gt.config.json` へのパス。                                      | `string`   | はい | 検出された `gt.config.json`                |
| `--default-language, --default-locale <locale>` | ソーステンプレートに使用するデフォルトロケール。                                    | `string`   | はい | 設定済みのデフォルトロケール                        |
| `--new, --locales <locales...>`                 | テンプレートファイルのマージ対象となるターゲットロケール。                               | `string[]` | はい | 設定済みのロケール                             |
| `--src <paths...>`                              | ソースファイルを指定するグロブパターン。                                        | `string[]` | はい | `src`、`app`、`pages`、`components` のグロブ |
| `--dictionary <path>`                           | dictionary ファイルへのパス。                                        | `string`   | はい | —                                     |
| `--tsconfig, --jsconfig <path>`                 | ソースの import の解決に使用する TypeScript または JavaScript の設定ファイルへのパス。 | `string`   | はい | 検出された設定ファイル、または `./tsconfig.json`     |
| `--inline`                                      | 検出されたライブラリがサポートするインラインコンテンツを含めます。                           | `boolean`  | はい | `true`                                |
| `--ignore-errors`                               | インラインコンテンツのスキャン中に検出されたエラーを無視します。                            | `boolean`  | はい | `false`                               |

### 互換性のために受け付けるフラグ

このコマンドは [`gt translate`](/docs/cli/reference/commands/translate) とパーサーを共有しているため、ヘルプ出力に表示される以下のフラグも指定できます。ただし、これらはローカルでのテンプレート生成には影響しません。特に、`--dry-run` を指定してもファイルの書き込みは抑止されません。

| パラメータ                                     | 説明                           | 型                   | 任意 | デフォルト          |
| ----------------------------------------- | ---------------------------- | ------------------- | -- | -------------- |
| `--api-key <key>`                         | 指定可能ですが、使用されません。             | `string`            | はい | —              |
| `--project-id <id>`                       | 指定可能ですが、使用されません。             | `string`            | はい | —              |
| `--version-id <id>`                       | 指定可能ですが、使用されません。             | `string`            | はい | —              |
| `--dry-run`                               | 指定可能ですが、テンプレートの書き込みは抑止されません。 | `boolean`           | はい | `false`        |
| `--timeout <seconds>`                     | 指定可能ですが、使用されません。             | `number`            | はい | `900`          |
| `--save-local`, `--no-save-local`         | 指定可能ですが、使用されません。             | `boolean`           | はい | 設定値または `false` |
| `--publish`                               | 指定可能ですが、使用されません。             | `boolean`           | はい | `false`        |
| `--experimental-localize-static-urls`     | 指定可能ですが、使用されません。             | `boolean`           | はい | `false`        |
| `--experimental-hide-default-locale`      | 指定可能ですが、使用されません。             | `boolean`           | はい | `false`        |
| `--experimental-flatten-json-files`       | 指定可能ですが、使用されません。             | `boolean`           | はい | `false`        |
| `--experimental-localize-static-imports`  | 指定可能ですが、使用されません。             | `boolean`           | はい | `false`        |
| `--experimental-localize-relative-assets` | 指定可能ですが、使用されません。             | `boolean`           | はい | `false`        |
| `--force`                                 | 指定可能ですが、使用されません。             | `boolean`           | はい | `false`        |
| `--force-download`                        | 指定可能ですが、使用されません。             | `boolean`           | はい | `false`        |
| `--omit-config-ids`                       | 指定可能ですが、使用されません。             | `boolean`           | はい | `false`        |
| `--experimental-clear-locale-dirs`        | 指定可能ですが、使用されません。             | `boolean`           | はい | `false`        |
| `--branch <branch>`                       | 指定可能ですが、使用されません。             | `string`            | はい | —              |
| `--disable-branch-detection`              | 指定可能ですが、使用されません。             | `boolean`           | はい | `false`        |
| `--enable-branching`                      | 指定可能ですが、使用されません。             | `boolean`           | はい | `false`        |
| `--remote-name <name>`                    | 指定可能ですが、使用されません。             | `string`            | はい | `origin`       |
| `--tag [value]`                           | 指定可能ですが、使用されません。             | `string \| boolean` | はい | —              |
| `-m, --message <message>`                 | 指定可能ですが、使用されません。             | `string`            | はい | —              |

## 例 [#example]

```bash
# 設定済みのロケール用にtemplatesを生成する
npx gt generate

# カスタムのsourceロケールから生成し、スキャンエラーを無視する
npx gt generate --default-locale en-US --ignore-errors
```

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

テンプレートファイルを生成したら、ターゲットの値を翻訳し、[ローカル翻訳](/docs/react/guides/storing-translations)として配信します。ソースコンテンツを変更した場合は、その都度 `generate` を再実行してください。ソースから削除されたエントリはターゲットファイルからも削除されるため、ターゲットファイルの内容を確認するようにしてください。

## Sitemap

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