言語の追加
Liferayには45以上の言語の翻訳が含まれていますが、含まれていない言語が必要な場合は追加できます。言語を追加するということは、その言語のロケールをインストール環境に登録し、言語キーを指定し、必要に応じて右から左への方向を設定し、言語セレクターにその言語のフラグアイコンを割り当てることを意味します。
Liferayに既に必要な言語が含まれている場合は、この手順は翻訳を変更する場合にのみ使用してください。含まれている言語をユーザーが利用できるようにするには、 初期インスタンスのローカライズ および サイトのローカライズ を参照してください。
新しい言語を追加する
デフォルトでは、 portal.properties ファイルがLiferayで利用可能なすべての言語を指定します。指定されていない新しい言語を追加するには
-
ご使用の言語の ISO 639-1 標準コード をメモしてください (たとえば、アムハラ語の ISO コードは
amになります)。 -
ご使用の言語に対応する ISO 3166-1 alpha-2 2 文字の国コード をメモしてください。(例えば、エチオピアのISOコードは
ETとなります)。 -
Liferay インストールディレクトリにある
web.xmlファイルを修正して置き換えます:[LIFERAY_HOME]/tomcat-[version]/webapps/ROOT/WEB-INF/。<web-resource-name>の下に新しい言語を追加してください。例えば、<url-pattern>/am/c/portal/protected</url-pattern> <url-pattern>/am-ET/c/portal/protected</url-pattern> <url-pattern>/am_ET/c/portal/protected</url-pattern> -
Liferay インストールディレクトリにある
shielded-container-web.xmlファイルを修正して置き換えます:[LIFERAY_HOME]/tomcat-[version]/webapps/ROOT/WEB-INF/。<servlet-mapping>の下に新しい言語を追加してください。例えば、<servlet-mapping> <servlet-name>I18n Servlet</servlet-name> <url-pattern>/am/*</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>I18n Servlet</servlet-name> <url-pattern>/am-ET/*</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>I18n Servlet</servlet-name> <url-pattern>/am_ET/*</url-pattern> </servlet-mapping> -
インストール先のLiferay ホームフォルダ内にある
portal-ext.propertiesファイルを作成または編集してください。注: このファイルは、portal.propertiesファイルで定義されている有効なデフォルトロケールを上書きします。したがって、portal-ext.propertiesファイルで使用する予定のすべての言語をリストします。ロケールとロケールを両方とも定義します。を有効にします。例えば:locales=am_ET,ar_SA,fa_IR,en_US,zh_CN,ja_JP locales.enabled=am_ET,ar_SA,fa_IR,en_US,zh_CN,ja_JP -
新しい言語の言語キーを追加してください。これには2つの方法があります。
-
言語オーバーライドツール を使用してください。これは、 Liferay DXP 7.4 U4/Portal 7.4 GA8 以降、新しい言語キーを追加する推奨方法です。。
-
言語モジュール を使用し、言語キーを
language.propertiesファイルに記述します。この方法では、方向性や名前の構造など、言語設定をより細かく制御できます。
-
-
コントロール パネル → インスタンス設定 → ローカライズ に移動します。新しい言語を確認し、現在の言語リストに移動します。をクリックして保存します。

-
デフォルト言語を新しい言語に変更し、 保存 をクリックします。新しい言語は現在、Liferayインスタンスで使用されています。

言語オーバーライドツールを使用して言語キーを追加する
-
言語オーバーライド ページに移動します。
-
変更したい言語キーを検索してクリックしてください。
-
上書きしたい値を入力してください。

言語モジュールを使用して言語キーを追加する
-
言語用の
language.propertiesファイルを作成し、ファイル名に ISO コードを使用してください。例えば、アムハラ語の場合はLanguage_am.propertiesとなります。create-account=መለያ መፍጠር email-address=የ ኢሜል አድራሻ forgot-password=መክፈቻ ቁልፉን ረሳኽው home=መነሻ ገጽ password=ፕስወርድ powered-by-x=በ {0} የተጎላበተ remember-me=አስታወስከኝ search=የፍለጋ አሞሌ sign-in=ስግን እን -
作成した
language.propertiesファイルを使用して言語モジュールを作成し、そのモジュールを Liferay インストール環境にデプロイします。サンプルプロジェクトとこのモジュールを作成するための具体的な手順については、 言語プロパティによるグローバル言語翻訳の上書き を参照してください。
方向性を変える
右から左に書く言語を追加する場合は、言語プロパティに次のプロパティを追加してください。
lang.dir=rtl
これはサイトのCSSに予期せぬ影響を与える可能性があります。 CSS ルールの変換 (反転) を防ぐには、適用したい CSS ルールの左側に /* @noflip */ という装飾を配置します。この例では、選択した言語の書き方に関係なく、 body の左余白を設定します。に 20em
/* @noflip */ body {
margin-left: 20em;
}
また、CSSセレクタ .rtl を使用して、ルールをRTL言語のみに適用することもできます。言語設定のカスタマイズに関する詳細については、 言語プロパティによるグローバル言語翻訳の上書き を参照してください。
国旗アイコンを追加する
Liferayに標準搭載されている言語には、言語セレクター上に表示される国旗アイコンが付いています。
新しい言語に国旗アイコンを追加する方法は2つあります。
-
ユーザーページには テーマ スプライト マップ クライアント拡張機能 を、管理者ページには 管理者テーマ を使用してください。
以下の例では、アムハラ語を表すためにエチオピアの国旗を追加しています。
<symbol id="am-et" viewBox="0 0 1200 600">
<path fill="#da121a" d="M0 0H1200V600H0z"/>
<path fill="#fcdd09" d="M0 0H1200V400H0z"/>
<path fill="#078930" d="M0 0H1200V200H0z"/>
<g transform="matrix(1.6666667,0,0,1.6666667,600,300)">
<circle r="120" fill="#0f47af"/>
<g id="a">
<path d="m 0,-96 -4.205849,12.944272 17.347494,53.390097 H -9.987258 l -2.599358,8 h 74.162668 l 11.011056,-8 H 21.553343 Z" fill="#fcdd09"/>
<path d="M 0,44 V 96" transform="rotate(-144)" stroke="#fcdd09" stroke-width="4"/>
</g>
<use xlink:href="#a" transform="rotate(72)" width="100%" height="100%"/>
<use xlink:href="#a" transform="rotate(144)" width="100%" height="100%"/>
<use xlink:href="#a" transform="rotate(-144)" width="100%" height="100%"/>
<use xlink:href="#a" transform="rotate(-72)" width="100%" height="100%"/>
</g>
</symbol>
テーマスプライトマップクライアント拡張機能を使用してユーザーページに旗アイコンを追加する
Liferay 7.4
-
テーマ スプライト マップ クライアント拡張機能 を作成します。
-
spritemap.svgの中に、旗の SVG を<symbol>タグの中に追加します。idは、あなたの言語コードである必要があります。 -
クライアント拡張機能をLiferayにデプロイします。
-
新しい空白ページを作成し、言語セレクターのフラグメントを追加します。あなたの言語には国旗アイコンがありません。

