Lingo.dev CLI는 대상 파일에 직접 가한 수동 수정을 그대로 유지합니다. 대상 파일을 편집해 생성된 번역을 오버라이드하면, 원본 콘텐츠가 바뀌지 않는 한 이후 CLI 실행에서도 그 변경사항이 유지됩니다.
오버라이드 작동 방식#
CLI는 대상 콘텐츠가 아니라 원본 콘텐츠의 지문을 추적합니다. 대상 파일에서 번역을 수동으로 수정해도 원본 지문은 바뀌지 않기 때문에, CLI는 해당 키를 이미 번역된 것으로 판단하고 건너뜁니다.
1
CLI가 번역을 생성합니다
json
// locales/es.json (generated)
{ "greeting": "Bienvenido a nuestra plataforma" }2
직접 오버라이드합니다
json
// locales/es.json (manually edited)
{ "greeting": "¡Bienvenido a nuestro espacio digital!" }3
다음 실행에서도 오버라이드가 유지됩니다
bash
npx lingo.dev@latest run
# Your custom translation remains unchanged오버라이드가 대체되는 경우#
원본 콘텐츠가 바뀌면 CLI가 새로운 지문을 감지하고 해당 키를 다시 번역해 기존 오버라이드를 대체합니다:
json
// locales/en.json (source updated)
{ "greeting": "Welcome to our new platform" }새 지문이 lockfile 항목과 일치하지 않으므로, CLI는 이 키에 대해 새로운 번역을 생성합니다.
키 이름 변경#
콘텐츠만 그대로라면 키 이름이 바뀌어도 CLI는 번역을 유지합니다. lockfile은 콘텐츠와 키 지문을 모두 추적하므로, 번역 작업을 잃지 않고 키 이름 변경을 할 수 있습니다.
