[Endast PaaS]{class="badge informative" title="Gäller endast Adobe Commerce i molnprojekt (Adobe-hanterad PaaS-infrastruktur) och lokala projekt."}

Lokalisering

Med Commerce-översättningar kan ni anpassa och lokalisera er butik för flera regioner och marknader genom att generera:

Se Översättningar - översikt.

Generera en översättningsordlista

Du kan generera en översättningsordlista om du vill anpassa befintliga strängar, översätta ord och fraser i en anpassad modul, lokalisera ett tema eller skapa språkpaket.

Om du vill börja översätta använder du ett kommando för att generera en CSV-ordlistefil med en insamlad lista över alla befintliga fraser och ord.

Så här genererar du ordlistan och börjar översättningen:

Kommandoalternativ:

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

I följande tabell förklaras parametrar och värden:

Riktlinjer för översättning

Använd följande riktlinjer när du översätter ord och fraser:

Commerce använder platshållarna för att infoga kontextvärden. De används inte för översättningar. Exempel:

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

Fyller med ett värde:

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

Den resulterande frasen måste innehålla minst en platshållare. Anta till exempel att det finns platshållare från %1 till %3 i den ursprungliga frasen. Översättningen kan ha så många av dessa platshållare i vilken ordning som helst, men det måste finnas minst en förekomst av %1, %2 och %3. Översättningen får inte innehålla platshållarvärden som inte finns i det ursprungliga värdet (till exempel %4, %5 och så vidare).

Ett exempel på översättning av en fras:

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

Skapa ett språkpaket

I motsats till en översättningsordlista kan du översätta några eller alla ord och fraser i Commerce-programmet med hjälp av ett språkpaket. Du kan översätta en viss komponent - som en modul eller ett tema - med hjälp av ett översättningslexikon. Läs mer om språkpaket.

I det här avsnittet beskrivs hur du skapar ett språkpaket som skriver CSV-filer till moduler och teman. Om du vill skapa ett språkpaket måste du utföra de uppgifter som beskrivs i följande avsnitt:

Kör språkpaketkommandot

Kommandoanvändning:

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

I följande tabell förklaras parametrarna och värdena för språkpaketkommandot:

Skapa kataloger och filer

Språkpaket finns i en katalog under app/i18n/<VendorName> i Commerce-filsystemet med följande innehåll:

Så här skapar du dessa filer:

Språk.xml

När du deklarerar ett språkpaket i konfigurationsfilen language.xml måste du ange språkarvssekvensen för det här paketet.

Med språkarv kan du skapa en översättning som kallas underordnad baserat på en befintlig översättning som kallas överordnad. De underordnade översättningarna åsidosätter den överordnade. Om den underordnade översättningen inte kan överföras eller visas, eller om en fras eller ett ord saknas, använder Commerce den överordnade språkinställningen. Exempel på arv av språkpaket.

Om du vill deklarera ett paket anger du följande information:

<?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>

Var:

Om det behövs kan du ange flera överordnade paket. De överordnade paketen tillämpas på den första listade, först använda basen.

Exempel på språkarv

Anta att ett språkpaket ärver från två andra paket och att dessa paket också har överordnade och "indirekt överordnade" paket.

Om ett språkpaket ärver från två paket kan dess language.xml se ut så här:

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

I föregående exempel:

Om Commerce-programmet inte kan hitta ord eller fras i paketet en_GB söker det i andra paket i följande sekvens:

Om du anger alla arv mellan språkpaketen kan det leda till att cirkulära arvskedjor skapas. Använd Magento\Test\Integrity\App\Language\CircularDependencyTest för att hitta och åtgärda sådana kedjor.

Konfigurera flera paket för ett språk

Du kan göra din butik mer flexibel genom att ladda upp flera språkpaket för samma språk i butiken. Du kan alltså använda olika anpassade paket för olika delar av din butik eftersom systemet kompilerar ett paket från alla paket som är tillgängliga för ett språk.

Om du vill aktivera ytterligare ett paket för ett befintligt språk namnger du det nya paketet vilket namn som helst, förutom ett befintligt språkkodsnamn (för att undvika missförstånd). Ange konfigurationer för ett paket i språkpaketets language.xml-metainformationsfil, vilket beskrivs i nästa avsnitt.

Exempel på hur du använder översättningskommandon

I följande avsnitt ges kompletta exempel på hur du använder de kommandon som beskrivs i det här avsnittet för att skapa översättningsordlistor och översättningspaket:

Exempel: Skapa en översättningsordlista för en modul eller ett tema

Så här lägger du till en tysk översättning till en modul eller ett tema som du vill distribuera till andra handlare:

Exempel: Skapa ett språkpaket

Generera en CSV-fil på ungefär samma sätt som i föregående exempel, men i stället för att ange en modul eller temakatalog anger du hela Commerce programrotkatalog. Den resulterande CSV-filen innehåller fraser som kommandot kan hitta i koden.