ローカライズ

Commerceの翻訳機能を利用すれば、次の機能を生み出すことで、複数の地域や市場向けにストアをカスタマイズし、ローカライズできます。

翻訳の概要を参照してください。

翻訳辞書の生成

翻訳辞書を生成して、既存の文字列のカスタマイズ、カスタムモジュールでの単語やフレーズの翻訳、テーマのローカライズ、言語パッケージの作成を行うことができます。

翻訳を開始するには、コマンドを使用して、既存のすべてのフレーズと単語のリストを含む辞書CSV ファイルを生成します。

辞書を生成して翻訳を開始するには：

コマンドオプション：

bin/magento i18n:collect-phrases [-o|--output="<csv file path and name>"] [-m|--magento] <path to directory to translate>

次の表では、パラメーターと値について説明します。

翻訳ガイドライン

単語やフレーズを翻訳する際には、次のガイドラインを使用します。

Commerceでは、プレースホルダーを使用してコンテキスト値を挿入します。これらは​ not ​翻訳に使用されます。 例：

Product '%1' has been added to shopping cart.

値を設定します。

Product 'Multimeter-2000' has been added to shopping cart.

結果のフレーズには、各プレースホルダーの少なくとも1つが含まれている必要があります。 例えば、元のフレーズに%1から%3までのプレースホルダーがあるとします。 翻訳は、これらのプレースホルダーを任意の順序で複数持つことができますが、%1、%2、%3の中に少なくとも1つのプレースホルダーが存在する必要があります。 翻訳に、元の値に存在しないプレースホルダー値を含めることはできません（例：%4、%5など）。

フレーズの翻訳の例：

"Buy %1 for %2 (%3 incl. tax) each","Compre %1 por %2 (%3 incl. imposto) cada"

言語パッケージの作成

翻訳ディクショナリとは異なり、Commerce アプリケーションでは、言語パッケージを使用して、すべての単語やフレーズを翻訳できます。 モジュールやテーマなど、特定のコンポーネントを翻訳辞書を使用して翻訳できます。 言語パッケージの詳細。

この節では、CSV ファイルをモジュールやテーマに書き込む言語パッケージの作成方法について説明します。 言語パッケージを作成するには、次の節で説明するタスクを実行する必要があります。

言語パッケージコマンドの実行

コマンドの使用状況：

bin/magento i18n:pack [-m|--mode={merge|replace}] [-d|--allow-duplicates] <source> <locale>

次の表に、言語パッケージコマンドのパラメーターと値を示します。

ディレクトリとファイルの作成

言語パッケージは、次の内容を含むCommerce ファイルシステムのapp/i18n/<VendorName>の下のディレクトリにあります。

これらのファイルを作成するには：

言語パッケージ language.xml

language.xml設定ファイルで言語パッケージを宣言する場合は、このパッケージの言語継承の順序を指定する必要があります。

言語の継承を使用すると、parent​という既存の翻訳に基づいて、child​という翻訳を作成できます。 子翻訳は親を上書きします。 ただし、子翻訳がアップロードまたは表示に失敗した場合、またはフレーズや単語が見つからない場合は、Commerceで親ロケールが使用されます。 言語パッケージ継承の例。

パッケージを宣言するには、次の情報を指定します。

<?xml version="1.0"?>
<language xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:App/Language/package.xsd">
    <code>en_GB</code>
    <vendor>magento</vendor>
    <package>en_gb</package>
    <sort_order>100</sort_order>
    <use vendor="oxford-university" package="en_us"/>
</language>

どこで：

必要に応じて、複数の親パッケージを指定できます。 親パッケージは、最初にリストされ、最初に使用されたベースで適用されます。

言語継承の例

言語パッケージが他の2つのパッケージから継承し、それらのパッケージにも親パッケージと「祖父母」パッケージがあるとします。

言語パッケージが2つのパッケージから継承する場合、そのlanguage.xmlは次のようになります。

<language xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:App/Language/package.xsd">
    <code>en_GB</code>
    <vendor>magento</vendor>
    <package>language_pack</package>
    <sort_order>100</sort_order>
    <use vendor="parent-package-one" package="language_package_one"/>
    <use vendor= "parent-package-two" package="language_package_two"/>
</language>

前の例では、

Commerce アプリケーションがen_GB パッケージ内の単語または語句を見つけられない場合、次の順序で他のパッケージを検索します。

言語パッケージ間のすべての継承を指定すると、循環する継承チェーンが作成される場合があります。 Magento\Test\Integrity\App\Language\CircularDependencyTest テストを使用して、そのようなチェーンを見つけ、修正します。

1つの言語用に複数のパッケージを設定する

ストアの柔軟性を高めるために、ストアに同じ言語の言語パッケージを複数アップロードできます。 したがって、システムは言語で使用可能なすべてのパッケージから1つのパッケージをコンパイルするため、ストアの異なる部分に対して異なるカスタムパッケージを使用できます。

既存の言語の追加パッケージを有効にするには、新しいパッケージに既存の言語コード名を除く任意の名前を付けます（混乱を避けるために）。 次の節で説明するように、言語パッケージのlanguage.xml メタ情報ファイルでパッケージの設定を指定します。

翻訳コマンドの使用例

次の節では、このトピックで説明するコマンドを使用して翻訳辞書と翻訳パッケージを作成するエンドツーエンドの例を示します。

例：モジュールまたはテーマの翻訳辞書の作成

他の販売者に配布するモジュールまたはテーマにドイツ語翻訳を追加するには：

例：言語パッケージの作成

前述の例と同様に、CSV ファイルを生成しますが、モジュールまたはテーマディレクトリを指定する代わりに、Commerce アプリケーションルートディレクトリ全体を指定します。 結果のCSVには、コマンドがコード内で検索できるフレーズが含まれています。