Lingo.dev CLI는 이미 번역 파일이 있는 프로젝트에도 바로 연동됩니다. 소스 키를 기존 대상 파일과 비교해 빠진 번역만 생성하고, 기존 작업은 그대로 유지합니다.
작동 방식#
부분적으로 번역된 프로젝트에서 CLI를 실행하면 누락된 항목을 분석합니다:
json
// locales/en.json (source - 4 keys)
{
"welcome": "Welcome to our app",
"button.save": "Save",
"button.cancel": "Cancel",
"error.network": "Network error"
}
// locales/es.json (existing - 2 keys translated)
{
"welcome": "Bienvenido a nuestra aplicación",
"button.save": "Guardar"
}npx lingo.dev@latest run을 실행하면 누락된 키만 채워집니다:
json
// locales/es.json (after run - all 4 keys present)
{
"welcome": "Bienvenido a nuestra aplicación",
"button.save": "Guardar",
"button.cancel": "Cancelar",
"error.network": "Error de red"
}기존 welcome 및 button.save 번역은 그대로 유지됩니다.
첫 실행#
처음 실행하면 CLI가 현재 상태를 기준으로 i18n.lock 파일을 생성합니다. 이 lockfile에는 모든 소스 콘텐츠의 fingerprint가 기록되며, 이후 실행에서는 기존 번역이 다시 생성되지 않도록 보장합니다. 처음에 다른 도구로 만든 번역도 예외는 아닙니다.
대상 언어 파일에 소스 언어 콘텐츠가 들어 있지 않은지 확인하세요. 대상 파일에 번역되지 않은 소스 텍스트가 포함되어 있으면 누락 항목을 감지하는 데 영향을 줄 수 있습니다.
다른 도구에서 마이그레이션#
CLI는 지원되는 형식(JSON, YAML, PO 등)만 따르면 어떤 도구로 만든 번역 파일과도 함께 사용할 수 있습니다:
1
i18n.json 설정
기존 파일 위치와 일치하는 버킷 패턴을 설정하세요.
2
번역 실행
CLI가 기존 번역은 유지한 채 누락된 키만 채워 넣습니다.
3
검토 후 커밋
빈 부분만 채워집니다. 기존 번역은 그대로 유지됩니다.
번역 새로 고침#
기존 번역의 품질이 아쉽다면, 필요한 항목만 골라 다시 번역할 수 있습니다:
bash
# Retranslate all Spanish content
npx lingo.dev@latest run --force --target-locale es
# Retranslate a specific key across all languages
npx lingo.dev@latest run --force --key error.network더 다양한 옵션은 Retranslation을 참고하세요.
