Dokumentation

Konfigurieren des Lang-Attributs in AEM Edge Delivery Sites

Last update: Tue May 26 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Konfigurieren Sie beim Erstellen mehrsprachiger Sites mit dem universellen Editor von AEM und Edge Delivery Services das lang Attribut in statischem HTML. Dieser Ansatz stellt sicher, dass das HTML-Element die richtige Spracheinstellung für SEO und Barrierefreiheit enthält, bevor Client-seitige JavaScript ausgeführt wird. Um dies zu beheben, konfigurieren Sie html-lang in Metadaten, damit Edge Delivery Services das richtige lang in der statischen HTML rendert.

Beschreibung description

Umgebung

  • Adobe Experience Manager as a Cloud Service (AEMaaCS) - Sites
  • Edge-Bereitstellungsdienste
  • Universeller Editor

Problem/Symptome

  • Die statische HTML-Ausgabe enthält keine lang attribute für das HTML-Element.
  • Es wird schwierig, die SEO- und Barrierefreiheitsanforderungen für länderübergreifende oder mehrsprachige Websites zu erfüllen.

Lösung resolution

Gehen Sie wie folgt vor, um dieses Problem zu beheben:

  1. Suchen Sie die Metadatendefinitionsdatei in Ihrem Edge Delivery-Repository. Dabei kann es sich um eine Tabelle wie metadata.xlsx oder eine CSV-Datei handeln oder um eine JSON-Tabelle, die als /metadata.json auf Ihrem .aem.page- oder .aem.live-Host bereitgestellt wird.
  2. Fügen Sie der Metadatendatei gebietsschemaspezifische Zuordnungen hinzu und verwenden Sie globale Muster in der URL-Spalte, um gebietsschemaspezifische Pfade abzugleichen, z. B. /it-it/<b> für italienische Seiten.
  3. Geben Sie für jede Zuordnung den entsprechenden Sprach-Regions-Code in einer html-lang an, die Ihrer URL-Struktur entspricht, z. B. it-IT für /it-it/.
  4. Übertragen Sie die Änderungen in die von Ihrer Edge Delivery Services-Site verwendete Verzweigung und übertragen Sie sie.
  5. Veröffentlichen Sie in jedem Gebietsschema mindestens eine Beispielseite erneut aus AEM oder dem universellen Editor, damit die aktualisierten Metadaten berücksichtigt werden.
  6. Öffnen Sie die entsprechende Edge Delivery Services-URL (.aem.page oder .aem.live) für eine Beispiel-Gebietsschema-Seite.
  7. Verwenden Sie Seitenansicht Source, um zu bestätigen, dass das HTML-Element die richtige lang attribute enthält. . Wenn das richtige Ergebnis in Edge Delivery Services, aber nicht in der Produktions-Domain angezeigt wird, löschen Sie den CDN-Cache oder überprüfen Sie die Domain-Zuordnungspunkte auf die aktualisierte Verzweigung oder den aktualisierten Host.

### Anmerkungen

  • - Für die meisten Websites mit mehreren Ländern oder Sprachen wird aus Gründen der Einfachheit und Robustheit die Verwaltung von html-lang über Metadaten in Batches empfohlen. Durch Hinzufügen eines Felds HTML-lang zu einzelnen Seitenmetadaten im universellen Editor können Sie eine granularere Seitenkontrolle erzielen. Dieser Wert muss jedoch weiterhin als html-lang in den Metadaten angezeigt werden, damit Edge Delivery Services ihn korrekt rendern kann.
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f