# gt: General Translation CLI tool: ステージング
URL: https://generaltranslation.com/ja/docs/cli/stage.mdx
---
title: ステージング
description: レビュー用に翻訳をステージングする方法
---

## 概要

`gt stage` は、プロジェクトの翻訳を生成し、レビュー用としてステージするコマンドです。

このコマンドが有用なのは、プロジェクトで人によるレビューを有効にしている場合のみです。

## 使い方

<Callout type="error">
  本番環境向けにアプリをビルドする**前に**、これを CI パイプラインで実行してください。
</Callout>

```bash
npx gt stage
```

<Callout type="info">
  **注:**
  このコマンドの実行には本番用の API キーが必要です。[プラットフォーム](https://generaltranslation.com/dashboard)で取得してください。
</Callout>

`gt stage` コマンドは `translate` コマンドと同様に動作しますが、完了した翻訳をダウンロードしたり CDN に公開したりする代わりに、レビュー用にステージします。

`gt stage` を実行したら、プロセスを完了して翻訳をダウンロードするために `gt translate` を実行してください (ダウンロードする設定になっている場合) 。

<Callout type="warn">
  **本番環境でのみ使用してください！**

  このコマンドは本番ビルド用であり、**開発環境では使用しないでください**。
  実行する前に、本番環境で使用するブランチにいることを確認してください。
  また、環境変数に本番用の API キー (`GT_API_KEY`) とプロジェクト ID (`GT_PROJECT_ID`) も指定してください。
</Callout>

***


## フラグ

| Parameter                       | Description                                                       | Type       | Optional | Default                                                                                                                         |
| ------------------------------- | ----------------------------------------------------------------- | ---------- | -------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `--api-key`                     | 本番用の API キーを指定します                                                 | `string`   | `true`   |                                                                                                                                 |
| `--project-id`                  | プロジェクト ID を指定します                                                  | `string`   | `true`   |                                                                                                                                 |
| `--version-id`                  | バージョン ID を指定します (デフォルトではコンテンツのハッシュ)                               | `string`   | `true`   |                                                                                                                                 |
| `--config <path>`               | GT の設定ファイルへのパスを指定します                                              | `string`   | `true`   | `"gt.config.json"`                                                                                                              |
| `--tsconfig, --jsconfig <path>` | TS または JS の設定ファイルへのパスを指定します                                       | `string`   | `true`   |                                                                                                                                 |
| `--src <paths>`                 | ソースファイルに一致する glob パターンを、スペース区切りで指定します。ルートディレクトリからの相対パスである必要があります。 | `[string]` | `true`   | `[  'src/**/*.{js,jsx,ts,tsx}', 'app/**/*.{js,jsx,ts,tsx}', 'pages/**/*.{js,jsx,ts,tsx}', 'components/**/*.{js,jsx,ts,tsx}', ]` |
| `--dictionary <path>`           | 辞書ファイルへのパスを指定します                                                  | `string`   | `true`   |                                                                                                                                 |
| `--inline`                      | 辞書に加えて、インラインの `<T>` タグも含めます                                       | `boolean`  | `true`   | `true`                                                                                                                          |
| `--timeout`                     | 翻訳リクエストのタイムアウト時間 (秒)                                              | `number`   | `true`   | `900`                                                                                                                           |
| `--new, --locales <locales>`    | プロジェクトの翻訳先ロケールを指定します                                              | `[string]` | `true`   |                                                                                                                                 |
| `--default-locale <locale>`     | プロジェクトのソースロケール                                                    | `string`   | `true`   | `en`                                                                                                                            |
| `--ignore-errors`               | エラーを無視し、有効なコンテンツについては翻訳を強行します                                     | `flag`     | `true`   | `false`                                                                                                                         |
| `--tag [value]`                 | この翻訳実行にタグを付けます (値を指定しない場合は git から自動的に解決されます)                      | `string`   | `true`   |                                                                                                                                 |
| `-m, --message <message>`       | 翻訳タグに添付するメッセージ                                                    | `string`   | `true`   |                                                                                                                                 |
| `--dry-run`                     | コマンドをドライランで実行します                                                  | `flag`     | `true`   | `false`                                                                                                                         |

これらのパラメータはすべて省略可能です。

<Callout type="warn">
  API キーを `gt.config.json` ファイルに追加しないでください！
  代わりに環境変数として設定してください。設定されていれば、CLI は `GT_API_KEY` を自動的に読み取ります。
</Callout>

重要なパラメータがいくつかあります。

| Parameter                    | Description                                                        |
| ---------------------------- | ------------------------------------------------------------------ |
| `--dry-run`                  | このフラグを指定すると、CLI はプロジェクトを解析して検証しますが、GT API とは通信しません。コードベースの検証に便利です。 |
| `--api-key`                  | `--dry-run` を使用しない場合は、本番用の API キーを指定する必要があります。                     |
| `--project-id`               | 同様に、`--dry-run` を使用しない場合は、プロジェクト ID を指定する必要があります。                  |
| `--new, --locales <locales>` | プロジェクトの翻訳先ロケールです。これらは `gt.config.json` ファイルで指定した locales に追加されます。  |

### 設定ファイル

`gt stage` を実行すると、CLI は自動的に `gt.config.json` ファイルに `stageTranslations : true` プロパティを追加します。

このプロパティにより、特定のデプロイバージョンに対して事前に `stage` を実行せずに `translate` を実行すると、CLI ツールはエラーを出して終了します。