업데이트할 때 검토한 번역 보존하기

원문과 승인된 번역의 기준 버전을 함께 보관하고, 적절한 업데이트 모드를 선택한 뒤, 무엇이 바뀌었는지 정확히 확인하세요.

승인된 번역은 보존할 가치가 있는 작업 결과입니다. 원문 메시지 하나가 바뀌어도 주변 메시지의 번역은 여전히 정확할 수 있습니다. 워크플로에 적절한 기준 버전을 제공하고 의도한 병합 방식을 적용하면, 재사용을 통해 이러한 번역을 유지할 수 있습니다.

“증분”이라는 말만으로는 이러한 보호 방식을 설명할 수 없습니다. 이전 원문과 승인된 번역을 보관하고, 호출 측의 업데이트 처리 규약을 선택한 뒤, 실제 변경 내역을 살펴보세요. 수정할 번역이 명확하다면 단일 키 업데이트를 사용하고, 제출한 작업이 중단되었다면 복구부터 시작하세요.

바꿔야 할 내용과 유지해야 할 내용을 모두 기록하기 #

다음 원문을 예로 들어 보겠습니다.

json
{
  "retention": "Reports remain available for 30 days.",
  "support": "Contact support",
  "productName": "ExampleApp"
}

원문 담당자가 보관 기간을 60일로 변경합니다. 이전 원문과 새 원문, 검토한 번역을 모두 보관하세요. 번역에서도 기간은 바뀌어야 하지만, 승인된 support 표현은 유지되어야 합니다. productName 항목을 원문과 동일하게 유지하는 것과 검토한 번역 표현을 보존하는 것은 서로 다른 요구 사항입니다.

다운로드 이후 로컬에서 수정한 내용과 수정 이유까지 포함해, 가장 최근에 승인된 번역 버전을 저장하세요. 서버의 기준 버전과 작업 트리의 번역 내용이 이미 달라졌을 수 있습니다.

원문 변경에는 기본 변경분 계획 사용하기 #

현재 CLI 버전에서 기본 lingo push --wait 작업은 기록된 원문 상태와 번역을 바탕으로 변경 사항을 계획합니다. 설정, 원문, 승인된 번역, .lingo/lock.json 항목을 버전 관리에 포함하세요. Lockfile 삭제는 계획에 영향을 줍니다. 단순히 상태만 새로 고치는 작업이 아닙니다.

--backfill-missing 작업은 누락된 번역 파일을 채우지만, 기존 파일에서 누락되거나 변경된 모든 키까지 채우지는 않습니다. 위치 인수로 지정한 원문 패턴에는 범위가 한정된 계획이 적용되며, 재사용 방식도 다릅니다. --force 작업은 별도 파일로 저장되는 번역 중 선택된 대상을 다시 생성하므로 승인된 텍스트를 대체할 수 있습니다. 반면 공유 XCStrings 카탈로그는 내부에 포함된 번역을 계속 재사용할 수 있습니다. 대체를 요청하기 전에 푸시 레퍼런스를 참고해 적절한 방식을 선택하세요.

넓은 범위에 걸쳐 실행하기 전에는 적용 범위를 살펴보고, 도움이 된다면 예상치도 확인하세요. 결과를 가져온 뒤에는 변경된 값과 그 주변의 승인된 값을 비교하세요. 실행에 붙은 이름이 아니라 실제 결과로 보존 여부를 확인하세요.

원문 잠금과 번역 보존 구분하기 #

해당 기능이 지원되는 형식에서 잠금 처리된 키는 원문 텍스트를 번역에 복사합니다. 보존 처리된 키는 기존 번역 값을 유지합니다. 따라서 검토한 프랑스어 메시지를 잠그면 영어로 대체될 수 있습니다. 잠금은 프랑스어 표현을 보호하는 기능이 아닙니다.

키 제어 방식은 형식마다 다릅니다. 출력에서 키를 제외하는 것 역시 별개의 동작입니다. 원문이 전달하는 사실이 바뀌었다면 해당 값을 무조건 보존해서는 안 됩니다. 더 이상 유효하지 않은 의미가 남을 수 있기 때문입니다.

결과를 가져올 때 로컬 수정 내용 조정하기 #

업데이트를 제출하기 전에 기존 수정 내용을 저장하세요. 푸시 시점에 기록된 번역은 해당 업데이트 과정에서 대체될 수 있습니다. 제출 이후의 수정 사항을 감지하려면 --wait 옵션을 생략한 뒤 lingo pull --dry-run 항목을 살펴보세요. 풀 작업은 로컬 번역을 당시 기록된 번역 및 해시와 비교하며, 이후 수정 사항을 덮어쓰게 되는 경우 덮어쓰기를 거부할 수 있습니다. push --wait에서 직접 다운로드할 때는 이러한 최신 상태 확인을 수행하지 않습니다.

충돌이 발생하면 관련 원문 버전을 기준으로 로컬 수정 내용, 기록된 번역, 새로 들어오는 결과를 비교하세요. 여전히 유효한 수정 사항은 일반적인 검토 절차를 거쳐 보존하세요. lingo pull --force 옵션은 로컬 작업을 저장하고 대체하기로 명확히 결정한 뒤에만 사용하세요. 강제 실행은 보호 장치를 우회할 뿐, 올바른 표현을 선택해 주지는 않습니다.

공유 애플 카탈로그는 파일 전체를 보관하고, 변경하지 않은 로캘도 확인하세요. 원문과 여러 언어가 함께 들어 있는 파일을 버려도 되는 번역 출력물처럼 삭제하지 마세요.

검토 후 새 기준 버전 승인하기 #

앞의 예에서는 새 번역의 기간이 60일인지, support 값이 보존되었는지, productName 항목이 의도대로 동작하는지 확인하세요. 번역을 실제로 사용하는 런타임에서 변수와 구조를 점검하세요. 변경 내역은 무엇이 바뀌었는지 보여 주고, 언어 검토는 새로 서술한 내용이 올바른지 판단합니다.

승인된 번역을 해당 원문 버전과 함께 다음 기준 버전으로 보관하세요. 수정 내용을 향후 지침에도 반영해야 한다면 용어집이나 규칙의 변경 여부를 별도로 결정하세요. 수정 한 번을 승인했다고 해서 로컬라이제이션 엔진이 새 정책을 학습한다고 가정해서는 안 됩니다.