メインコンテンツまでスキップ

Internationalization (i18n)

Page summary:

Internationalization は、管理パネル上で複数ロケールのコンテンツを扱います。ロケールの追加、エントリーの翻訳、ロケール単位の権限の考え方を説明します。

Internationalization では、言語ごとの設定である「ロケール」単位でコンテンツを管理します。

IDENTITY CARD
プラン
無料機能
ロールと権限
特になし
有効化
利用可能だが既定ではオフ
環境
開発・本番の両方で利用できます

設定​

コンテンツマネージャーで使う前に、 Settings で Internationalization を構成し、 Content-type Builder でコンテンツタイプに有効化する必要があります。

Content-type Builder​

設定場所: Content-type Builder

コンテンツマネージャーでコンテンツタイプを翻訳可能にするには、Content-type Builder で有効にします。コンテンツタイプ単位およびフィールド単位で切り替えられます。

  1. 既存のコンテンツタイプ／フィールドを編集するか、新規に作成します。
  2. Advanced settings タブを開きます。
  3. コンテンツタイプでは「Internationalization」にチェックを入れ、フィールドでは「Enable localization for this field」にチェックを入れます。
コンテンツタイプビルダーの詳細設定コンテンツタイプビルダーの詳細設定

設定画面​

設定場所: Settings > Global Settings > Internationalization

Internationalization の画面では、Strapi アプリで使えるロケールが表形式で表示されます。既定では英語ロケールだけが登録され、既定ロケールにもなっています。

各行にはロケールの ISO コード、任意の表示名、既定ロケールかどうかが表示されます。管理者は次の操作もできます。

  • でロケールを編集する
  • でロケールを削除する

ロケールの追加​

ロケールは必要な数だけ追加・管理できます。Strapi アプリ全体の既定ロケールは 1 つだけです。

Note

独自のロケールコードは作れません。Strapi が定義した 500 以上のロケール一覧 から選ぶだけです。

  1. Add new locale をクリックします。
  2. ロケール追加ウィンドウで Locales ドロップダウンから追加するロケールを選びます。ISO コード順で、まだアプリにないロケールが並びます。
  3. （任意）Locale display name に表示名を入力します。
  4. （任意）Advanced settings で Set as default locale にチェックを入れると、新しいロケールをアプリ全体の既定にできます。
  5. Save で追加を確定します。
i18n でロケールを追加i18n でロケールを追加

AI による多言語​

GrowthThis feature is available with a Growth plan.

AI による多言語対応では、既定ロケールのコンテンツが更新されると、プロジェクト内の他ロケールへ自動翻訳されます。編集者は数秒で複数言語版を揃えられます。

既定ではオフです。有効にするには Settings > Global Settings > Internationalization を開き、 AI Translations を Enabled にします。

Internationalization の設定（AI）Internationalization の設定（AI）

コードベースの設定​

環境変数 STRAPI_PLUGIN_I18N_INIT_LOCALE_CODE（環境変数）で、環境ごとの既定ロケールを指定できます。値は Strapi のロケール一覧 にある ISO コードにします。

使い方​

利用場所: Content Manager — 対象コンテンツタイプの編集ビュー

コンテンツマネージャー で、コンテンツタイプに Internationalization が有効な場合、編集ビュー右上にロケール用のドロップダウンが表示され、ロケールを切り替えられます。

Info

選んでいるロケールはコンテンツタイプをまたいでも保持されます。例: あるタイプの編集でスペイン語を選ぶと、別のタイプへ移動してもスペイン語のままです（そのタイプで i18n がオフでも選択は残ります）。特定のロケールで横断的に作業しやすくなります。

Dynamic Zones やコンポーネントの内容もロケールごとに異なせます。ロケールによって Dynamic Zone の構成が違ったり、繰り返しコンポーネントのエントリー数や並びが違ったりします。

Caution

編集・公開できるロケールは常にひとつだけです。複数ロケールを同時に編集したり、Publish で一括公開したりはできません（Publish は現在開いているロケールにだけ効きます）。

別ロケールへ翻訳する手順は次のとおりです。

  1. 編集ビュー右上のロケールドロップダウンをクリックします。
  2. 翻訳先のロケールを選びます。
  3. コンテンツタイプの各フィールドに、そのロケール向けの内容を入力します。
i18n でロケールを切り替えi18n でロケールを切り替え
Tip

右上の Fill in from another locale をクリックすると、リレーション以外のフィールドを、選んだ別ロケールの値でまとめて埋められます。他言語の元文を思い出すのに便利です。AI による多言語 を有効にしている場合は Strapi AI が翻訳を担うため、このボタンは表示されません。

AI による多言語 NewThis content is new.​

GrowthThis feature is available with a Growth plan.

有効にすると、ソースとなるコンテンツ（既定ロケール）が更新されるたび、他ロケールへ自動翻訳されます。編集者は既定ロケールだけ手入力し、残りは Strapi AI が数秒で揃えます。

有効化後、既定ロケールでコンテンツタイプを編集して Save すると、同じタイプの他ロケールも自動翻訳され、All locales have been translated の通知で確認できます。この機能は Strapi AI のクレジットを消費します。

AI 連携の i18nAI 連携の i18n
Caution

AI による多言語は既定ロケールだけが正という一方向の動きです。有効にしたあとは次に注意してください。

  • 既定ロケール以外を編集して保存しても、自動翻訳は走りません。
  • 既定ロケールを編集すると、他ロケールに手で入れた変更は上書きされます。
Strapi AI credits

Strapi AI includes 1,000 credits per month on the Growth plan, and 10 free credits during the free trial. Lightweight actions use fewer credits, while more complex ones use more.

You can check your credit usage in the Settings Overview of the admin panel. Notifications are sent when your usage reaches 80%, 90%, and 100% of your monthly allowance.

When your credits run out on the Growth plan, you can keep using Strapi AI, with overages billed monthly.

For more information about Strapi AI, please refer to the dedicated support article.

API での利用​

locale パラメーターで、指定ロケールのコンテンツを取得・作成・更新・削除できます。利用できるのは Strapi の Content API に接続する各フロント向け API です。

バックエンドの Document Service API でもロケールを扱えます。

このページを編集