# gt: General Translation CLI tool: gt stage
URL: https://generaltranslation.com/ja/docs/cli/reference/commands/stage.mdx
---
title: gt stage
description: プロジェクトを非同期翻訳用に送信し、後でダウンロードします。`gt stage` コマンドの API リファレンス。

---

同じ実行内で結果をダウンロードまたは公開せずに、プロジェクトを非同期翻訳用に送信します。プロジェクトで人手によるレビューが有効になっている場合、または Lottie などのフォーマットで単一の [`gt translate`](/docs/cli/reference/commands/translate) 実行を完了できない場合に使用してください。どちらの workflow についても、[翻訳の管理](/docs/cli/guides/managing-translations) を参照してください。

`stage` を実行すると、`gt.config.json` で `stageTranslations: true` が設定されます。これを有効にすると、特定のバージョンを事前にステージングせずに [`gt translate`](/docs/cli/reference/commands/translate) を実行した場合、CLI はエラーで終了します。翻訳の準備が整ったら (レビューが必要な場合は承認後に) 、[`gt download`](/docs/cli/reference/commands/download) を実行してください。[`gt 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`](/docs/cli/reference/commands/translate) を実行した場合、CLI はエラーで終了します。完了した翻訳は [`gt download`](/docs/cli/reference/commands/download) でダウンロードするか、以前にステージングしたバージョンには [`gt translate`](/docs/cli/reference/commands/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 download
```

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

* 人手によるレビューが有効な場合、または [Lottie](/docs/cli/reference/formats/lottie-files) のような非同期フォーマットを翻訳する場合は、`stage` を使用します。

- ステージングすると、[`stageTranslations`](/docs/cli/reference/config#stage) 設定キーが設定されます。詳しくは、[レビュー用に翻訳をステージする](/docs/cli/guides/managing-translations#review) を参照してください。