CLI 버전 0에서 기존 번역 활용하기
기존 값을 유지하면서 레거시 카탈로그의 누락된 키를 채우고, 신뢰할 수 있는 원문 기준 상태를 설정하세요.
버전 0에서는 다른 곳에서 만든 카탈로그로 시작할 수 있습니다. 일반적인 변경분 처리에서는 원문과 번역문의 키를 비교해, 기존 값을 다시 생성하지 않고 누락된 항목만 추가합니다. 이는 누락된 파일을 보충하는 현재 CLI의 방식과 다릅니다.
기존 작업 보존하기 #
i18n.json에서 카탈로그의 버킷을 설정하고, 승인된 번역문은 복구할 수 있도록 사본을 저장하세요. 기존 값이 실제 번역인지도 확인하세요. 원문 언어로 된 임시 값 때문에 채워야 할 누락 항목이 드러나지 않을 수 있습니다.
예를 들어 다음 원문에는 키가 세 개 있습니다.
{
"welcome": "Welcome back",
"button.save": "Save",
"button.cancel": "Cancel"
}기존 스페인어 번역문에는 키가 두 개 있습니다.
{
"welcome": "Te damos la bienvenida de nuevo",
"button.save": "Guardar"
}일반적인 누락 항목 채우기 작업은 기존 값을 유지하면서 button.cancel을 추가합니다. 단, 이전 체크섬으로 재번역이 필요한 원문 변경이 확인되면 기존 값도 다시 생성합니다.
로캘 하나에서 실행하고 변경 사항 확인하기 #
lingo run --target-locale es추가된 항목, 원문에서 사라져 삭제된 키, 변경된 키의 재생성된 값을 확인하세요. 번역 언어와 애플리케이션의 로딩 상태를 점검한 뒤, 승인된 결과물과 Lockfile 상태를 함께 커밋하세요.
범위를 제한해 실행하면 기존 원문 체크섬의 기준 상태는 갱신되지 않습니다. Lockfile이 그대로라고 해서 모든 로캘이 현재 원문과 일치한다는 뜻은 아닙니다. 이후 일반 실행에서 변경된 원문을 다시 처리할 수 있으므로, 기준 상태 확정 절차를 따르세요.
이미 있는 키에 이전 체크섬이 없더라도, 0.138.10은 체크섬이 없다는 이유만으로 해당 키를 업데이트된 것으로 표시하지 않습니다. 따라서 잠금 정보가 없다고 해서 모든 항목이 강제로 재번역되는 것은 아니며, 기존 번역문이 최신 상태라는 뜻도 아닙니다. 새 기준 상태를 신뢰할 수 있는 기준으로 삼기 전에, 확신할 수 없는 원문과 번역문 쌍을 확인하세요.
확인된 문제는 별도로 수정하기 #
기존 값이 잘못되었다면 수동으로 수정하거나 선택한 항목만 갱신하도록 요청하세요:
lingo run --force --target-locale es --key button.cancel강제 실행은 수동으로 작업한 내용을 덮어쓸 수 있습니다. 사람이 직접 관리해야 하는 값에는 보존 키를 사용하고, 이후 원문 변경 사항을 검토하는 일도 관리 책임에 포함하세요.