gt-react、gt-next

gt-next または gt-react のプロジェクトを自動翻訳

概要

このチュートリアルでは、gt-next または gt-react を使用する際に、プロジェクトの翻訳ファイルを自動管理する方法を説明します。

注意: これは本番ビルドをリリースする場合にのみ使用してください。開発環境で gt-next または gt-react を使用している場合、このコマンドは不要です。

次の4つの手順に従います:

環境変数を追加する

npx gtx-cli configure コマンドでプロジェクトを設定する

gtx-cli translate を実行する


ステップ 1: 環境変数を追加する

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

.env
GT_API_KEY=<APIキー>
GT_PROJECT_ID=<プロジェクトID>

ステップ2:npx gtx-cli configure コマンドでプロジェクトを設定する

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

npx gtx-cli configure

ステップ3:ビルドプロセスに gtx-cli translate コマンドを追加する

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

package.json
{
  "scripts": {
    "translate": "npx gtx-cli translate",
    "build": "npm run translate && <任意のビルドコマンド>"
  }
}

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

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


注意事項

  • gtx-cli translate コマンドで、プロジェクトに翻訳を自動的に追加できます。
  • 翻訳ファイルをコミットしたい場合は、コミット前に gtx-cli translate コマンドを実行してください。
  • 翻訳の出力先パスを設定するには、設定ドキュメントを参照してください。

次のステップ

このガイドはいかがですか?