# gt: General Translation CLI tool: 翻訳の管理
URL: https://generaltranslation.com/ja/docs/cli/guides/managing-translations.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: General Translation CLI でローカルでの翻訳編集を upload、enqueue、download、stage、sync する方法。

[`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`](/docs/cli/reference/commands/enqueue) は待機しないため、翻訳の準備ができた時点で、後続のジョブで [`download`](/docs/cli/reference/commands/download) を実行できます。これにより、翻訳実行中にビルドジョブを待たせたままにせずに済みます。

## Lottie アニメーションを翻訳する [#lottie]

Lottie の翻訳では非同期レイアウト処理が行われるため、[`gt translate`](/docs/cli/reference/commands/translate) で1回の実行で送信とダウンロードを行うことはできません。アニメーションをステージングしてから、完了したロケールをダウンロードします。

```bash
npx gt stage
npx gt download
```

一部のロケールがまだ処理中の場合、ダウンロード時にそれらはスキップされます。後で [`gt download`](/docs/cli/reference/commands/download) を再実行してください。設定されているすべてのロケールがダウンロードされるまで、ステージング済みのファイルは `gt-lock.json` に残ります。設定、フォント、式の制限については、[Lottie形式のリファレンス](/docs/cli/reference/formats/lottie-files) を参照してください。

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

プロジェクトで人手によるレビューを使用している場合は、[`gt stage`](/docs/cli/reference/commands/stage) を使用して、同じ実行内で結果をダウンロードまたは公開せずに翻訳作業を送信してください。レビューが必要なプロジェクトでは、完了した翻訳が承認待ちの状態で保持されます。

```bash
npx gt stage
```

[`stage`](/docs/cli/reference/commands/stage) を実行すると、`gt.config.json` に `stageTranslations: true` が設定されます。翻訳が承認されたら、[`gt download`](/docs/cli/reference/commands/download) を実行してください。[`gt translate`](/docs/cli/reference/commands/translate) でも、以前にステージングしたバージョンをダウンロードできます。`stageTranslations` が有効になっている間、[`translate`](/docs/cli/reference/commands/translate) でダウンロードされるのはステージングしたバージョンだけです。何もステージングしていない場合、ファイルをダウンロードせずに完了します。

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

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

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

このコマンドは、ローカルファイルを最後にダウンロードしたバージョンと比較し、変更があったものの差分を計算して送信します。新しい翻訳がキューに追加されることはありません。[`gt translate`](/docs/cli/reference/commands/translate) や [`gt stage`](/docs/cli/reference/commands/stage) が新しい作業をキューに追加する前にこの手順を自動的に実行するには、`--save-local` を指定するか、`gt.config.json` で [`options.saveLocal`](/docs/cli/reference/config#save-local) を `true` に設定してください。

Apple の `.strings` および `.stringsdict` ファイル、Android の `strings.xml` ファイルの場合、プラットフォームは編集後のドキュメント全体を検証して保存します。`.xcstrings` の場合、すべてのロケールが同じファイルに保存されていても、CLI は各ロケールを個別に追跡して送信します。

## Next steps

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

## Sitemap

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