# gt: General Translation CLI tool: gt stage
URL: https://generaltranslation.com/ja/docs/cli/reference/commands/stage.mdx
---

title: gt stage
description: 人手によるレビューを必須として、プロジェクトを General Translation に送信します。`gt stage` コマンドの API リファレンス。

---

プロジェクトを翻訳のために送信し、結果をダウンロードまたは公開する代わりに、人手によるレビュー待ちとして保留します。プロジェクトで人手によるレビューが有効になっている場合に使用してください。レビューの workflow については、[翻訳の管理](/docs/cli/guides/managing-translations#review) を参照してください。

`stage` を実行すると、`gt.config.json` で `stageTranslations: true` が設定されます。これを有効にすると、特定のバージョンを事前にステージングせずに [`gt translate`](/docs/cli/reference/commands/translate) を実行した場合、CLI はエラーで終了します。翻訳が承認されたら、[`translate`](/docs/cli/reference/commands/translate) を実行してダウンロードしてください。

*注: 本番環境でのみ使用してください。本番用の `GT_API_KEY` と `GT_PROJECT_ID` が必要です。*

```bash
npx gt stage
```

## 動作の仕組み [#how-it-works]

1. `gt.config.json` を読み取り、フレームワークプロジェクト内のソースコードをスキャンしてインラインコンテンツを検出し、ファイルを収集します。これは [`gt translate`](/docs/cli/reference/commands/translate) と同じです。
2. コンテンツを General Translation API に送信し、ダウンロードや公開は行わず、結果を人手によるレビュー用に保持します。
3. `gt.config.json` で `stageTranslations: true` を設定し、以後の実行ではステージングが必須になるようにします。

`stageTranslations` を有効にすると、そのバージョンを先にステージングせずに `translate` を実行した場合、CLI はエラーで終了します。翻訳が承認されたら、`translate` を実行してダウンロードしてください。

## フラグ [#flags]

`stage` は、フレームワーク プロジェクト向けのソースコードのスキャン用フラグを含め、[`gt translate`](/docs/cli/reference/commands/translate#flags) と同じフラグを受け付けます。特によく使われるフラグを以下に示します。すべてのフラグについては、上記リンク先のリファレンスを参照してください。

| パラメータ                       | 説明                                      | 型          | 任意 | デフォルト            |
| --------------------------- | --------------------------------------- | ---------- | -- | ---------------- |
| `--api-key <key>`           | 本番用の API キー。                            | `string`   | はい | `GT_API_KEY`     |
| `--project-id <id>`         | プロジェクト ID。                              | `string`   | はい | `GT_PROJECT_ID`  |
| `-c, --config <path>`       | 設定ファイルへのパス。                             | `string`   | はい | `gt.config.json` |
| `--locales <locales...>`    | 追加の対象ロケール。設定ファイルの locales に追加されます。      | `string[]` | はい | —                |
| `--default-locale <locale>` | プロジェクトのソースロケール。                         | `string`   | はい | `en`             |
| `--dry-run`                 | API を呼び出さずに、解析と検証を行います。                 | `boolean`  | はい | `false`          |
| `--tag [value]`             | 実行にタグを付けます。値を指定しない場合は git から自動的に取得されます。 | `string`   | はい | —                |
| `-m, --message <message>`   | 翻訳タグに付けるメッセージ。                          | `string`   | はい | —                |

## 例 [#example]

```bash
# 人手によるレビューのために翻訳をステージングする
npx gt stage

# ダッシュボードで追跡するためにステージングしてタグを付ける
npx gt stage --tag v2.1.0 -m "Q3 release"

# 翻訳が承認されたらダウンロードする
npx gt translate
```

## その他のメモ [#notes]

* `stage` は、プロジェクトで人手によるレビューが有効になっている場合にのみ役立ちます。
* ステージングすると、[`stageTranslations`](/docs/cli/reference/config#stage) 設定キーが設定されます。詳しくは、[レビュー用に翻訳をステージする](/docs/cli/guides/managing-translations#review) を参照してください。