# gt: General Translation CLI tool: gt save-local
URL: https://generaltranslation.com/ja/docs/cli/reference/commands/save-local.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 差分を送信して、ローカルの翻訳ファイルに加えた編集を General Translation プラットフォームに同期します。gt save-local コマンドの API リファレンス。

差分を送信して、翻訳ファイルに加えたローカルの編集を General Translation プラットフォームに同期します。新しい翻訳をキューに追加することはなく、ローカルでの変更を同期するだけです。[翻訳を管理する](/docs/cli/guides/managing-translations#save-local) を参照してください。

あなたまたは翻訳者がダウンロードした翻訳ファイルを手作業で編集し、その変更をプラットフォームにも反映させたい場合に使用します。

*注: `GT_API_KEY` と `GT_PROJECT_ID` が必要です。*

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

## 仕組み [#how-it-works]

1. `gt.config.json` で設定されたファイルを読み込みます。
2. 現在の git branch を判別します。
3. コンテンツハッシュを比較して、前回のダウンロード以降に変更されたファイルを特定します。
4. サーバー上の元のコンテンツを取得し、変更された各ファイルの差分を計算します。
5. 差分をプラットフォームに送信します。処理対象となるのは変更されたファイルのみです。
6. 差分が1件以上保存され、かつ公開が設定されているか `--publish` が指定されている場合は、設定された CDN の公開・非公開ルールを適用します。ローカルに変更がない場合、公開はスキップされます。

## フラグ [#flags]

| パラメータ                 | 説明                              | 型         | 任意 | デフォルト            |
| --------------------- | ------------------------------- | --------- | -- | ---------------- |
| `--api-key <key>`     | General Translation の API キーです。 | `string`  | はい | `GT_API_KEY`     |
| `--project-id <id>`   | プロジェクト ID です。                   | `string`  | はい | `GT_PROJECT_ID`  |
| `-c, --config <path>` | 設定ファイルのパスです。                    | `string`  | はい | `gt.config.json` |
| `--publish`           | ローカルの差分を保存した後、CDN の公開ルールを使用します。 | `boolean` | はい | `false`          |

## 例 [#example]

```bash
# ローカルの編集内容を翻訳ファイルとしてプラットフォームに送信する
npx gt save-local

# 編集内容をsyncして、更新された翻訳をCDNに公開する
npx gt save-local --publish
```

## その他のメモ [#notes]

* CLI は、ダウンロード済みの翻訳をロックファイルで追跡し、前回のダウンロード以降に変更されたファイルだけを処理します。
* [`gt translate`](/docs/cli/reference/commands/translate) と [`gt stage`](/docs/cli/reference/commands/stage) は、デフォルトではローカルの編集を保存しません。この処理を 1 回の実行だけ有効にするには `--save-local` を、すべての実行で有効にするには [`options.saveLocal`](/docs/cli/reference/config#save-local) を使用します。新しい翻訳作業を開始せずに編集内容を同期するには、`gt save-local` を使用します。
* Apple の `.strings` および `.stringsdict` ファイル、Android の `strings.xml` ファイルは、検証されたうえで完全な raw ドキュメントとして保存されます。`.xcstrings` の場合、すべてのロケールが 1 つのファイルを共有していても、CLI は各ロケールのスライスを個別に追跡して送信します。
* `gt.config.json` に API キーを保存しないでください。CLI は `GT_API_KEY` を環境変数から自動的に読み取ります。

## Sitemap

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