언어 관리

사이트에서 지원할 언어를 추가하고 활성화/비활성화하는 방법을 설명합니다.

왜 필요한가

다국어 번역을 시작하려면 먼저 지원할 언어를 등록해야 합니다. 기본 언어는 한국어(ko)이며, 영어, 일본어, 중국어 등을 추가할 수 있습니다. 언어를 비활성화하면 번역 데이터는 보존되지만 사이트에 표시되지 않으므로, 번역이 완성되기 전에 미완성 상태가 노출되는 것을 방지할 수 있습니다.

쓰면 뭐가 좋은지

지원 언어를 한 곳에서 관리할 수 있습니다
언어별로 활성화/비활성화를 즉시 전환할 수 있습니다
번역 완성 전에는 비활성 상태로 두고, 완성 후 활성화하는 안전한 워크플로우가 가능합니다
새 언어 추가 시 번역 관리 페이지에서 즉시 번역 작업을 시작할 수 있습니다

어떻게 쓰는지

언어 관리 페이지 접근

Admin 패널 → 설정 → 언어 관리 (/admin/settings/languages)

현재 지원 언어 확인

페이지에 카드 형태로 모든 언어가 표시됩니다:

정보	예시
국기 이모지	🇰🇷 🇺🇸 🇯🇵
네이티브 이름	한국어, English, 日本語
영어 이름 + 코드	Korean (ko), English (en)
상태	✅ 활성화됨 / ⏸️ 비활성화

한국어(ko)는 기본 언어로 항상 활성화되어 있으며 비활성화할 수 없습니다.

언어 활성화/비활성화

각 언어 카드의 토글 버튼을 클릭하면 즉시 상태가 변경됩니다.

활성화 → 사이트에 해당 언어 옵션 표시, 번역된 콘텐츠 공개
비활성화 → 사이트에서 해당 언어 숨김, 번역 데이터는 보존

새 언어 추가

페이지 하단 "새 언어 추가" 폼에서:

언어 코드 (필수) , 소문자, 최대 10자

예: vi (베트남어), th (태국어), zh-hans (중국어 간체), pt-br (브라질 포르투갈어)

영어 이름 , 예: Vietnamese
네이티브 이름 , 예: Tiếng Việt
국기 이모지 , 예: 🇻🇳

"+ 언어 추가" 클릭 → 새 언어가 비활성 상태로 등록됩니다.

권장 워크플로우

번역이 완성되기 전에 활성화하면 빈 번역이 사이트에 노출됩니다. 권장 순서:

새 언어 추가 (비활성 상태)
번역 관리 페이지에서 번역 작업 수행
번역 검수 완료
언어 토글로 활성화
사이트 배포

에이전트에게 요청하기

"영어 지원 추가해줘"
"일본어 번역 시작할 수 있게 언어 등록해줘"
"베트남어 비활성화해줘" (번역 데이터는 유지됨)

주의사항

번역이 없는 상태로 언어를 활성화하면, 해당 언어 페이지에 기본 언어(한국어)가 표시됩니다
언어를 비활성화해도 기존 번역 데이터는 삭제되지 않습니다
언어 코드는 등록 후 변경할 수 없습니다 , 잘못 입력한 경우 삭제 후 재등록