Documentation

Configuration de l’attribut lang dans les sites AEM Edge Delivery

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

Configurez l’attribut lang dans l’HTML statique lors de la création de sites multilingues avec l’éditeur universel d’AEM et Edge Delivery Services. Cette approche garantit que l’élément HTML inclut le paramètre de langue approprié pour l’optimisation pour les moteurs de recherche et l’accessibilité avant l’exécution de JavaScript côté client. Pour corriger ce problème, configurez l’html-lang dans les métadonnées de sorte que Edge Delivery Services effectue le rendu de l’attribut lang correct dans l’HTML statique.

Description description

Environnement

  • Adobe Experience Manager as a Cloud Service (AEMaaCS) - Sites
  • Edge Delivery Services
  • Éditeur universel

Problème/Symptômes

  • La sortie HTML statique n’inclut pas de lang attribute sur l’élément HTML.
  • Il devient difficile de répondre aux exigences d’optimisation du moteur de recherche et d’accessibilité pour les sites multipays ou multilingues.

Résolution resolution

Pour résoudre ce problème, procédez comme suit :

  1. Recherchez le fichier de définition de métadonnées dans votre référentiel Edge Delivery. Il peut s’agir d’une feuille de calcul telle que metadata.xlsx ou un fichier CSV, ou d’une feuille JSON exposée comme /metadata.json sur votre hôte .aem.page ou .aem.live.
  2. Ajoutez des mappages spécifiques aux paramètres régionaux au fichier de métadonnées et utilisez des modèles globaux dans la colonne URL pour correspondre aux chemins spécifiques aux paramètres régionaux, par exemple /it-it/<b> pour les pages italiennes.
  3. Pour chaque mappage, spécifiez le code langue-région approprié dans une propriété html-lang qui correspond à votre structure d’URL, telle que it-IT pour /it-it/.
  4. Validez et envoyez les modifications à la branche utilisée par votre site Edge Delivery Services.
  5. Republiez au moins un exemple de page dans chaque paramètre régional à partir d’AEM ou de l’éditeur universel afin que les métadonnées mises à jour soient prises en compte.
  6. Ouvrez l’URL Edge Delivery Services correspondante (.aem.page ou .aem.live) pour un exemple de page de paramètres régionaux.
  7. Utilisez Afficher le Source de la page pour confirmer que l’élément HTML comprend le lang attribute correct. . Si le résultat correct s’affiche sur Edge Delivery Services mais pas sur le domaine de production, effacez le cache du réseau CDN ou vérifiez que le mappage de domaine pointe vers la branche ou l’hôte mis à jour.

### Remarques

  • - Pour la plupart des sites multipays ou multilingues, il est recommandé de gérer les html-lang au moyen de métadonnées en bloc pour plus de simplicité et de robustesse. Vous pouvez obtenir un contrôle plus granulaire par page en ajoutant un champ HTML-lang aux métadonnées de page individuelles dans l’éditeur universel. Toutefois, cette valeur doit toujours être affichée telle quelle dans les métadonnées html-lang pour que Edge Delivery Services en effectue correctement le rendu.
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f