Verwalten von Wörterbüchern mithilfe des Übersetzers using-translator-to-manage-dictionaries

AEM stellt eine Konsole für die Verwaltung der verschiedenen Übersetzungen von Texten bereit, die auf der Komponentenbenutzeroberfläche verwendet werden. Diese Konsole ist verfügbar unter:

https://<hostname>:<port-number>/libs/cq/i18n/gui/translator.html

Mithilfe des Übersetzer-Tools können Sie englischsprachige Zeichenfolgen und die dazugehörigen Übersetzungen verwalten. Die Wörterbücher werden im Repository erstellt, z. B. /apps/myproject/i18n.

Das Übersetzer-Tool und die Wörterbücher, die Sie verwalten, dienen zur Darstellung der Komponentenbenutzeroberfläche in verschiedenen Sprachen. Wenn Sie Seiten übersetzen möchten, finden Sie unter Übersetzen von Inhalten für mehrsprachige Sites weitere Informationen dazu.

Erstellen eines Wörterbuchs creating-a-dictionary

Entwickelnde können i18n-Wörterbücher in AEM erstellen, um lokalisierte Komponentenzeichenfolgen zu verwalten. Wörterbücher sind normalerweise Teil des Komponenten-Codes in /apps. Im Folgenden finden Sie ein Beispiel aus dem AEM-WKND-Code mit einem Schlüssel-Wert-Paar, das in allen WKND-Komponenten verwendet wird.

{
  "© {0} WKND Site Site. All rights reserved." : "© {0} WKND Site Site. Tous droits réservés."
}

Entwickelnde können zusätzliche Wörterbücher erstellen, indem sie einen Stammknoten (sling:Folder) für ein neues Wörterbuch hinzufügen, in dem Sprachdefinitionen für Komponentenzeichenfolgen gespeichert werden.

/apps/myProject/i18n [sling:Folder]
    - de.json [nt:file] [mix:language]
        + jcr:language = de
    - fr.json [nt:file] [mix:language]
        + jcr:language = fr

Nach der Erstellung in einem AEM-GitHub-Repository können Wörterbücher über eine AEM-CI/CD-Pipeline bereitgestellt werden.

Wörterbuchspeicherorte dictionary-locations

Entwickelnde können ein Wörterbuch für die Ausgangssprache unter /apps oder /content/cq:i18n erstellen. Wenn Sie mit dem Beispiel-Code des AEM-Archetyps beginnen, befinden sich die ersten Wörterbücher normalerweise unter dem Pfad /apps. Wenn entsprechende Wörterbuchsprachkopien auch unter /apps gespeichert werden sollen, müssen diese Sprachkopien von Entwickelnden manuell im Komponenten-Code erstellt und gepflegt werden.

Alternativ wird im Rahmen des neuen AEM-Runtime-Übersetzungsprozesses für i18n-Wörterbücher übersetzte Wörterbücher unter /content/cq:i18n/<projectName> erstellt. Dies gilt unabhängig davon, ob das Quellwörterbuch unter /apps oder /content gespeichert ist.

Entscheidungen, wo i18n-Wörterbücher, Quell- und Sprachkopien zu finden sind, sollten anhand der folgenden Kriterien getroffen werden:

Da /apps in der Sling-Render-Reihenfolge immer Vorrang vor /content hat, sollten Sie beachten, dass Wörterbücher mit identischen Schlüssel-Wert-Paaren nicht gleichzeitig unter /apps und /content/cq:i18n vorhanden sein dürfen, da das Wörterbuch unter /content/cq:i18n nie zum Rendern verwendet wird. Wenn eine Wörterbuchsprachkopie, d. h. ein Übersetzungsziel, bereits unter /apps vorhanden ist und diese zur Laufzeit in AEM as a Cloud Service übersetzbar gemacht werden soll, muss die ursprüngliche Wörterbuchsprachkopie unter /apps entweder nach /content/cq:i18n verschoben oder unter /apps gelöscht und unter /content/cq:i18n durch Übersetzen des Quellwörterbuchs automatisch neu erstellt werden. Bei diesem Übersetzungsprozess werden die Sprachkopien automatisch unter /content/cq:i18n erstellt.

Automatisches Erstellen von Wörterbüchern automatic-creation

AEM-Seiten und Experience Fragments, die AEM-Kernkomponenten enthalten, werden im Rahmen des neuen Wörterbuchübersetzungsprozesses auch auf Komponenten und Komponentenzeichenfolgen überprüft, die übersetzt werden sollen. Das System erstellt dann automatisch entsprechende neue Wörterbuchsprachkopien unter /content/cq:i18n. Dies gilt nicht für Inhaltsfragmente, da es sich dabei um reine, strukturierte Inhalte ohne die Verwendung von AEM-Kernkomponenten handelt.

Exportieren eines Wörterbuchs exporting-a-dictionary

Eine Runtime-Übersetzung von i18n-Wörterbüchern an /apps- oder /libs-Speicherorten in AEM as a Cloud Service ist zwar nicht möglich, da diese Speicherorte unveränderlich sind, diese Wörterbücher können aber zur Laufzeit für eine asynchrone Übersetzung außerhalb von AEM exportiert werden.

So exportieren Sie die Zeichenfolgen der Ausgangssprache eines Wörterbuchs in eine XLIFF-Datei:

Importieren eines Wörterbuchs importing-a-dictionary

So importieren Sie eine XLIFF-Datei in ein Wörterbuch, um das Wörterbuch zu füllen: