|Labs
데모 예약플랫폼
React (Lingo Compiler)
알파
React (MCP)React (i18n)레거시 CLI (v0)
사용 중단

Lingo.dev CLI

  • 작동 방식
  • 설정
  • 빠른 시작
  • 모노레포

구성

  • 지원 형식
  • i18n.json
  • i18n.lock
  • 지원 로캘

기능

  • 기존 번역 활용
  • 언어 추가
  • 오버라이드
  • 번역자 노트
  • 번역 키
  • 키 이름 변경
  • 키 잠금
  • 키 무시
  • 키 보존
  • AI로 키 추출

성능

  • 대규모 프로젝트
  • 병렬 처리
  • 비용 예상

재번역

  • 자동 재번역
  • 재번역
  • 번역 제거

이 문서는 레거시 CLI (v0)를 다루며 현재는 사용 중단되었습니다. 현재 CLI는 v1입니다. 현재 CLI 문서 보기

오버라이드

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은 콘텐츠와 키 지문을 모두 추적하므로, 번역 작업을 잃지 않고 키 이름 변경을 할 수 있습니다.

다음 단계#

키 이름 변경
번역을 잃지 않고 키 이름 바꾸기
재번역
필요할 때 다시 번역 실행하기
i18n.lock
lockfile이 상태를 추적하는 방식
기존 번역
기존 번역 파일과 연동하기

이 페이지가 도움이 되었나요?

Max PrilutskiyMax Prilutskiy·업데이트됨 5일 전·1 min read