# gt: General Translation CLI tool: ローカルでの編集を保存する
URL: https://generaltranslation.com/ja/docs/cli/save-local.mdx
---
title: ローカルでの編集を保存する
description: ローカルの翻訳ファイルへの編集を保存する方法
---

## 使い方

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

<Callout type="info">
  このコマンドの実行には API キーが必要です。API キーは
  [プラットフォーム](https://generaltranslation.com/dashboard)
  で取得できます。
</Callout>


## 概要

`gt save-local` コマンドは、翻訳ファイルに対してローカルで行った編集内容を General Translation プラットフォームに反映します。処理の流れは次のとおりです。

1. `gt.config.json` から設定済みのファイルを読み取る
2. 現在の git ブランチ情報を特定する
3. ローカルの翻訳ファイルを、最後にダウンロードした最新のサーバーバージョンと比較する
4. 加えた変更の差分を計算する
5. その差分を General Translation プラットフォームに送信する

このコマンドは**新しい翻訳をキューに追加しません**。ローカルでの編集内容をプラットフォームに同期するだけです。

<Callout type="info">
  これは、あなたやチームが翻訳ファイルをローカルで手動編集し、
  その変更をプラットフォームにも反映したい場合に便利です。たとえば、
  翻訳者が JSON ファイルを直接修正した場合などです。
</Callout>

## 仕組み

CLI は、どの翻訳がダウンロード済みかをロックファイルで管理します。`save-local` を実行すると、次の処理が行われます。

1. コンテンツハッシュを比較して、前回のダウンロード以降に変更されたファイルを特定します
2. それらのファイルについて、元のサーバー上の内容を取得します
3. サーバー版とローカル版の unified 差分を生成します
4. その差分をプラットフォームに送信します

実際に変更されたファイルだけが処理されます。

***

## フラグ

| Parameter      | Description                    | Type     | Optional | Default            |
| -------------- | ------------------------------ | -------- | -------- | ------------------ |
| `--api-key`    | General Translation の API キー   | `string` | `true`   |                    |
| `--project-id` | General Translation のプロジェクト ID | `string` | `true`   |                    |
| `-c, --config` | GT 設定ファイルのパス                   | `string` | `true`   | `"gt.config.json"` |
| `--publish`    | 翻訳を CDN に公開する                  | `flag`   | `true`   | `false`            |

これらのパラメータは、環境変数または `gt.config.json` で設定している場合、すべて省略できます。

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

## 関連コマンド

* [`gt translate`](/docs/cli/translate) - プロジェクトを翻訳し、翻訳結果をダウンロードします
* [`gt translate --save-local`](/docs/cli/translate) - 翻訳前にローカルでの編集を保存します (両方の操作をまとめて実行)