# gt: General Translation CLI tool: 翻訳 CLI
URL: https://generaltranslation.com/ja/docs/cli.mdx
---
title: 翻訳 CLI
description: General Translation のCLIツールを使ってプロジェクトをセットアップし、翻訳する
---

## 概要

General Translation の CLI ツール (`gt`) を使うと、国際化をセットアップし、プロジェクトを任意の[対応言語](/docs/platform/supported-locales)に自動翻訳できます。

このツールは、[`gt-next`](/docs/next)、[`gt-react`](/docs/react)、[`gt-react-native`](/docs/react-native) に対応しており、`next-intl` や `i18next` などのサードパーティ製 i18n ライブラリでも利用できます。JSON、MDX、HTML などの単体ファイルの翻訳にも使用できます。

## Quickstart

### 1. プロジェクトをセットアップする

```bash
npx gt@latest
```

セットアップウィザードが実行され、次の処理が行われます。

* 必要な依存関係 (例: `gt-next` または `gt-react`) をインストール
* フレームワークを設定 (Next.js plugin、React プロバイダーなど) 
* ロケールとファイル設定を含む `gt.config.json` を作成
* API 認証情報を生成


### 2. translate

```bash
npx gt translate
```

このコマンドは、General Translation API を使用してプロジェクトを翻訳します。本番環境向けに build する**前**に、CI/CD パイプラインで実行してください。

<Callout type="info">
  **注:** `translate` コマンドの実行には本番環境用の API キーが必要です。セットアップウィザードで生成するか、[generaltranslation.com](https://generaltranslation.com) で取得できます。
</Callout>

以上です。1 言語のプロジェクトを完全に翻訳されたプロジェクトにするのに必要なコマンドは、2 つだけです。


## コマンド

| コマンド                                        | 説明                                                     |
| ------------------------------------------- | ------------------------------------------------------ |
| [`npx gt@latest`](/docs/cli/init)           | セットアップウィザードを実行します。依存関係をインストールし、プロジェクトを設定して、認証情報を生成します。 |
| [`npx gt translate`](/docs/cli/translate)   | GT API を使ってプロジェクトを翻訳します。                               |
| [`npx gt configure`](/docs/cli/configure)   | プロジェクトの GT 設定 (`gt.config.json`) を更新します。               |
| [`npx gt auth`](/docs/cli/auth)             | API 認証情報を生成または更新します。                                   |
| [`npx gt generate`](/docs/cli/generate)     | スタンドアロンで使用する翻訳データの JSON ファイルを生成します。                    |
| [`npx gt upload`](/docs/cli/upload)         | ソースファイルと訳文を GT プラットフォームにアップロードします。                     |
| [`npx gt enqueue`](/docs/cli/enqueue)       | 結果をダウンロードせずに、翻訳対象のファイルをエンキューします。                       |
| [`npx gt download`](/docs/cli/download)     | 以前にエンキューまたは stage された訳文をダウンロードします。                     |
| [`npx gt stage`](/docs/cli/stage)           | 公開前に人によるレビュー向けに訳文を準備します。                               |
| [`npx gt save-local`](/docs/cli/save-local) | ローカルで編集した訳文を GT プラットフォームに保存します。                        |

## ガイド

| ガイド                              | 説明                      |
| -------------------------------- | ----------------------- |
| [Branching](/docs/cli/branching) | Git ブランチごとに翻訳を分けて管理します。 |
| [よくある質問](/docs/cli/faqs)         | CLI ツールに関するよくある質問です。    |

## 対応形式

CLI ではさまざまな形式のファイルを翻訳できます。

[GT](/docs/cli/formats/gt) · [JSON](/docs/cli/formats/json) · [MDX](/docs/cli/formats/mdx) · [TypeScript/JavaScript](/docs/cli/formats/ts) · [YAML](/docs/cli/formats/yaml) · [PO/POT](/docs/cli/formats/po) · [HTML](/docs/cli/formats/html) · [プレーンテキスト](/docs/cli/formats/txt)