Customizing Localization
ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、 こちら までご連絡ください。

言語の追加

Liferayには45以上の言語の翻訳が含まれていますが、含まれていない言語が必要な場合は追加できます。言語を追加するということは、その言語のロケールをインストール環境に登録し、言語キーを指定し、必要に応じて右から左への方向を設定し、言語セレクターにその言語のフラグアイコンを割り当てることを意味します。

注記

Liferayに既に必要な言語が含まれている場合は、この手順は翻訳を変更する場合にのみ使用してください。含まれている言語をユーザーが利用できるようにするには、 初期インスタンスのローカライズ および サイトのローカライズ を参照してください。

新しい言語を追加する

デフォルトでは、 portal.properties ファイルがLiferayで利用可能なすべての言語を指定します。指定されていない新しい言語を追加するには

  1. ご使用の言語の ISO 639-1 標準コード をメモしてください (たとえば、アムハラ語の ISO コードは am になります)。

  2. ご使用の言語に対応する ISO 3166-1 alpha-2 2 文字の国コード をメモしてください。(例えば、エチオピアのISOコードは ETとなります)。

  3. 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>
    
  4. 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>
    
  5. インストール先の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
    
  6. 新しい言語の言語キーを追加してください。これには2つの方法があります。

    • 言語オーバーライドツール を使用してください。これは、 Liferay DXP 7.4 U4/Portal 7.4 GA8 以降、新しい言語キーを追加する推奨方法です。。

    • 言語モジュール を使用し、言語キーを language.properties ファイルに記述します。この方法では、方向性や名前の構造など、言語設定をより細かく制御できます。

  7. コントロール パネル → インスタンス設定 → ローカライズ に移動します。新しい言語を確認し、現在の言語リストに移動します。をクリックして保存します。

    新しい言語を現在の言語リストに保存します。

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

    ログイン画面はアムハラ語です。

言語オーバーライドツールを使用して言語キーを追加する

  1. 言語オーバーライド ページに移動します。

  2. 変更したい言語キーを検索してクリックしてください。

  3. 上書きしたい値を入力してください。

    選択した言語の下に翻訳された値を入力してください

言語モジュールを使用して言語キーを追加する

  1. 言語用の language.properties ファイルを作成し、ファイル名に ISO コードを使用してください。例えば、アムハラ語の場合は Language_am.properties となります。

    create-account=መለያ መፍጠር
    email-address=የ ኢሜል አድራሻ
    forgot-password=መክፈቻ ቁልፉን ረሳኽው
    home=መነሻ ገጽ
    password=ፕስወርድ
    powered-by-x=በ {0} የተጎላበተ
    remember-me=አስታወስከኝ
    search=የፍለጋ አሞሌ
    sign-in=ስግን እን
    
  2. 作成した language.properties ファイルを使用して言語モジュールを作成し、そのモジュールを Liferay インストール環境にデプロイします。サンプルプロジェクトとこのモジュールを作成するための具体的な手順については、 言語プロパティによるグローバル言語翻訳の上書き を参照してください。

方向性を変える

右から左に書く言語を追加する場合は、言語プロパティに次のプロパティを追加してください。

lang.dir=rtl

これはサイトのCSSに予期せぬ影響を与える可能性があります。 CSS ルールの変換 (反転) を防ぐには、適用したい CSS ルールの左側に /* @noflip */ という装飾を配置します。この例では、選択した言語の書き方に関係なく、 body に 20em の左余白を設定します。

/* @noflip */ body {
  margin-left: 20em;
}

また、CSSセレクタ .rtl を使用して、ルールをRTL言語のみに適用することもできます。言語設定のカスタマイズに関する詳細については、 言語プロパティによるグローバル言語翻訳の上書き を参照してください。

国旗アイコンを追加する

Liferayに標準搭載されている言語には、言語セレクター上に表示される国旗アイコンが付いています。

新しい言語に国旗アイコンを追加する方法は2つあります。

  1. ユーザーページには テーマ スプライト マップ クライアント拡張機能 を、管理者ページには 管理者テーマ を使用してください。

  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

  1. テーマ スプライト マップ クライアント拡張機能 を作成します。

  2. spritemap.svgの中に、旗の SVG を <symbol> タグの中に追加します。 id は、あなたの言語コードである必要があります。

  3. クライアント拡張機能をLiferayにデプロイします。

  4. 新しい空白ページを作成し、言語セレクターのフラグメントを追加します。あなたの言語には国旗アイコンがありません。

    作成された言語にはフラグがありません。

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

    言語セレクターには、クライアント拡張機能のアイコンが表示されます。

フラグを表示させたいすべてのページまたはページテンプレートで、このクライアント拡張機能を使用してください。 Theme Sprite Map Client Extensions の詳細については、 Theme Sprite Map Client Extension の使用 を参照してください。

クラシックテーマを使用してユーザーページに旗のアイコンを追加する

注記

Liferay Themes Toolkit は、Liferay 2024.Q4+ 以降 非推奨 となり、将来のリリースで削除される予定です。代わりに、 クライアント拡張機能 を使用してテーマを作成するか、 サイト初期化子 を使用してください。

  1. Liferay の テーマジェネレーター を使用してテーマを作成します。

  2. src/images/clay/icons.svg を変更し、旗の SVG を <symbol> タグ内に追加します。 id は、あなたの言語コードである必要があります。

  3. package.json を更新して、各依存関係の適切なバージョンを使用するようにします。

  4. src/WEB-INF/liferay-look-and-feel.xmlを、 liferay-portal リポジトリ の例に従って変更します。

  5. ルートモジュールディレクトリで gulp deploy を実行します。

  6. 旗のアイコンを表示させたいすべてのページまたはページテンプレートに、テーマを追加してください。テーマの詳細については、 テーマ を参照してください。

管理テーマを使用して管理ページに旗のアイコンを追加する

  1. Liferay の テーマジェネレーター を使用してテーマを作成します。

  2. src/images/clay/icons.svg を変更し、旗の SVG を <symbol> タグ内に追加します。 id は、あなたの言語コードである必要があります。

  3. package.json を更新して、各依存関係の適切なバージョンを使用するようにします。

  4. src/WEB-INF/liferay-look-and-feel.xml を変更して、これを管理テーマにします。 liferay-portal リポジトリ の例に従ってください。

  5. ルートモジュールディレクトリで gulp deploy を実行します。管理画面のテーマは自動的に適用されます。

  6. 新しい変更を適用するには、ページを更新してください。

テーマの詳細については、 テーマ を参照してください。