# gt: General Translation CLI tool: gt stage
URL: https://generaltranslation.com/ja/docs/cli/reference/commands/stage.mdx
Docs index: https://generaltranslation.com/llms.txt
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) はステージングされたバージョンのみをダウンロードします。ステージングされたバージョンがない場合は、ファイルをダウンロードせずに完了します。翻訳の準備が整ったら (レビューが必要な場合は承認後に) 、[`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) はステージングされたバージョンのみをダウンロードします。ステージングされたバージョンがない場合、ファイルをダウンロードせずに完了します。完了した翻訳は [`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`                     | 翻訳のアップロードやキューへの登録を行わずに、解析と検証を行います。                                                                           | `boolean`  | はい | `false`          |
| `--save-local, --no-save-local` | キューへの登録前に local edits を保存するかどうかを切り替えます。[`options.saveLocal`](/docs/cli/reference/config#save-local) を上書きします。 | `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) を参照してください。

## Sitemap

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