빠른 시작 · Lingo.dev

CLI를 5분 안에 시작해 보세요.

사전 준비 사항

Node.js 18.0 이상이 설치되어 있는지 확인하세요. 확인하려면 node --version을 실행하세요.

설치#

선호하는 패키지 관리자로 CLI를 전역 설치하세요:

bash

npm install -g lingo.dev

설치 확인#

CLI가 올바르게 설치되었는지 확인하세요:

bash

lingo --version

다음과 비슷한 출력이 표시됩니다:

plaintext

lingo.dev v0.133.9
Node.js v20.10.0

프로젝트 초기화#

프로젝트 디렉터리로 이동한 뒤 다음을 실행하세요:

bash

cd my-project
lingo init

이 대화형 명령으로 다음 작업을 할 수 있습니다:

계정 연결 - API 키로 인증합니다
프로젝트 선택 - 기존 프로젝트를 선택하거나 새로 만듭니다
로캘 설정 - 지원할 언어를 선택합니다
파일 구조 설정 - 번역 파일을 저장할 위치를 선택합니다

구성 생성 완료

CLI가 설정이 담긴 i18n.json 파일을 생성합니다. 필요에 따라 나중에 수정할 수 있습니다.

첫 번역#

간단한 번역 파일을 만들어 보세요:

json

{
  "welcome": {
    "title": "Welcome to Lingo.dev",
    "subtitle": "The Localization Engineering Platform"
  },
  "auth": {
    "login": "Log in",
    "logout": "Log out"
  }
}

번역 실행#

설정된 모든 대상 언어로 콘텐츠를 번역하세요:

bash

lingo run

CLI가 다음 작업을 수행합니다:

✅ 소스 파일을 찾습니다
✅ lockfile을 기준으로 변경분(delta)을 계산합니다
✅ 변경된 콘텐츠를 번역 백엔드로 전송합니다
✅ 번역 결과를 디스크에 씁니다

감시 모드(개발)#

활발히 개발 중이라면 감시 모드를 활성화해 소스 파일이 변경될 때마다 자동으로 다시 번역되도록 하세요:

bash

lingo run --watch

감시 모드를 종료하려면 Ctrl+C를 누르세요.

도움 받기#

도움이 필요하신가요?

bash

# Show help for all commands
lingo --help

# Show help for a specific command
lingo run --help

실시간 지원이 필요하다면 Discord 커뮤니티에 참여하세요!

다음 단계#

JSON, YAML, Markdown 등