Internationalisieren von Komponenten

Internationalisieren Sie Komponenten und Dialogfelder, damit die zugehörigen Zeichenfolgen der Benutzeroberfläche in unterschiedlichen Sprachen angezeigt werden können. Bei für die Internationalisierung entwickelten Komponenten können die Zeichenfolgen der Benutzeroberfläche externalisiert, übersetzt und dann in das Repository importiert werden. Die Spracheinstellungen des Benutzers oder das Seitengebietsschema bestimmen, welche Sprache während der Laufzeit in der Benutzeroberfläche angezeigt wird.

chlimage_1-9

Gehen Sie wie folgt vor, um die Komponenten zu internationalisieren und die Benutzeroberfläche in unterschiedlichen Sprachen bereitzustellen:

  1. Implementieren Sie die Komponenten mit Code, bei dem Zeichenfolgen internationalisiert werden. Der Code identifiziert die zu übersetzenden Zeichenfolgen und wählt die Sprache aus, die während der Laufzeit angezeigt wird.

  2. Erstellen Sie Wörterbücher und fügen Sie die zu übersetzenden englischen Zeichenfolgen hinzu.

  3. Exportieren Sie das Wörterbuch im XLIFF-Format, übersetzen Sie die Zeichenfolgen und importieren Sie die XLIFF-Dateien wieder in AEM. Sie können dem Wörterbuch auch manuell Übersetzungen hinzufügen.

  4. Binden Sie das Wörterbuch in das Freigabemanagement der Anwendung ein.

HINWEIS

Die hier für das Internationalisieren von Komponenten beschriebenen Methoden gelten für das Übersetzen statischer Zeichenfolgen. Falls eine Änderung der Komponentenzeichenfolgen zu erwarten ist, müssen Sie herkömmliche Arbeitsabläufe für die Übersetzung nutzen. Falls Autoren beispielsweise eine Zeichenfolge der Benutzeroberfläche über die Eigenschaften im Dialogfeld „Bearbeiten“ einer Komponente bearbeiten können, sollten Sie zum Internationalisieren der Zeichenfolge kein Sprachwörterbuch verwenden.

Sprachwörterbücher

Beim AEM-Internationalisierungs-Framework werden englische Zeichenfolgen und deren Übersetzungen in andere Sprachen in Wörterbüchern im Repository gespeichert. Englisch ist die Standardsprache für das Framework. Zeichenfolgen werden anhand der englischen Version identifiziert. In der Regel kommen bei Internationalisierungs-Frameworks alphanumerische IDs für die Zeichenfolgen von Benutzeroberflächen zum Einsatz. Das Verwenden der englischen Version einer Zeichenfolge als ID hat mehrere Vorteile:

  • Code ist leicht zu lesen.
  • Die Standardsprache ist immer verfügbar.

Lokalisierte Zeichenfolgen können in verschiedenen Wörterbüchern im Repository gespeichert werden. AEM Systemwörterbücher befinden sich unter dem Knoten /libs. Sie können Wörterbücher für Ihre Komponenten unter dem Knoten /apps erstellen. Beim AEM-Internationalisierungs-Framework werden Wörterbücher kombiniert und in Sling als einzelnes ResourceBundle-Objekt bereitgestellt. Beim Rendern rufen Komponenten die übersetzten Zeichenfolgen aus dem ResourceBundle-Objekt ab. Die kombinierten Wörterbücher werden auch auf dem Webserver im JSON-Format bereitgestellt, um übersetzte Zeichenfolgen für den JavaScript-Code in Webseiten bereitzustellen.

Mit dem Übersetzungstool können Sie außerdem alle Wörterbücher an einer zentralen Stelle verwalten.

chlimage_1-10

HINWEIS

Ändern Sie nicht die AEM Systemwörterbücher, die sich unterhalb des Knotens /libs befinden.

Überschreiben von Zeichenfolgen in Systemwörterbüchern

Strings in Wörterbüchern unter dem Knoten /apps setzen Duplikat-Zeichenfolgen in Wörterbüchern außer Kraft, die sich unterhalb des Knotens /libs befinden. Falls die Komponenten Zeichenfolgen aus den AEM-Systemwörterbüchern verwenden, kopieren Sie die Zeichenfolgen in Ihr eigenes Wörterbuch. Alle Komponenten verwenden dann die Zeichenfolgen aus Ihrem Wörterbuch.

Beachten Sie, dass Sie nicht vorhersagen können, welche Übersetzung verwendet wird, wenn Zeichenfolgen in Wörterbüchern dupliziert werden, die sich alle unterhalb des Knotens /apps befinden.

Auf dieser Seite

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free