# gt: General Translation CLI tool: 翻訳の管理
URL: https://generaltranslation.com/ja/docs/cli/guides/managing-translations.mdx
---

title: 翻訳の管理
description: "General Translation CLI で翻訳を管理する方法。このガイドでは、ワークフローを upload、enqueue、download の各段階に分ける方法、レビュー用に翻訳をステージングする方法、ローカルでの編集を同期する方法を説明します。"
related:
  links:
    - /docs/cli/guides/generating-translations
    - /docs/cli/guides/branching
    - /docs/cli/guides/configuring
    - /docs/cli/guides/using-autoderive

---

[`gt translate`](/docs/cli/reference/commands/translate) コマンドは、翻訳フロー全体を 1 回で実行します。CI のステージを分けたり、人手によるレビューの工程を挟んだりするなど、より細かく制御したい場合は、CLI でこのフローの各部分を個別のコマンドとして実行できます。

*注: これらのコマンドには本番用の API キーが必要です。`GT_API_KEY` と `GT_PROJECT_ID` を環境変数として設定してください。*

## CI ステージごとに翻訳を分ける [#split]

CI パイプラインでは、コンテンツのアップロード、翻訳、結果のダウンロードを別々のジョブに分けたいことがよくあります。次の 3 つのコマンドが、それぞれのステージに対応しています。

1. [`gt upload`](/docs/cli/reference/commands/upload) は、ソースファイル (および既存の翻訳があればそれも) をプラットフォームにアップロードします。
2. [`gt enqueue`](/docs/cli/reference/commands/enqueue) は、アップロードしたファイルを翻訳キューに追加し、結果を待たずにすぐ終了します。
3. [`gt download`](/docs/cli/reference/commands/download) は、完了した翻訳をダウンロードし、設定内のパスに保存します。

```bash
# ステージ1: ソースファイルをアップロード
npx gt upload

# ステージ2: 翻訳をキューに追加
npx gt enqueue

# ステージ3: 準備ができたらダウンロード
npx gt download
```

`enqueue` は待機しないため、翻訳の準備ができた時点で、後続のジョブで `download` を実行できます。これにより、翻訳の実行中にビルドジョブを待たせたままにせずに済みます。

## レビュー用に翻訳をステージする [#review]

プロジェクトで人手によるレビューを使用している場合は、直接翻訳する代わりに [`gt stage`](/docs/cli/reference/commands/stage) を使用してください。これは [`translate`](/docs/cli/reference/commands/translate) と同様に動作しますが、結果をダウンロードまたは公開せず、承認待ちの状態にします。

```bash
npx gt stage
```

`stage` を実行すると、`gt.config.json` に `stageTranslations: true` が設定されます。翻訳が承認されたら、`gt translate` を実行してダウンロードしてください。`stageTranslations` が有効になっている間、`translate` でダウンロードされるのはステージしたバージョンだけです。何もステージしていなければ、ダウンロードするものはありません。

## ローカルの編集を保存 [#save-local]

自分または翻訳者がダウンロードした翻訳ファイルを手動で編集した場合は、[`gt save-local`](/docs/cli/reference/commands/save-local) を使用して、その編集内容をプラットフォームに送り返します。

```bash
npx gt save-local
```

このコマンドは、ローカルファイルを最後にダウンロードしたバージョンと比較し、変更があったものの差分を計算して送信します。新しい翻訳がキューに追加されることはありません。代わりに、ローカルでの編集を翻訳実行に含めるには、`translate` に `--save-local` を指定してください。
## Next steps

- /docs/cli/guides/generating-translations
- /docs/cli/guides/branching
- /docs/cli/guides/configuring
- /docs/cli/guides/using-autoderive