本地化

通过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>

下表说明了language package命令的参数和值：

创建目录和文件

语言包位于Commerce文件系统中app/i18n/<VendorName>下的目录，其中包含以下内容：

要创建这些文件，请执行以下操作：

语言包语言.xml

在language.xml配置文件中声明语言包时，必须指定此包的语言继承顺序。

语言继承允许您基于名为​ 父项 ​的现有翻译创建名为​ 子项 ​的翻译。 子翻译将覆盖父翻译。 但是，如果子翻译无法上传或显示或者缺少短语或单词，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包含命令可在代码中找到的所有短语。