翻訳の自動生成

Liferay DXPは、標準で50の言語をサポートしています。 各ロケールには、その言語のキーを含む独自の 言語プロパティ ファイル があります。

カスタム言語キーを使用してアプリケーションを作成する場合、これらすべての異なる言語に翻訳するのは面倒で困難です。 幸い、LiferayのLanguage Builderツールを使用して、翻訳を自動的に生成できます。 Language Builderは、MicrosoftのTranslator APIを使用して翻訳を生成します。

注

機械翻訳の精度と正確性は、言語ごとに異なります。 自己責任でご使用ください。

サンプルプロジェクトを参照する

新しいLiferay DXPインスタンスを起動し、以下を実行します。

docker run -it -m 8g -p 8080:8080 liferay/dxp:2025.q1.6-lts

メールアドレス [e-mail] とパスワード testを使用して、 http://localhost:8080 で Liferay にサインインします。 プロンプトが表示されたら、パスワードを learnに変更します。

次に、以下の手順に従います。

1. Automatically Generated Translationsをダウンロードして解凍します。

   curl https://resources.learn.liferay.com/examples/liferay-m7d6.zip -O
   

   unzip liferay-m7d6.zip
   

2. モジュールのルートフォルダにあるgradle.propertiesファイルを開きます。 Microsoft Translator購読キーを追加します。

   microsoft.translator.subscription.key=[your unique key]
   

   注意: Language Builder が動作するには、独自の Microsoft Translator サブスクリプション キーを取得する必要があります。

3. モジュールルートから、Language Builderを実行します。

   ./gradlew buildLang
   

   ターミナルウィンドウで、Language Builderはさまざまな言語プロパティファイルを生成します。 「Translation is disabled because credentials are not specified」というエラーが表示された場合は、購読キーが正しいことを再確認してください。

4. モジュールのsrc/main/resources/contentフォルダに移動して、翻訳されたプロパティファイルを表示します。

言語キーの追加

サンプルプロジェクトでは、Language.propertiesファイルに1つの言語キーがあります。 アプリケーションに必要な数の言語キーを追加してから、Language Builderを実行します。

言語キーを Liferay にデプロイするには、「 言語プロパティによるグローバル言語翻訳の上書き」を参照してください。 既存のキーをオーバーライドする場合でも、新しいキーを追加する場合でも、手順は同じです。

一部の言語を自動的に翻訳されないようにする場合は、プロジェクトのbuild.gradleファイルでexcludedLanguageIdsプロパティを使用します。 たとえばフランス語を除外するには、

buildLang {
	excludedLanguageIds = ["fa"]
}

言語ビルダー ツールと追加の構成の詳細については、 Lang Builder Gradle プラグインを参照してください。

関連トピック

• 言語プロパティによるグローバル言語翻訳の上書き
• 言語オーバーライドによる翻訳の変更