# 언어 관리
사이트에서 지원할 언어를 추가하고 활성화/비활성화하는 방법을 설명합니다.
---
## 왜 필요한가
다국어 번역을 시작하려면 먼저 지원할 언어를 등록해야 합니다. 기본 언어는 한국어(ko)이며, 영어, 일본어, 중국어 등을 추가할 수 있습니다. 언어를 비활성화하면 번역 데이터는 보존되지만 사이트에 표시되지 않으므로, 번역이 완성되기 전에 미완성 상태가 노출되는 것을 방지할 수 있습니다.
## 쓰면 뭐가 좋은지
- 지원 언어를 한 곳에서 관리할 수 있습니다
- 언어별로 활성화/비활성화를 즉시 전환할 수 있습니다
- 번역 완성 전에는 비활성 상태로 두고, 완성 후 활성화하는 안전한 워크플로우가 가능합니다
- 새 언어 추가 시 번역 관리 페이지에서 즉시 번역 작업을 시작할 수 있습니다
## 어떻게 쓰는지
### 언어 관리 페이지 접근
Admin 패널 → 설정 → **언어 관리** (`/admin/settings/languages`)
### 현재 지원 언어 확인
페이지에 카드 형태로 모든 언어가 표시됩니다:
| 정보 | 예시 |
|------|------|
| 국기 이모지 | 🇰🇷 🇺🇸 🇯🇵 |
| 네이티브 이름 | 한국어, English, 日本語 |
| 영어 이름 + 코드 | Korean (ko), English (en) |
| 상태 | ✅ 활성화됨 / ⏸️ 비활성화 |
한국어(ko)는 기본 언어로 항상 활성화되어 있으며 비활성화할 수 없습니다.
### 언어 활성화/비활성화
각 언어 카드의 토글 버튼을 클릭하면 즉시 상태가 변경됩니다.
- **활성화** → 사이트에 해당 언어 옵션 표시, 번역된 콘텐츠 공개
- **비활성화** → 사이트에서 해당 언어 숨김, 번역 데이터는 보존
### 새 언어 추가
페이지 하단 "새 언어 추가" 폼에서:
1. **언어 코드** (필수) — 소문자, 최대 10자
- 예: `vi` (베트남어), `th` (태국어), `zh-hans` (중국어 간체), `pt-br` (브라질 포르투갈어)
2. **영어 이름** — 예: Vietnamese
3. **네이티브 이름** — 예: Tiếng Việt
4. **국기 이모지** — 예: 🇻🇳
"+ 언어 추가" 클릭 → 새 언어가 **비활성 상태**로 등록됩니다.
### 권장 워크플로우
번역이 완성되기 전에 활성화하면 빈 번역이 사이트에 노출됩니다. 권장 순서:
1. 새 언어 추가 (비활성 상태)
2. 번역 관리 페이지에서 번역 작업 수행
3. 번역 검수 완료
4. 언어 토글로 **활성화**
5. 사이트 배포
### 에이전트에게 요청하기
- "영어 지원 추가해줘"
- "일본어 번역 시작할 수 있게 언어 등록해줘"
- "베트남어 비활성화해줘" (번역 데이터는 유지됨)
---
## 주의사항
- 번역이 없는 상태로 언어를 활성화하면, 해당 언어 페이지에 기본 언어(한국어)가 표시됩니다
- 언어를 비활성화해도 기존 번역 데이터는 삭제되지 않습니다
- 언어 코드는 등록 후 변경할 수 없습니다 — 잘못 입력한 경우 삭제 후 재등록
## 관련 콘텐츠
- 📋 커리큘럼: W4 Module 4 토픽 4-7 (다국어 지원)
- 🎯 투어: Admin에서 "언어 관리" 투어 실행
- 📖 관련 가이드: 번역 관리 (`/guide#translation-management`)