CLI 버전 0 지원 형식
설치된 레거시 파서에 맞는 로캘 구조를 확인하고, 재구성된 네이티브 파일을 검증하세요.
추출할 데이터와 출력으로 받을 파일에 따라 버킷을 선택하세요. 버전 0은 버킷 유형을 기준으로 파서를 선택하며, 파일 확장자로는 이 선택이 바뀌지 않습니다. 따라서 JSON 카탈로그와 다중 로캘 Xcode 카탈로그는 둘 다 메시지를 담고 있더라도 서로 다른 설정이 필요합니다.
출력 모델부터 선택하기 #
대부분의 버킷은 경로에 [locale]을 사용해 로캘별로 파일을 따로 생성합니다. CSV, Xcode 문자열 카탈로그, JSON 딕셔너리, 뷰 국제화 블록은 한 파일에 여러 로캘을 담을 수 있습니다. 공유 파일로 출력할 때는 번역 후 대상 섹션과 소스 섹션을 모두 확인하세요.
| 버킷 | 콘텐츠 | 문서에 명시된 출력 모델 |
|---|---|---|
json, json5, jsonc | 구조화된 JSON의 여러 형식 | 로캘별 개별 파일 |
json-dictionary | 로캘을 키로 쓰는 객체가 포함된 JSON 값 | 공유 파일 |
yaml | YAML 카탈로그 | 로캘별 개별 파일 |
yaml-root-key | 출력 로캘의 루트 키로 감싼 YAML | 로캘별 개별 파일 |
markdown, mdx, markdoc | 마크다운 계열 문서 | 로캘별 개별 파일 |
html, mjml | HTML 및 이메일 마크업 | 로캘별 개별 파일 |
android | 안드로이드 XML 리소스 | 로캘별 개별 파일 |
xcode-strings, xcode-stringsdict | 애플 문자열 및 복수형 리소스 | 로캘별 개별 파일 |
xcode-xcstrings | Xcode 문자열 카탈로그 | 공유 파일 |
flutter | ARB 카탈로그 | 로캘별 개별 파일 |
po | 겟텍스트 PO | 로캘별 개별 파일 |
properties | 자바 프로퍼티 | 로캘별 개별 파일 |
csv | 다중 로캘 CSV | 공유 파일 |
csv-per-locale | 로캘별 CSV 파일 하나 | 로캘별 개별 파일 |
xml, xliff | XML 및 XLIFF | 로캘별 개별 파일 |
srt, vtt | 자막 | 로캘별 개별 파일 |
php | PHP 로컬라이제이션 배열 | 로캘별 개별 파일 |
typescript | 타입스크립트 로컬라이제이션 콘텐츠 | 로캘별 개별 파일 |
vue-json | 로캘을 키로 쓰는 뷰 국제화 JSON 블록 | 공유 파일 |
txt | 일반 텍스트 | 로캘별 개별 파일 |
이 목록은 레거시 버킷 계열을 정리한 것으로, 다른 도구의 호환성 목록이 아닙니다. 버전 0의 초기 릴리스에는 일부 항목이 아직 추가되지 않았을 수 있습니다. 타입스크립트, PHP, 뷰 파서는 각각 지원하는 로컬라이제이션 구조를 처리합니다. 이러한 파서가 있다고 해서 실행 가능한 소스 코드를 임의로 다시 작성해도 되는 것은 아닙니다.
0.138.10 디스패처에는 ail, ejs, twig, dato, xcode-xcstrings-v2도 포함되어 있습니다. 입력과 출력을 살펴보기 전까지는 설치된 프로젝트에서 기존에 사용하던 파서를 유지하세요. 스키마의 열거형에 있다는 것만으로는 충분하지 않습니다. 레거시 스키마에는 compiler도 명시되어 있지만, 이 디스패치 경로에는 그에 해당하는 로더가 없습니다.
yaml-root-key은 선택한 로캘의 루트만 재구성합니다. 소스와 대상이 같은 공유 YAML 파일을 가리키도록 설정하지 마세요. 파일을 쓰는 과정에서 다른 루트가 덮어써질 수 있습니다. locales/[locale].yml처럼 로캘별 경로를 사용하세요. 이는 새 로캘을 원래 구조에 명시적으로 병합하는 JSON 딕셔너리나 뷰 블록과는 다릅니다.
대표 파일 설정하기 #
JSON에서는 같은 패턴으로 소스 파일과 별도의 대상 파일을 지정합니다:
{
"buckets": {
"json": { "include": ["src/locales/[locale].json"] }
}
}공유 Xcode 카탈로그와 안드로이드의 로캘별 리소스를 함께 사용하는 경우:
{
"buckets": {
"xcode-xcstrings": { "include": ["ios/Localizable.xcstrings"] },
"android": {
"include": ["android/app/src/main/res/values-[locale]/strings.xml"]
}
}
}안드로이드 로캘 표기와 리소스 디렉터리를 애플리케이션에 맞게 조정하세요. 첫 실행 후에는 각 빌드 도구로 두 네이티브 형식을 검증하고, 애플리케이션이 선택한 대상을 불러오는지 확인하세요. 설정이 정상적으로 받아들여졌다는 것만으로 해당 경로가 작동한다고 볼 수는 없습니다.
생성된 출력은 제외하고 파일 찾기 #
경로는 i18n.json을 기준으로 해석되며, *은 같은 경로 수준 안에서 일치하는 항목을 찾습니다. 재귀 패턴 **은 0.135.0에서 도입되었습니다. 기본적으로 node_modules, .git, dist, build, .next, .turbo을 제외합니다. 그 밖에 생성된 콘텐츠도 명시적으로 제외하세요:
{
"buckets": {
"markdown": {
"include": ["docs/[locale]/*.md"],
"exclude": ["docs/[locale]/drafts/*.md"]
}
}
}패키지가 여러 개라면 언어와 로컬라이제이션 엔진의 관리 주체에 따라 공유 설정 또는 패키지별 설정을 선택하세요. 경로 범위를 좁히면 생성된 출력이 의도치 않게 소스 입력으로 사용되는 일을 막을 수 있습니다.
형식별 보호 기능 확인하기 #
키/값 카탈로그에는 각 값의 관리 주체에 따라 키 제어를 적용하세요. JSONC와 Xcode 카탈로그의 주석에는 번역가 메모를 담을 수 있습니다. 자유 형식 문서와 자막에서는 이러한 기능이 같은 방식으로 쓰이지 않을 수 있습니다.
파서가 재구성한 카탈로그의 키와 값, 문서의 마크업과 링크, 자막의 타이밍 정보, 네이티브 리소스 식별자 등을 확인하세요. 출력을 실제로 사용하는 파서나 빌드에서 처리할 수 있는지 확인한 뒤에만 승인하세요. 마이그레이션할 때는 이 레거시 지원 표가 그대로 적용된다고 가정하지 말고, 최신 형식 설명서와 호출하는 도구의 지원 목록을 참고하세요.