다국어 지원 Nuxt sitemap 만드는 방법
Nuxt 3에서 다국어 블로그를 만들고 있다면, 각 언어별 페이지를 검색엔진이 인식하도록 sitemap을 다국어 대응 형태로 구성하는 것이 중요합니다.
이 글에서는 Nuxt + Nuxt Content 환경에서 다국어 sitemap을 만드는 방법과, 정상적인 XML 형식인지 검증하는 방법까지 소개합니다.
Nuxt sitemap 기본 설정
Nuxt 프로젝트에서 sitemap을 만들기 위한 가장 쉬운 방법은 sitemap 패키지를 사용하는 것입니다.
npm install sitemap
hreflang을 통한 다국어 대응
sitemap.write()에서 links: [...] 옵션을 설정하면
Google은 hreflang을 통해 각 언어별 페이지를 인식하게 됩니다.
<xhtml:link rel="alternate" hreflang="ko" href="..."/>
<xhtml:link rel="alternate" hreflang="en" href="..."/>
XML 출력이 깨질 때 확인할 것
XML 선언은 반드시 문서 최상단에 있어야 하며, 앞에 빈 줄이 없어야 합니다.
✅ 올바른 시작:
<?xml version="1.0" encoding="UTF-8"?>
<urlset ...>
❌ 잘못된 예:
<?xml version="1.0" encoding="UTF-8"?>
빈 줄이 있으면
processing instruction target에러가 발생합니다.
XML 문서 검증하는 방법
정상적인 sitemap인지 확인하려면:
- https://www.xmlvalidation.com/ 에서 붙여넣기
- "Document is valid" 메시지 확인
- 또는 Google Search Console → sitemap 제출
마무리 퀴즈
- sitemap에
links속성을 사용하는 목적은 무엇인가요?
a) 페이지 제목을 추가하기 위해
b) 다국어 URL을 명시하기 위해
c) SEO 설명을 넣기 위해 - XML 선언은 문서 어디에 위치해야 하나요?
a) 중간에 있어도 됨
b) 마지막 줄에
c) 첫 줄 가장 앞 - sitemap을 올바르게 작성했는지 검증할 수 있는 방법은?
a) lint 실행
b) XML validator 사용
c) Nuxt devtools에서 확인
정답:
- b
- c
- b