CLI

프로젝트 파일을 번역하고 결과물을 가져오며, React 애플리케이션에서 사용하는 원본 카탈로그를 관리하세요.

Lingo.dev CLI는 프로젝트 파일을 로컬라이제이션 엔진에 연결합니다. 원본 경로와 대상 언어를 설정하고, 선택한 콘텐츠를 푸시한 뒤 번역된 파일을 가져오세요. 이후 실행부터는 기록된 원본 기준 상태를 바탕으로 변경 사항을 처리합니다.

@lingo.dev/cli는 lingo 실행 파일을 설치합니다. 설정부터 결과 가져오기까지 전체 절차는 첫 번째 파일 안내를 따라 진행하세요.

최신 @lingo.dev/cli를 설치하고 lingo --version로 프로젝트에서 사용하는 버전을 기록하세요. lingo.dev@0.138.10 및 해당 i18n.json 프로젝트는 CLI 버전 0 레퍼런스를 참고하세요.

작업 방식에 맞게 설치하기 #

버전 관리에 기록할 프로젝트 의존성으로 설치하려면:

sh
npm install --save-dev @lingo.dev/cli
npx lingo --help
npx lingo --version

셸 전역에서 사용할 실행 파일로 설치하려면:

sh
npm install --global @lingo.dev/cli
lingo --help

이 설명서에서는 lingo를 직접 실행합니다. 로컬에 설치했다면 패키지 관리자를 통해 실행하세요. npx @lingo.dev/cli@latest와 pnpm dlx @lingo.dev/cli@latest는 영구 설치 없이 최신 릴리스를 실행합니다. 로컬 환경과 CI 환경의 동작이 같아야 한다면 버전을 고정하세요. CI 예제에서는 Node.js 22를 사용합니다.

lingo update는 감지된 설치 방식을 따릅니다. 특정 버전을 지정해야 하거나 설치 방식을 인식하지 못하는 경우, 또는 임시 설치인 경우에는 패키지 관리자를 사용하세요.

파일 번역 또는 메시지 추출하기 #

기존 리소스는 파일을 설정하고 인증을 마친 뒤 로컬라이제이션 엔진에 연결하세요. 번역은 서버에서 실행됩니다. push --wait는 번역이 완료될 때까지 기다린 뒤 결과를 다운로드합니다. 별도의 push와 pull를 사용하면 나중에 결과를 가져올 수 있습니다.

React 소스의 호출 구문에는 추출을 사용해 로컬에서 JSONC와 TypeScript 선언을 생성할 수 있습니다. 번역을 수행하거나 런타임을 설치하지는 않습니다. 추출한 카탈로그를 파일 설정에 추가해 번역한 다음, React 카탈로그 워크플로를 통해 불러오세요.

업데이트에 필요한 상태 보존하기 #

처음 일반 푸시를 실행하면 원본 바이트가 저장됩니다. 백필은 누락된 대상 파일을 생성하고, 이후의 일반 푸시는 원본 변경 사항을 번역합니다. .lingo/config.json, .lingo/lock.json, 승인된 번역은 버전 관리에 함께 보관하세요. 인증 정보와 가장 최근 실행을 가리키는 포인터는 홈 디렉터리에 유지됩니다.

푸시, 풀, Lockfile 및 캐시에서는 모드와 복구 옵션을 설명합니다. 명령어에서는 설정, 번역, 카탈로그 유지 관리에 쓰이는 명령어를 확인할 수 있습니다.