|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는 원문이 바뀌지 않았더라도 번역을 새로 고칠 수 있도록 수동 재번역 옵션을 제공합니다. AI 모델을 변경했거나 번역 프롬프트를 업데이트했거나 로컬라이제이션 엔진 구성을 개선한 뒤에 유용합니다.

원문 변경으로 자동 트리거되는 재번역은 Automatic Retranslation을 참고하세요.

전체 재번역#

lockfile을 건너뛰고 모든 콘텐츠를 재번역합니다:

bash
npx lingo.dev@latest run --force

모든 대상 언어의 모든 키를 재번역하고 i18n.lock 파일도 다시 생성합니다.

선택적 재번역#

언어별#

bash
npx lingo.dev@latest run --force --target-locale es

다른 모든 언어는 그대로 두고 스페인어만 재번역합니다.

버킷 유형별#

bash
npx lingo.dev@latest run --force --bucket json

JSON 파일만 재번역하고 Markdown 및 기타 형식은 그대로 유지합니다.

키별#

bash
npx lingo.dev@latest run --force --key welcome.title

모든 대상 언어에서 단일 키만 재번역합니다. glob 패턴도 지원합니다.

파일별#

bash
npx lingo.dev@latest run --force --file blog.[locale].json

특정 파일만 재번역합니다. 여러 --file 플래그를 함께 조합해 사용할 수 있습니다.

조합#

bash
npx lingo.dev@latest run --force --bucket json --target-locale es

옵션을 조합하면 더 정밀하게 제어할 수 있습니다. 이 예시에서는 스페인어의 모든 JSON 콘텐츠만 재번역합니다.

purge를 활용한 효율적인 재번역#

최상의 성능을 위해 --force 대신 run 전에 purge를 사용하세요. 이렇게 하면 CLI에 내장된 캐싱 메커니즘을 활용할 수 있습니다:

bash
# Remove existing translations for a specific key
npx lingo.dev@latest purge --key welcome.title

# Then regenerate (without --force)
npx lingo.dev@latest run

재번역이 필요한 때#

상황권장 방식
원문이 변경된 경우자동 - 별도 작업 불필요
AI 모델을 변경한 경우run --force 또는 선택적 재번역
번역 프롬프트를 업데이트한 경우run --force 또는 선택적 재번역
엔진 구성을 개선한 경우영향받는 로캘만 선택적 재번역
특정 로캘의 품질이 낮은 경우run --force --target-locale <locale>

다음 단계#

Automatic Retranslation
원문 변경이 재번역을 트리거하는 방식
Remove Translations
다시 생성하기 전에 번역 삭제
i18n.lock
핑거프린팅으로 번역 상태를 추적하는 방법
Connect Your Engine
엔진을 구성해 번역 품질을 개선하는 방법

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

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