Liferay Digital Experience Platform (DXP) 7.0やLiferay Portalのバージョンをインストールする際、ポータル管理者はデフォルトのインストールに付属する翻訳のいずれかを活用するオプションがあります。 この記事では、これらの翻訳を修正するための最適な方法について説明します。
解像度
まず、修正する言語がLiferayの公式サポート言語の中にあるかどうかを確認します。 どの言語に対応しているかは、 portal.properties ファイルで以下を検索することで確認できます:
Liferay DXP 7.0
locales.enabled" = supported "と記載されている言語はすべてサポートされています。
# Specify the locales that are enabled by default.
#
locales.enabled=ca_ES,zh_CN,nl_NL,en_US,fi_FI,fr_FR,de_DE,iw_IL,hu_HU,ja_JP,pt_BR,es_ES
OSGiの実装とモジュール化のため、フックやモジュールで言語プロパティをオーバーライドする場合 、 portal-ext.propertiesでなく、モジュールで希望のロケールを指定する必要があります。 portal.properties の情報は、リファレンスとして、またコアプラットフォームとして、引き続き有用です。
Liferay Portal 6.2 EE
locales.enabled" = supported "と記載されている言語はすべてサポートされています。
# Specify the locales that are enabled by default.
#
locales.enabled=ca_ES,zh_CN,nl_NL,en_US,fi_FI,fr_FR,de_DE,iw_IL,hu_HU,ja_JP,pt_BR,es_ES
Liferay Portal 6.1 EE GA3以下。
ベータ版言語リストにない言語=サポートされています。 言語がサポートされており、サブスクリプションが許可されている場合は、ヘルプセンターでサポートチケットを開いてください。
Liferay Portal 6.2 EEのみ。
興味のある言語が公式にサポートされていない場合、またはBasic/Limitedサブスクリプションをお持ちの場合、以下の手順で簡単にポータルの翻訳を更新、修正、拡張することができます:
- Liferay Developer Studioで新規にLiferayプロジェクトを作成し、Plugin TypeとしてHookを選択します。
- それができたら、
docroot/WEB-INF/srcの下に、例えば contentという名前の新しいフォルダを作り、適切なlanguage.propertiesファイルを作成します。この例では、これがそうです:Language_en.propertiesです。 - 3)
liferay-hook.xmlで、このファイルを参照する:<hook><language-properties>content/Language_en.properties</language-properties></hook>注意:英語の翻訳を上書き/カスタマイズしたい場合は、
Language_en.propertiesファイルに変更内容を適用する必要があります。 Language.propertiesファイルは、特定の言語キーが存在しない場合にポータルがフォールバックするデフォルトの言語キーファイルであるため、Language.propertiesファイルのみを変更した場合は適用されません。 - これで、ポータルメッセージをカスタマイズする準備が整いました。 この例で説明すると、元の
Language_en.propertiesファイルを開いて、変更したい属性を見つけます。 フックの言語ファイルに新しい文字列を書き込む。
参考までに、Liferayの公式ドキュメント Sharing Language Keys Between Portlets と Overriding Language Properties Using Hookを参照してください。
追加情報
Liferay Portal 6.0、6.1、6.2のみ。
公式にサポートされていない言語は、Liferayのコミュニティによって維持され、各言語には指定された Translation Leaderがいます。 Pootleシステムを使用するか、GitHubの対応する翻訳リーダーにプルリクエストを送信することで、自身で貢献し、Liferayポータルの最新バージョンの翻訳を送信できます。
付属の、フックのサンプルは2つです。 1つは、すべてのLiferay Portal 6.0バージョンに展開できるフックです。 このサンプルでは、コントロールパネルの Pages ポートレットの表示名を Pages から Community Pagesに変更します。
また、すべてのLiferay Portal 6.1バージョンにデプロイ可能な2つ目のフックも用意されています。 このサンプルでは、コントロールパネルの サイト設定 ポートレットの表示名を、 サイト設定 から 私の会社設定に変更しています。