場所

Commerce翻訳を使用すると、次の情報を生成することで、複数の地域や市場に合わせてストアをカスタマイズおよびローカライズできます。

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

翻訳辞書の生成

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

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

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

コマンドオプション：

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

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

翻訳ガイドライン

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

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

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 つのパッケージから継承し、それらのパッケージに親パッケージと「grandparent」パッケージも含まれているとします。

言語パッケージが 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 には、コマンドがコード内で見つけることができたすべてのフレーズが含まれています。