[僅限PaaS]{class="badge informative" title="僅適用於雲端專案(Adobe管理的PaaS基礎結構)和內部部署專案的Adobe Commerce 。"}

本地化

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到%3的預留位置。 翻譯可以有任意順序的這些預留位置，但必須至少有一個%1、%2和%3出現。 轉譯不能包含原始值中不存在的預留位置值（例如，%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>下的目錄，包含下列內容：

若要建立這些檔案：

語言套件語言.xml

在language.xml組態檔中宣告語言套件時，您必須指定此套件的語言繼承順序。

語言繼承可讓您根據名為​ parent ​的現有翻譯，建立名為​ 子項 ​的翻譯。 子翻譯會覆寫父翻譯。 但是，如果子翻譯無法上傳或顯示，或缺少短語或單字，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>

其中：

如有必要，您可以指定多個父封裝。 父套裝軟體會套用至先列出的、先使用的基礎。

語言繼承範例

假設語言套件繼承自其他兩個套件，且這些套件也有父和「祖父」套件。

如果語言套件繼承自兩個套件，其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測試來尋找並修正這類鏈結。

針對一種語言設定多個套件

為協助您讓商店更具彈性，您可以在商店中上傳相同語言的多個語言套件。 因此，您可以針對商店的不同部分使用不同的自訂套件，因為系統會從可用于某語言的所有套件中編譯單一套件。

若要為現有語言啟用其他套件，請將現有語言代碼名稱以外的任何名稱命名為新的套件（以避免混淆）。 依照下一節所述，在語言套件的language.xml中繼資訊檔案中指定套件的設定。

使用翻譯命令的範例

以下各節提供使用本主題中討論的命令來建立翻譯字典和翻譯套件的端對端範例：

範例：建立模組或主題的翻譯字典

若要將德文翻譯新增至要分發給其他商家的模組或主題：

範例：建立語言套件

與上述範例類似，產生CSV檔案，但您不必指定模組或主題目錄，而是指定整個Commerce應用程式根目錄。 產生的CSV包含命令在程式碼中找到的任何片語。