ロケールを管理する

概要

このドキュメントは、gt-next を使用して Next.js アプリケーションでロケールを管理する方法についてのガイダンスを提供します。サポートしたいロケールのリストを設定し、翻訳の生成をトリガーする手順を説明します。

このライブラリは、ロケールを定義するために BCP-47 標準を使用します。現在サポートされているロケールのリストはこちらを参照してください。

本番環境のロケールを変更する方法は2つあります：

翻訳を実行するためには、ビルドスクリプトに翻訳コマンドを追加する必要があります：

package.json

{
  "scripts": {
    "build": "npx gtx-cli translate && next build"
  }
}

これにより、必要な翻訳が生成され、設定に応じてクラウドまたはローカルファイルシステムに保存されます。

ロケールを管理する最も簡単な方法は、--localesフラグを使用してnpx gtx-cli translateコマンドを通じて指定することです。

package.json

{
  "scripts": {
    "build": "npx gtx-cli translate --locales en-US zh jp && <YOUR_BUILD_COMMAND>"
  }
}

これにより、中国語（zh）と日本語（jp）の翻訳が生成されます。

ロケールを管理するより堅牢な方法は、gt.config.jsonファイルを使用することです。 localesプロパティでサポートしたいロケールのリストを指定できます。

gt.config.json

{
  "locales": ["zh", "jp"],
}

オプション機能として、ホワイトリストに登録されたロケールのリストを追加できます。これは、プロジェクトロケールページのダッシュボードからアクセスできます。この機能を有効にすると、ホワイトリストに登録されていないロケールで npx translate を呼び出そうとすると失敗します。

ロケールは、ダッシュボード、gt.config.json ファイル、または CLI ツールを通じて管理できます。
gt.config.json または CLI ツールを使用してロケールを管理すると、ダッシュボードの Manage Locales 機能が無効になります。