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

Lingo.dev CLI

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

구성

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

기능

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

성능

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

재번역

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

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

언어 추가

i18n.json의 targets 배열을 업데이트한 뒤 CLI를 실행하면 새 대상 언어를 추가할 수 있습니다. 새 로캘에는 전체 번역 파일이 생성되고, 기존 번역은 그대로 유지됩니다.

언어 추가#

i18n.json 설정을 업데이트하세요:

json
{
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de"]
  }
}

CLI를 실행하세요:

bash
npx lingo.dev@latest run

CLI는 새 로캘마다 전체 번역 파일을 생성합니다:

text
locales/
  en.json    (source - unchanged)
  es.json    (existing - unchanged)
  fr.json    (existing - unchanged)
  de.json    (new - fully translated)

기존 언어와 새 언어의 차이#

CLI는 기존 언어와 새 언어를 서로 다르게 처리합니다:

기존 언어새 언어
동작누락된 키만 번역전체 파일을 처음부터 생성
기존 콘텐츠유지됨해당 없음

지역별 변형#

CLI는 BCP 47 태그를 사용하는 지역별 언어 변형을 지원합니다:

json
{
  "locale": {
    "source": "en-US",
    "targets": ["en-GB", "es-ES", "es-MX", "fr-FR", "fr-CA", "pt-BR", "pt-PT"]
  }
}

각 변형마다 해당 지역에 맞는 용어, 철자, 어조를 반영한 별도의 번역 파일이 생성됩니다.

선택적 생성#

모든 대상을 처리하지 않고 특정 언어에 대해서만 번역을 생성할 수 있습니다:

bash
npx lingo.dev@latest run --target-locale de

언어를 하나씩 추가하면서 품질을 검토한 뒤 점차 확대하고 싶을 때 유용합니다.

언어 제거#

targets 배열에서 로캘을 제거하면 CLI는 더 이상 해당 로캘을 처리하지 않습니다. 기존 파일은 삭제되지 않으므로 필요하면 직접 제거하세요.

다음 단계#

기존 번역
이미 번역이 있는 프로젝트와 통합하기
병렬 처리
여러 언어를 동시에 처리하기
대규모 프로젝트
로컬라이제이션을 확장하기 위한 전략
i18n.json
전체 구성 레퍼런스

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

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