-
クライアント拡張機能を追加して、ページを公開してください。あなたの国旗が言語選択画面に表示されるようになりました。

フラグを表示させたいすべてのページまたはページテンプレートで、このクライアント拡張機能を使用してください。 Theme Sprite Map Client Extensions の詳細については、 Theme Sprite Map Client Extension の使用 を参照してください。
クラシックテーマを使用してユーザーページに旗のアイコンを追加する
Liferay Themes Toolkit は、Liferay 2024.Q4+ 以降 非推奨 となり、将来のリリースで削除される予定です。代わりに、 クライアント拡張機能 を使用してテーマを作成するか、 サイト初期化子 を使用してください。
-
Liferay の テーマジェネレーター を使用してテーマを作成します。
-
src/images/clay/icons.svgを変更し、旗の SVG を<symbol>タグ内に追加します。idは、あなたの言語コードである必要があります。 -
package.jsonを更新して、各依存関係の適切なバージョンを使用するようにします。 -
src/WEB-INF/liferay-look-and-feel.xmlを、 liferay-portal リポジトリ の例に従って変更します。 -
ルートモジュールディレクトリで
gulp deployを実行します。 -
旗のアイコンを表示させたいすべてのページまたはページテンプレートに、テーマを追加してください。テーマの詳細については、 テーマ を参照してください。
管理テーマを使用して管理ページに旗のアイコンを追加する
-
Liferay の テーマジェネレーター を使用してテーマを作成します。
-
src/images/clay/icons.svgを変更し、旗の SVG を<symbol>タグ内に追加します。idは、あなたの言語コードである必要があります。 -
package.jsonを更新して、各依存関係の適切なバージョンを使用するようにします。 -
src/WEB-INF/liferay-look-and-feel.xmlを変更して、これを管理テーマにします。 liferay-portal リポジトリ の例に従ってください。 -
ルートモジュールディレクトリで
gulp deployを実行します。管理画面のテーマは自動的に適用されます。 -
新しい変更を適用するには、ページを更新してください。
テーマの詳細については、 テーマ を参照してください。