AEM Edge Delivery 사이트에서 lang 속성 구성

AEM Universal Editor 및 Edge Delivery Services을 사용하여 다국어 사이트를 빌드할 때 정적 HTML에서 lang 특성을 구성합니다. 이 접근 방식을 사용하면 클라이언트측 JavaScript이 실행되기 전에 HTML 요소에 SEO에 대한 올바른 언어 설정과 액세스 가능성이 포함됩니다. 이 문제를 해결하려면 Edge Delivery Services에서 정적 HTML에서 올바른 lang 특성을 렌더링하도록 메타데이터에 html-lang을(를) 구성합니다.

설명 description

환경

  • Adobe Experience Manager as a Cloud Service(AEMaaCS) - 사이트
  • Edge Delivery Services
  • 유니버설 편집기

문제/증상

  • 정적 HTML 출력에는 HTML 요소에 lang attribute이(가) 포함되어 있지 않습니다.
  • 다국어 또는 다국어 사이트에 대한 SEO 및 접근성 요구 사항을 충족하기가 어려워집니다.

해결 방법 resolution

이 문제를 해결하려면 다음 단계를 수행합니다.

  1. Edge Delivery 저장소에서 메타데이터 정의 파일을 찾습니다. metadata.xlsx 또는 CSV 파일과 같은 스프레드시트이거나 .aem.page 또는 .aem.live 호스트에서 /metadata.json(으)로 노출된 JSON 시트일 수 있습니다.
  2. 메타데이터 파일에 로케일별 매핑을 추가하고 URL 열의 전역 패턴을 사용하여 로케일별 경로를 일치시킵니다(예: 이탈리아어 페이지의 경우 /it-it/<b>).
  3. 각 매핑에 대해 URL 구조와 일치하는 html-lang 속성에 적절한 언어 지역 코드를 지정하십시오(예: /it-it/에 대한 it-IT).
  4. 변경 사항을 커밋하고 Edge Delivery Services 사이트에서 사용하는 분기에 푸시합니다.
  5. 업데이트된 메타데이터가 고려되도록 AEM 또는 유니버설 편집기의 각 로케일에서 하나 이상의 샘플 페이지를 다시 게시합니다.
  6. 샘플 로케일 페이지의 해당 Edge Delivery Services URL(.aem.page 또는 .aem.live)을 엽니다.
  7. 페이지 Source 보기를 사용하여 HTML 요소에 올바른 lang attribute이(가) 포함되어 있는지 확인하십시오. . Edge Delivery Services에 올바른 결과가 표시되지만 프로덕션 도메인에는 표시되지 않는 경우 CDN 캐시를 지우거나 도메인 매핑이 업데이트된 분기 또는 호스트에 대해 가리키는지 확인하십시오.

### 참고

  • - 대부분의 다국어 또는 다국어 사이트의 경우 단순성과 견고성을 위해 일괄 메타데이터를 통해 html-lang을(를) 관리하는 것이 좋습니다. 범용 편집기 내의 개별 페이지 메타데이터에 HTML-lang 필드를 추가하여 페이지당 더 세부적인 제어를 수행할 수 있습니다. 그러나 이 값을 올바르게 렌더링하려면 Edge Delivery Services의 메타데이터에 html-lang(으)로 표시되어야 합니다.
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f