Lokalisatie

Met Commerce-vertalingen kunt u uw winkel voor meerdere regio's en markten aanpassen en lokaliseren door het volgende te genereren:

Zie Overzicht van Vertalingen.

Een vertaalwoordenboek genereren

U kunt a vertaalwoordenboekproduceren om bestaande koorden aan te passen, woorden en uitdrukkingen in een douanemodule vertalen, een thema lokaliseren, of taalpakketten tot stand brengen.

Als u wilt beginnen met het vertalen, gebruikt u een opdracht om een CSV-woordenboekbestand te genereren met een verzamelde lijst van alle bestaande woordgroepen en woorden.

U genereert het woordenboek als volgt en u begint met vertalen:

Opdrachtopties:

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

In de volgende tabel worden parameters en waarden beschreven:

Richtlijnen voor vertaling

Gebruik de volgende richtlijnen bij het vertalen van woorden en woordgroepen:

Commerce gebruikt placeholders om contextwaarden op te nemen; zij worden niet gebruikt voor vertalingen. Bijvoorbeeld:

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

Populaten met een waarde:

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

De resulterende uitdrukking moet minstens één van elke placeholder bevatten. Stel dat de oorspronkelijke uitdrukking plaatsaanduidingen bevat van %1 tot %3 . De vertaling kan een onbeperkt aantal van deze plaatsaanduidingen bevatten, maar er moet minstens één voorkomen voorkomen van %1 , %2 en %3 . De vertaling kan geen plaatsaanduidingswaarden bevatten die niet voorkomen in de oorspronkelijke waarde (bijvoorbeeld %4 , %5 , enzovoort).

Een voorbeeld van het vertalen van een woordgroep:

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

Een taalpakket maken

In tegenstelling tot een vertaalwoordenboek kunt u een of meer woorden en woordgroepen in de Commerce-toepassing vertalen met behulp van een taalpakket. U kunt een bepaalde component, zoals een module of een thema, vertalen met een vertaalwoordenboek. [ leer meer over taalpakketten ].

In deze sectie wordt besproken hoe u een taalpakket kunt maken, waarin CSV-bestanden naar modules en thema's worden geschreven. Als u een taalpakket wilt maken, moet u de in de volgende secties beschreven taken uitvoeren:

De opdracht Taalpakket uitvoeren

Opdrachtgebruik:

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

In de volgende tabel worden de parameters en waarden voor de opdracht Taalpakket uitgelegd:

Mappen en bestanden maken

Taalpakketten bevinden zich in een map onder app/i18n/<VendorName> in het Commerce-bestandssysteem met de volgende inhoud:

U kunt als volgt deze bestanden maken:

Taalpakket taal.xml

Wanneer u een taalpakket in het configuratiebestand van language.xml declareert, moet u de volgorde van de taalovererving voor dit pakket opgeven.

De overerving van de taal laat u toe om een vertaling tot stand te brengen genoemd a kind dat op een bestaande vertaling wordt gebaseerd geroepen a ouder. De onderliggende vertalingen overschrijven het bovenliggende element. Als de onderliggende vertaling echter niet kan worden geüpload of weergegeven of als er een woordgroep of woord ontbreekt, gebruikt Commerce de bovenliggende landinstelling. Voorbeelden van taalpakketovererving.

Geef de volgende informatie op om een pakket te declareren:

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

Waarbij:

Indien nodig kunt u verschillende bovenliggende pakketten opgeven. De bovenliggende pakketten worden toegepast op een eerst weergegeven, eerst gebruikte basis.

Voorbeeld van taalovererving

Veronderstel dat een taalpakket van twee andere pakketten erft, en dat die pakketten ook ouder en "grootouder"pakketten hebben.

Als een taalpakket overerft van twee pakketten, ziet language.xml er als volgt uit:

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

In het vorige voorbeeld:

Als de Commerce-toepassing geen woord of woordgroep kan vinden in het en_GB -pakket, zoekt het in de volgende volgorde in andere pakketten:

Als u alle overervingen tussen de taalpakketten opgeeft, kan dit leiden tot circulaire overervingsketens. Gebruik Magento\Test\Integrity\App\Language\CircularDependencyTesttest om van dergelijke ketens de plaats te bepalen en te bevestigen.

Meerdere pakketten voor een taal configureren

Om uw winkel flexibeler te maken, kunt u verschillende taalpakketten voor dezelfde taal in uw winkel uploaden. U kunt dus verschillende aangepaste pakketten gebruiken voor verschillende onderdelen van uw winkel, omdat het systeem één pakket compileert van alle pakketten die beschikbaar zijn voor een taal.

Om een extra pakket voor een bestaande taal toe te laten, noem het nieuwe pakket om het even welke naam behalve een bestaande taalcodenaam (om verwarring te vermijden). Geef configuraties van een pakket op in het meta-informatiebestand language.xml van het taalpakket, zoals in de volgende sectie wordt besproken.

Voorbeelden van het gebruik van vertaalopdrachten

De volgende secties verstrekken voorbeelden van begin tot eind van het gebruiken van de bevelen die in dit onderwerp worden besproken om vertaalwoordenboeken en vertaalpakketten tot stand te brengen:

Voorbeeld: een vertaalwoordenboek maken voor een module of thema

U voegt als volgt een Duitse vertaling toe aan een module of thema dat u wilt verspreiden onder andere verkopers:

Voorbeeld: Een taalpakket maken

Vergelijkbaar met het voorgaande voorbeeld genereert u een CSV-bestand. In plaats van een module- of themamap op te geven, geeft u echter de volledige hoofdmap van de Commerce-toepassing op. Het resulterende CSV-bestand bevat alle woordgroepen die de opdracht in de code kan vinden.