번역 오버라이드

Lingo.dev CLI를 사용하면 대상 파일을 직접 편집하여 번역을 수동으로 오버라이드할 수 있습니다. 오버라이드된 사용자 지정 번역은 소스 콘텐츠가 변경되지 않는 한 이후 CLI 실행에서도 보존됩니다.

오버라이드 작동 방식

Lingo.dev CLI는 콘텐츠 핑거프린팅을 사용하여 변경 사항을 감지합니다. 대상 파일에서 번역을 수동으로 편집하면 소스 콘텐츠 핑거프린트가 변경되지 않기 때문에 CLI는 변경 사항을 보존합니다.

워크플로우 예시:

1. 초기 번역 — CLI가 스페인어 번역을 생성합니다:

// locales/en.json (소스)
{
  "greeting": "Welcome to our platform"
}

// locales/es.json (생성됨)
{
  "greeting": "Bienvenido a nuestra plataforma"
}

2. 수동 오버라이드 — 스페인어 번역을 편집합니다:

// locales/es.json (수동 편집됨)
{
  "greeting": "¡Bienvenido a nuestro espacio digital!"
}

3. 이후 CLI 실행 — 오버라이드가 보존됩니다:

npx lingo.dev@latest i18n

# 사용자 지정 스페인어 번역이 변경되지 않고 유지됩니다

4. 소스 변경이 재번역을 트리거함 — 영어 소스를 수정하는 경우:

// locales/en.json (소스 수정됨)
{
  "greeting": "Welcome to our new platform"
}

CLI는 소스 변경을 감지하고 재번역하여 오버라이드를 새로운 AI 생성 번역으로 대체합니다.

키 이름 변경 지원

Lingo.dev CLI는 키 이름을 변경해도 번역을 유지합니다. 락파일은 콘텐츠와 키 지문을 모두 추적하여 번역 작업을 잃지 않고도 원활한 키 리팩토링을 가능하게 합니다.

자세히 알아보기: 키 이름 변경