첫 파일 번역하기
원본 카탈로그를 만들고 독일어와 프랑스어 대상 파일을 내려받은 뒤, 이후 원본에 생긴 변경 사항도 번역합니다.
이 가이드에서는 영어로 된 JSON 파일 하나로 설정부터 번역, 결과 가져오기까지 차근차근 진행합니다. 과정을 마치면 디스크에 대상 언어 파일이 저장되고, 이후 수정 작업의 기준도 마련됩니다. 코딩 에이전트에게 설정을 맡기려면 코딩 에이전트로 설정하기를 참고하세요.
Node.js와 npm을 사용할 수 있는 작은 프로젝트 디렉터리를 준비하세요. Lingo.dev 계정과 활성화된 로컬라이제이션 엔진으로 번역할 수 있는 권한도 필요합니다. 계정의 남은 사용 한도도 작업에 충분해야 합니다.
설치 및 로그인 #
npm install --global @lingo.dev/cli
lingo --version
lingo login로그인을 시작하면 브라우저가 열립니다. 비대화형 실행 환경에서는 대신 해당 환경의 비밀 정보 저장소를 통해 LINGO_API_KEY을 제공하세요. 환경 변수에 설정된 키는 저장된 로그인 정보보다 우선합니다. 다른 사용자로 로그인하기 전에 의도치 않게 우선 적용되는 키가 있다면 제거하세요.
원본 만들기 #
locales 디렉터리를 만들고 다음 내용을 locales/en.json에 저장하세요.
{
"checkout": {
"title": "Review your order",
"submit": "Place order"
}
}프로젝트 루트에서 다음 명령을 실행하세요.
lingo init --source en --targets de,fr --files 'locales/en.json' --yes
lingo linkinit는 .lingo/config.json를 작성하고 AGENTS.md에 Lingo.dev 블록을 추가해, 코딩 에이전트가 CLI의 에이전트 가이드를 읽도록 안내합니다. 이 작업을 건너뛰려면 --no-agents-md를 전달하세요. link에서는 조직과 로컬라이제이션 엔진을 선택하거나, 권한이 있다면 새로 만들 수 있습니다. 로컬라이제이션 엔진은 모델과 언어 지침을 제공합니다. 엔진 식별자는 프로젝트 설정에 저장되고, 인증 정보는 별도로 보관됩니다.
계속하기 전에 설정 파일을 여세요. 원본 언어는 en, 대상 언어는 de 및 fr, 원본 파일은 locales/en.json로 지정되어 있어야 합니다. 조직과 로컬라이제이션 엔진 식별자도 확인하세요. 특히 복사하거나 포크한 프로젝트라면 꼭 확인하세요.
번역 및 결과 내려받기 #
lingo push --backfill-missing --wait누락 파일 보완은 아직 없는 대상 파일의 번역을 요청합니다. --wait은 작업이 완료될 때까지 기다린 뒤 결과를 내려받습니다. Lockfile 없이 처음으로 일반 푸시를 실행하면, 초기 번역을 요청하는 대신 원본을 저장합니다.
명령이 대기하는 동안에는 대상 파일을 변경하지 마세요. 이 방식으로 결과를 직접 내려받을 때는 별도의 풀 명령과 달리 로컬의 최신 편집 내용과 충돌하는지 비교하지 않습니다. 실행이 검토 대기 상태이거나 실패가 보고되면, 완료된 것으로 간주하기 전에 해당 상태를 확인하세요.
locales/de.json과 locales/fr.json를 여세요. checkout 키 두 개가 모두 그대로 있는지 확인하고 번역된 값을 읽어보세요. 대상 언어를 직접 평가하기 어렵다면 자격을 갖춘 검토자나 적절한 측정 결과를 활용하세요. 애플리케이션과 통합할 때는 해당 애플리케이션에서 평소 사용하는 리소스 로더로도 파일을 불러오세요.
원본 및 대상 파일의 변경 내역과 함께 .lingo/lock.json을 검토하세요. 검토를 마치고 수락한 파일, 설정, 기준 상태를 함께 커밋하세요. --wait 없이 실행했다면 나중에 같은 checkout과 같은 컴퓨터에서 lingo pull을 실행해 로컬에 기록된 가장 최근 실행 결과를 내려받으세요.
원본 업데이트 #
locales/en.json에서 값을 변경하거나 키를 추가한 뒤, 다음 명령을 실행하세요.
lingo push --wait일반 업데이트는 원본의 변경 사항을 저장된 기준 상태와 비교합니다. 누락 파일 보완은 없는 파일을 위한 기능이지, 이미 있는 대상 파일에 새 키를 추가하기 위한 기능이 아닙니다.
다른 리소스 유형이나 구조를 사용하려면 설정과 형식을 참고하세요. YAML과 Android XML은 형식을 명시적으로 선택해야 합니다. React 소스의 함수 호출에서 문자열을 추출하려면 React 빠른 시작으로 이어서 진행하세요. 이 JSON 예제 파일을 사용한다고 해당 형식이 선택되는 것은 아니므로, 설정에서 JSONC 카탈로그를 선택하세요.