자주 묻는 질문

언어 관련

새로운 언어를 추가하려면 어떻게 하나요?

개발자 가이드의 "새 언어 추가하기" 섹션을 참고해 주세요. 기본적으로 locale 파일 생성, 라우팅 설정, 번역 추가의 3단계가 필요합니다.

번역이 표시되지 않고 키가 그대로 나와요

번역 키에 해당하는 번역이 locale 파일에 없을 때 발생합니다. 해당 locale 파일에 번역을 추가해 주세요.

SEO 관련

hreflang 태그가 자동으로 추가되나요?

네, 레이아웃에 hreflang_tags 헬퍼를 추가하면 각 언어별 URL에 대한 hreflang 태그가 자동으로 생성됩니다.

검색엔진이 모든 언어 버전을 인덱싱하나요?

URL 기반 언어 분리를 사용하면 검색엔진이 각 언어 버전을 독립적으로 인덱싱합니다. 자동 리다이렉트 방식보다 SEO에 유리합니다.

개발 관련

개발 환경에서 언어를 강제로 변경하려면?

URL에 ?locale=en 파라미터를 추가하거나, URL 경로를 /en/...으로 변경하면 됩니다.

세션 기반 언어 저장과 URL 기반의 차이점은?

방식	SEO	공유 가능	권장
세션/쿠키 기반	❌ 나쁨	❌	비권장
URL 기반	✅ 좋음	✅	권장

URL 기반 방식은 각 언어 페이지가 고유한 URL을 가지므로 SEO와 공유에 유리합니다.