I18n 전문가
개요
완전한 i18n 설정 및 감사 작업을 제공합니다: i18n 프레임워크를 구성하고, 사용자 대상 문자열을 키로 교체하며, 로케일 패리티를 보장하고, en-US 및 zh-CN에 대한 복수형/형식의 유효성을 검사합니다.
핵심 기능
- 라이브러리 선택 및 설정 (React, Next.js, Vue)
- 키 아키텍처 및 로케일 파일 구성
- 번역 생성 및 품질 전략 (AI, 전문가, 수동)
- 라우팅 및 언어 감지/전환
- SEO 및 메타데이터 지역화 (해당하는 경우)
- RTL 지원 (RTL 로케일이 범위에 있는 경우에만)
범위 입력 (불명확한 경우 질문)
- 프레임워크 및 라우팅 스타일
- 기존 i18n 상태 (없음, 부분, 레거시)
- 대상 로케일 (기본값: en-US + zh-CN)
- 번역 품질 요구 사항 (AI vs 전문가 vs 수동)
- 사용 중인 로케일 형식 (JSON, YAML, PO, XLIFF)
- 형식/문화 요구 사항 (있는 경우)
워크플로우 (감사 -> 수정 -> 검증)
-
범위 및 로케일 대상 확인
- i18n 프레임워크 및 로케일 위치 식별
- 로케일 확인; 지정된 경우 기본값은 en-US + zh-CN
-
i18n 기준선 설정 (없는 경우)
- 프레임워크에 적합한 라이브러리 선택 (예: React: react-i18next; Next.js: next-intl; Vue: vue-i18n)
- 패키지 설치 및 i18n 진입/설정 파일 생성
- 앱 루트에 프로바이더 연결 및 로케일 리소스 로드
- 언어 전환기 추가 및 지속성 (라우트/파라미터/localStorage) 필요에 따라 설정
- 로케일 파일 레이아웃 및 키 네임스페이스 수립
- 라우팅이 로케일을 인식하는 경우, 로케일 세그먼트 전략 (하위 경로, 하위 도메인, 쿼리 파라미터)을 초기에 정의
- 메타데이터가 사용자 대상인 경우, 제목/설명에 대한 번역 포함
-
키 사용 및 로케일 패리티 감사
- 실행:
python scripts/i18n_audit.py --src <src-root> --locale <path/to/en-US.json> --locale <path/to/zh-CN.json> - 누락된 키/패리티 격차를 차단 항목으로 처리
- 동적 키 (
t(var)) 수동 확인
- 실행:
-
원시 사용자 대상 문자열 찾기
- 검색:
rg -n --glob '<src>/**/*.{ts,tsx,js,jsx}' "<[^>]+>[^<{]*[A-Za-z][^<{]*<" rg -n --glob '<src>/**/*.{ts,tsx,js,jsx}' "aria-label=\\
- 검색: