선택한 CLI 버전 0 콘텐츠 재번역하기
원문이나 지침이 바뀌면 작업 범위를 조절하고 승인된 수정 사항을 보호하면서 기존 번역을 갱신하세요.
원문 콘텐츠가 바뀌면 일반 실행을 사용하세요. 원문은 그대로지만 번역에 새 지침을 반영하거나 만족스럽지 않은 값을 교체해야 한다면 강제 실행을 사용하세요. 두 방식 모두 일반적인 수동 수정 사항을 덮어쓸 수 있습니다.
원문 변경에 따라 일반 실행 대상 정하기 #
lingo run| 원문/대상 상태 | 버전 0 일반 실행 결과 |
|---|---|
| 원문 값이 이전 체크섬에 해당하는 값과 달라짐 | 변경된 값을 번역합니다. |
| 원문 키가 대상에 없음 | 누락된 콘텐츠를 번역합니다. |
| 원문 키가 삭제됨 | 해당 키에 대응하는 관리 대상 항목을 삭제합니다. |
| 새 키의 원문 값 체크섬이 삭제된 키의 원문 값 체크섬과 일치함 | 해당 처리 범위 안에서 번역을 재사용합니다. |
| 대상 값이 있고 원문은 변경되지 않음 | 대상 값을 유지합니다. |
일반적인 수동 수정 사항은 원문이 그대로일 때 유지되지만, 이후의 모든 업데이트에서 보장되지는 않습니다. 보존된 키에는 사람이 관리하는 별도의 값이 유지됩니다.
영향받는 번역 하나만 갱신하기 #
모델, 프롬프트, 용어집 또는 규칙을 변경했다면 영향을 받는 로캘과 키부터 시작하세요.
lingo run --force --target-locale es --key welcome/title여기서 welcome/title은 welcome 안의 title를 지정합니다. 0.138.10에서 실행 명령은 정확한 키, 경계를 인식하는 접두사, 글로브 패턴을 지원합니다. 셸 확장 없이 하위 항목을 선택하려면 --key 'welcome/**'을 따옴표로 감싸세요.
번역 결과를 원문과 나란히 비교한 다음 애플리케이션에서 불러오세요. 로캘이나 키로 범위를 제한한 작업은 기존의 공유 기준 상태를 갱신하지 않습니다. 이후 일반 실행에서 같은 원문 변경을 예기치 않게 다시 처리하지 않도록 Lockfile 확정 규칙을 따르세요.
대규모 프로젝트에서 관리하기 쉬운 작업 범위 정하기 #
--target-locale, --bucket, --file, --key는 반복해서 지정할 수 있는 선택 조건입니다. --source-locale는 실행에 사용할 원문을 변경합니다. 설정되지 않은 파일을 임의로 지정하지 말고, 설정된 버킷/경로 목록을 기준으로 범위를 좁히세요.
lingo run --target-locale es --bucket json --file 'apps/web/**'실행 명령의 파일 매처는 탐색된 설정 경로를 부분 문자열이나 미니매치 방식으로 비교합니다. 삭제 명령의 파일 매처는 부분 문자열 일치만 지원하며, 키 매처의 동작도 다릅니다. 두 명령에서 선택 조건을 그대로 재사용하기 전에는 선택되는 항목을 반드시 확인하세요.
더 넓은 범위를 의도적으로 갱신하려면 다음과 같이 실행하세요.
lingo run --force --bucket json --target-locale es이렇게 하면 선택한 스페인어 JSON 작업 전체를 다시 생성할 수 있습니다. 별도 조건 없이 lingo run --force만 사용하면 설정된 프로젝트 전체가 대상이 됩니다. 범위를 넓히기 전에 승인된 결과물을 보존하세요. Lingo.dev 백엔드를 사용할 때는 동일한 강제 실행 범위의 예상 사용량을 확인하세요.
변경 규모가 크면 파일과 로캘별로 작업 범위를 나눠 변경 내역을 더 쉽게 검토할 수 있습니다. 실패가 발생해도 성공한 작업 단위의 결과물은 유지하고, 전체를 강제 실행하기 전에 해당 범위부터 재시도하세요. 병렬 처리는 처리량을 제어할 뿐, 선택 범위나 롤백을 제어하지는 않습니다.
사용자 인터페이스 카탈로그와 문서는 각각 별도의 형식 버킷에 두고, 생성된 콘텐츠와 초안은 제외하세요. 대상이나 로컬라이제이션 엔진이 다르면 패키지 설정을 분리하세요. 지속적 통합 환경에서 lingo run --frozen는 번역을 수행하지 않고 신뢰할 수 있는 기준 상태를 확인합니다. 실패를 숨기려고 체크섬을 다시 생성하지 말고 원인을 조사하세요. 현재 실행기 구성 예시는 다른 패키지와 설정을 사용하므로 도입 전에 마이그레이션하세요.
삭제가 목적일 때만 삭제 명령 사용하기 #
기존의 삭제 후 실행 방식은 대상 키를 누락 상태로 만들어 일반 실행의 누락 항목 채우기 과정에서 처리되도록 합니다. 이 방식은 재생성에 성공하기 전에 결과물을 삭제하며, 성능 개선 효과도 입증되지 않았습니다. 삭제 명령 레퍼런스에서 이 명령만의 선택 조건과 원문 로캘 관련 위험을 확인하세요. 재생성과 검토가 성공적으로 끝날 때까지 복구 가능한 사본을 보관하세요.