JSONファイル

General Translationを使用してプロジェクトのJSONファイルの自動翻訳を設定する方法

概要

gtx-cliを使用して、どのi18nライブラリを使用しているかに関わらず、プロジェクトのJSONファイルを自動的に翻訳することができます。

注意: 現在、以下のi18nライブラリのカスタム文字列構文とフォーマットをサポートしています：next-intl、i18next、gt-next、gt-react。

別のi18nライブラリを使用している場合、カスタム構文とフォーマットを持つ文字列（例えば、ICUメッセージ）の翻訳結果が正確でない可能性があります。お気に入りのライブラリが見つかりませんか？ぜひお知らせください。できるだけ早く追加します！

以下の4つのステップに従います：

環境変数を追加する

gtx-cliをインストールする

gtx-cli initコマンドでプロジェクトを初期化する

ヒント: <T>コンポーネントを使用して、翻訳ファイルを使用する手間を省きましょう。

本番環境のAPIキーとプロジェクトIDを環境変数に追加します。これはgtx-cliツールを使用するために必要です。これらはGeneral Translationダッシュボードから取得できます。

.env

GT_API_KEY=<your-api-key>
GT_PROJECT_ID=<your-project-id>

プロジェクトにgtx-cliツールをインストールします。

npm i --save-dev gtx-cli

gtx-cli initコマンドを実行してプロジェクトを設定します。

npx gtx-cli init

ビルドコマンドの前にビルドまたはCIプロセスにgtx-cli translateコマンドを追加して、プロジェクトに自動的に翻訳を追加します。

package.json

{
  "scripts": {
    "translate": "npx gtx-cli translate",
    "build": "npm run translate && <your build command>"
  }
}

これにより、すべてのロケールの翻訳が生成され、プロジェクトに保存されます。これらのファイルをリポジトリにコミットしたい場合は、代わりにコミット前にこのコマンドを実行できます。

完了です！これで、プロジェクトが変更されるたびに、すべての翻訳JSONファイルが自動的に更新されます。