Lokalisierung

Commerce-Übersetzungen ermöglichen es Ihnen, Ihren Store für mehrere Regionen und Märkte anzupassen und zu lokalisieren, indem Sie Folgendes generieren:

Siehe Übersetzungen - Übersicht.

Übersetzungswörterbuch erstellen

Sie können ein Übersetzungswörterbuch generieren, um vorhandene Zeichenfolgen anzupassen, Wörter und Ausdrücke in einem benutzerdefinierten Modul zu übersetzen, ein Design zu lokalisieren oder Sprachpakete zu erstellen.

Um mit der Übersetzung zu beginnen, verwenden Sie einen Befehl, um eine Wörterbuch-CSV-Datei mit einer Liste aller vorhandenen Ausdrücke und Wörter zu generieren.

So generieren Sie das Wörterbuch und beginnen die Übersetzung:

Befehlsoptionen:

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

In der folgenden Tabelle werden Parameter und Werte erläutert:

Übersetzungsrichtlinien

Beachten Sie beim Übersetzen von Wörtern und Ausdrücken die folgenden Richtlinien:

Commerce verwendet die Platzhalter zum Einfügen von Kontextwerten. Sie werden für Übersetzungen nicht verwendet. Beispiel:

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

Füllt mit einem Wert:

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

Der resultierende Satz muss mindestens einen von jedem Platzhalter enthalten. Angenommen, der ursprüngliche Satz enthält Platzhalter von %1 bis %3. Die Übersetzung kann so viele dieser Platzhalter in beliebiger Reihenfolge enthalten, aber es muss mindestens ein Vorkommen von %1, %2 und %3 vorhanden sein. Die Übersetzung darf keine Platzhalterwerte enthalten, die nicht im ursprünglichen Wert vorhanden sind (z. B. %4, %5 usw.).

Beispiel für die Übersetzung einer Wortgruppe:

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

Sprachpaket erstellen

Im Gegensatz zu einem Übersetzungswörterbuch können Sie beliebige oder alle Wörter und Ausdrücke in der Commerce-Anwendung mithilfe eines Sprachpakets übersetzen. Sie können eine bestimmte Komponente - wie ein Modul oder ein Design - mithilfe eines Übersetzungswörterbuchs übersetzen. [Erfahren Sie mehr über Sprachpakete].

In diesem Abschnitt wird beschrieben, wie Sie ein Sprachpaket erstellen, das CSV-Dateien in Module und Designs schreibt. Um ein Sprachpaket zu erstellen, müssen Sie die in den folgenden Abschnitten beschriebenen Aufgaben ausführen:

Ausführen des Sprachpakets, Befehl

Befehlsverwendung:

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

In der folgenden Tabelle werden die Parameter und Werte für den Sprachpaket-Befehl erläutert:

Erstellen von Ordnern und Dateien

Sprachpakete befinden sich in einem Verzeichnis unter app/i18n/<VendorName> im Commerce-Dateisystem mit folgendem Inhalt:

So erstellen Sie diese Dateien:

Sprachpaket language.xml

Wenn Sie ein Sprachpaket in der Konfigurationsdatei language.xml deklarieren, müssen Sie die Sequenz der Sprachvererbung für dieses Paket angeben.

Durch die Sprachvererbung können Sie eine Übersetzung mit dem Namen child erstellen, die auf einer vorhandenen Übersetzung namens parent basiert. Die untergeordneten Übersetzungen überschreiben die übergeordnete. Wenn die untergeordnete Übersetzung jedoch nicht hochgeladen oder angezeigt werden kann oder eine Wortgruppe oder ein Wort fehlt, verwendet Commerce das übergeordnete Gebietsschema. Beispiele für die Vererbung von Sprachpaketen.

Geben Sie die folgenden Informationen an, um ein Package zu deklarieren:

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

Dabei gilt:

Bei Bedarf können Sie mehrere übergeordnete Pakete angeben. Die übergeordneten Pakete werden auf der ersten aufgelisteten, zuerst verwendeten Basis angewendet.

Beispiel einer Sprachvererbung

Angenommen, ein Sprachpaket erbt von zwei anderen Paketen, und diese Pakete haben auch übergeordnete und "übergeordnete"Pakete.

Wenn ein Sprachpaket von zwei Paketen erbt, könnte sein language.xml wie folgt aussehen:

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

Im obigen Beispiel:

Wenn die Commerce-Anwendung im Paket en_GB kein Wort oder keine Wortgruppe finden kann, werden andere Pakete in der folgenden Reihenfolge angezeigt:

Das Angeben aller Vererbungen zwischen den Sprachpaketen kann zur Erstellung zirkulärer Vererbungsketten führen. Verwenden Sie den Test Magento\Test\Integrity\App\Language\CircularDependencyTest , um solche Ketten zu finden und zu reparieren.

Mehrere Pakete für eine Sprache konfigurieren

Um Ihren Speicher flexibler zu gestalten, können Sie mehrere Sprachpakete für dieselbe Sprache in Ihren Speicher hochladen. So können Sie verschiedene benutzerdefinierte Pakete für verschiedene Teile Ihres Geschäfts verwenden, da das System ein einzelnes Paket aus allen Paketen zusammenstellt, die für eine Sprache verfügbar sind.

Um ein zusätzliches Paket für eine vorhandene Sprache zu aktivieren, geben Sie dem neuen Paket einen beliebigen Namen außer einem vorhandenen Sprachcode-Namen (um Verwirrung zu vermeiden). Geben Sie Konfigurationen eines Pakets in der Meta-Information-Datei language.xml des Sprachpakets an, wie im nächsten Abschnitt beschrieben.

Beispiele für die Verwendung von Übersetzungsbefehlen

Die folgenden Abschnitte enthalten durchgängige Beispiele für die Verwendung der in diesem Thema beschriebenen Befehle zum Erstellen von Übersetzungswörterbüchern und Übersetzungspaketen:

Beispiel: Erstellen eines Übersetzungswörterbuchs für ein Modul oder Design

So fügen Sie eine deutsche Übersetzung zu einem Modul oder Thema hinzu, das Sie an andere Händler verteilen möchten:

Beispiel: Sprachpaket erstellen

Generieren Sie wie im vorherigen Beispiel eine CSV-Datei, geben Sie jedoch nicht das Modul- oder Designverzeichnis an, sondern geben Sie den gesamten Stammordner für die Commerce-Anwendung an. Die resultierende CSV-Datei enthält alle Ausdrücke, die der Befehl im Code finden könnte.