Documentazione

Configurare l’attributo lang nei siti AEM Edge Delivery

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

Configurare l'attributo lang in HTML statico durante la creazione di siti multilingue con AEM Universal Editor e Edge Delivery Services. Questo approccio garantisce che l’elemento HTML includa l’impostazione della lingua corretta per SEO (Search Engine Optimization) e l’accessibilità prima che venga eseguito il JavaScript lato client. Per risolvere il problema, configurare html-lang nei metadati in modo che Edge Delivery Services esegua il rendering dell'attributo lang corretto nel HTML statico.

Descrizione description

Ambiente

  • Adobe Experience Manager as a Cloud Service (AEMaaCS) - Sites
  • Edge Delivery Services
  • Editor universale

Problema/Sintomi

  • L'output statico di HTML non include lang attribute nell'elemento HTML.
  • Diventa difficile soddisfare i requisiti SEO (Search Engine Optimization) e di accessibilità per i siti multinazionali o multilingue.

Risoluzione resolution

Per risolvere il problema, eseguire la procedura seguente:

  1. Individua il file di definizione dei metadati nel tuo archivio Edge Delivery. Può essere un foglio di calcolo come metadata.xlsx o un file CSV, oppure un foglio JSON esposto come /metadata.json sul tuo host .aem.page o .aem.live.
  2. Aggiungere mappature specifiche delle impostazioni locali al file di metadati e utilizzare i modelli globali nella colonna URL per far corrispondere i percorsi specifici delle impostazioni locali, ad esempio /it-it/<b> per le pagine italiane.
  3. Per ogni mapping, specificare il codice lingua appropriato in una proprietà html-lang che corrisponda alla struttura dell'URL, ad esempio it-IT per /it-it/.
  4. Apporta le modifiche e le invia al ramo utilizzato dal sito Edge Delivery Services.
  5. Ripubblica almeno una pagina di esempio in ciascuna lingua da AEM o Universal Editor in modo da considerare i metadati aggiornati.
  6. Aprire l'URL di Edge Delivery Services corrispondente (.aem.page o .aem.live) per una pagina delle impostazioni locali di esempio.
  7. Utilizzare Visualizza pagina Source per verificare che l'elemento HTML includa l'elemento lang attribute corretto. . Se il risultato corretto viene visualizzato in Edge Delivery Services ma non nel dominio di produzione, cancella la cache CDN o verifica i punti di mappatura del dominio per il ramo o l’host aggiornato.

### Note

  • - Per la maggior parte dei siti con più paesi o più lingue, si consiglia di gestire html-lang tramite metadati in blocco per semplificarne la gestione e migliorarne la robustezza. È possibile ottenere un controllo più granulare per pagina aggiungendo un campo HTML-lang ai metadati di singole pagine in Universal Editor. Tuttavia, questo valore deve ancora essere visualizzato come html-lang nei metadati affinché Edge Delivery Services possa eseguirne il rendering correttamente.
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f