전체를 다시 번역하지 않고 언어 추가하기
승인된 번역을 유지하면서 새 대상 로캘을 추가하고, 애플리케이션에서 새 리소스를 사용할 수 있는지 확인하세요.
언어를 추가하려면 세 가지 작업이 맞물려야 합니다. 번역할 언어를 선택하고, 리소스를 만들고, 애플리케이션이 그 리소스를 불러오도록 설정해야 합니다. 인터페이스에 새 언어 옵션을 추가한다고 카탈로그까지 생성되지는 않습니다. 카탈로그를 번역했다고 해당 경로에서 자동으로 사용하는 것도 아닙니다.
먼저 복구 가능한 원문과 승인된 대상 번역을 준비하세요. 필요하다면 지역이나 문자 체계까지 포함해 추가하려는 로캘을 기록하세요. pt-BR과 pt-PT는 서로 다른 독자층을 가리키므로, 각 독자층에 적합한 표현도 다를 수 있습니다.
기존 구조와 지침 살펴보기 #
원문 패턴, 현재 대상 로캘, 예상 출력 경로를 목록으로 정리하세요. 대상 파일이 분리되어 있다면 각각 독립적으로 추가할 수 있습니다. 반면 공유 Xcode 문자열 카탈로그는 한 파일에 여러 로캘 슬롯을 저장하므로, 파일이 있다는 사실만으로는 번역 범위를 확인할 수 없습니다.
새 독자층에 맞춰 모델 지원 범위, 용어, 격식 수준, 문체를 검토하세요. 인접 로캘의 지침은 적용할 수 있는 부분만 재사용하세요. 같은 용어를 쓰더라도 독자를 부르는 방식은 달라질 수 있습니다. 오른쪽에서 왼쪽으로 쓰는 언어를 지원하려면 문자열 번역뿐 아니라 애플리케이션의 표시 방향과 레이아웃도 조정해야 합니다.
현재 CLI 프로젝트에 대상 로캘 추가하기 #
현재 CLI의 대상 로캘은 .lingo/config.json의 targetLocales에서 가져옵니다. push에는 --target-locale 또는 --locale 옵션이 없습니다. 모노레포에서는 현재 작업 디렉터리를 기준으로 어떤 프로젝트 구성이 선택되는지 확인하세요.
대상 로캘을 추가하기 전에 lingo push --wait을 사용해 기존 언어에 아직 반영하지 않은 일반 원문 업데이트를 모두 마무리하세요. 검토를 마치고 결과물을 가져온 다음, 기존 대상 번역을 현재 원문과 대조하세요. 새 언어를 추가하는 동안에는 이 원문 리비전을 그대로 유지하세요.
누락 파일 채우기는 기존 대상 파일을 변경하지 않습니다. 새 언어의 파일만 생성할 때는 기존 원문 기준선을 유지하므로, 이후 일반 푸시로 다른 언어에 아직 반영하지 않은 수정 사항을 처리할 수 있습니다. 이런 업데이트를 먼저 마치면 기존 대상 번역과 새 대상 번역을 검토가 끝난 동일한 원문 리비전에 맞출 수 있습니다.
그런 다음 설치, 인증, 연결을 마친 프로젝트의 구성에 대상 로캘을 추가하고, 예정된 누락 파일 작업을 확인하세요.
lingo push --backfill-missing --estimate
lingo push --backfill-missing --wait예상치 산출은 번역을 수행하거나 작업을 생성하지 않지만, 작업 계획을 위해 서버에 없는 파일을 업로드합니다. 오프라인으로 실행되지 않으며, 산출된 금액이 보장되는 것도 아닙니다. 누락 파일 채우기는 설정된 패턴을 확인하며 빠진 대상 파일을 채웁니다. 기존 대상 파일 안에 새 키를 추가하지는 않습니다. 새 로캘을 최신 상태로 맞춘 뒤에는 lingo push --wait을 사용해 저장된 기준선을 바탕으로 이후의 일반 원문 변경 사항을 처리합니다.
공유 XCStrings 카탈로그는 한 파일 안에서 로캘별로 작업을 계획합니다. iOS 워크플로에 따라 새 항목을 확인하세요.
요청 대상을 반드시 하나의 로캘로 제한해야 한다면, 통제된 브랜치나 작업 구성에서 targetLocales의 범위를 좁히고 작업 후 전체 목록을 복원하세요. 새 언어를 처리하려는 이유만으로 강제 옵션을 추가하지 마세요. 이 옵션은 범위에 포함된 기존 대상 번역을 다시 번역하므로 검토를 마친 표현을 덮어쓸 수 있습니다. 이런 차이는 푸시 문서에서 설명하며, 이전 세대의 플래그는 CLI 0 버전 로캘 레퍼런스에서 다룹니다.
어시스턴트에도 같은 작업 범위 설정하기 #
에이전트는 구조를 살펴보고, 로캘 지침을 제안하고, 구성 변경 내역을 준비할 수 있습니다. 로컬 파일과 조직 소유의 로컬라이제이션 엔진 설정 중 무엇을 변경할 수 있는지, 둘 다 변경해도 되는지 명시하세요. 위임 문서에서 이 권한들을 구분해 설명합니다.
어떤 기본 모델과 대체 모델이 적용되는지, 어떤 지침이 공통이고 어떤 지침이 로캘별인지 설명하도록 요청하세요. 결과를 비교하기 전에 저장된 상태를 확인하세요. 선택 방식은 로캘 결정 문서에서 설명합니다. 선호 모델 설정이 언어 품질의 평가 기준은 아닙니다.
새 독자층을 위한 결과 확인하기 #
반환된 경로와 변경 내역을 의도한 작업 범위와 대조하세요. 원문 업데이트나 승인된 수정에 따른 변경이 아니라면 기존에 승인된 대상 번역은 그대로 유지되어야 합니다. 애플리케이션의 리소스 도구로 변수, 복수형 분기, 로캘 메타데이터를 검증하세요.
새 로캘로 대표적인 콘텐츠를 불러오세요. 의미뿐 아니라 대체 동작, 표시 영역 넘침, 표시 방향도 확인하세요. 적용 범위를 넓히기 전에 측정에 사용할 원문 리비전과 결과를 보관하세요.
구성에서 로캘을 제거하면 새 작업의 대상으로 선택되지 않을 뿐, 리소스나 런타임 경로가 삭제되지는 않습니다. 리소스와 런타임 경로의 변경 여부는 별도로 결정하세요. 특히 하나의 공유 카탈로그에 원문과 여러 언어가 함께 들어 있다면 더욱 신중하게 결정해야 합니다.