|
문서
데모 예약플랫폼
플랫폼MCPCLI
API워크플로
가이드변경 로그

개요

  • @lingo.dev/cli

시작하기

  • 빠른 시작
  • 구성

레퍼런스

  • lingo push
  • lingo pull
  • 기타 명령어
  • lingo purge

구성

  • 키 제어
  • 형식
  • 로캘

가이드

  • 로캘 추가하기
  • 기존 번역 활용하기
  • 재번역
  • 번역자 노트
  • 실행, 상태, 그리고 복구
  • CI/CD
  • 모노레포
  • 대규모 프로젝트

이전 CLI (v0)를 찾고 계신가요? 레거시 CLI 문서 보기

로캘 추가하기

언어를 추가하는 과정은 두 단계입니다. 먼저 대상 언어로 등록한 뒤, 백필을 실행합니다.

1. 설정에 로캘 추가하기#

.lingo/config.json의 targetLocales를 수정하세요:

json
{
  "sourceLocale": "en",
  "targetLocales": ["de", "fr", "es", "ja"]
}

여기서 새로 추가된 항목은 ja입니다. BCP 47 코드라면 무엇이든 사용할 수 있습니다.

2. 새 로캘 백필하기#

bash
lingo push --backfill-missing

--backfill-missing는 아직 존재하지 않는 모든 대상 항목을, 설정된 모든 패턴에 걸쳐 번역합니다. 기존 de, fr, es 파일은 이미 있으므로 건너뛰고, 새 ja 파일만 생성됩니다.

text
✓ Run lfr_a8c...: localized 14 target file(s), 0 already up-to-date.

왜 일반 push로는 안 되나요?

기본 lingo push는 마지막 실행 이후 해시가 바뀐 소스만 확인합니다. 로캘을 추가해도 소스 자체는 바뀌지 않기 때문에, 일반 push를 실행해도 처리할 항목이 없습니다. 반면 --backfill-missing는 누락된 대상 파일을 기준으로 동작하므로, 새 로캘을 추가할 때 딱 맞습니다.

먼저 비용 추정하기#

비용을 쓰기 전에 로캘 추가 비용을 미리 확인하려면:

bash
lingo push --backfill-missing --estimate

예상 비용을 출력한 뒤 번역은 수행하지 않고 종료합니다. 재번역에서 --estimate와 --force에 대해 더 자세히 알아보세요.

로캘 제거하기#

targetLocales에서 해당 항목을 제거한 다음, 관련 파일을 삭제하세요:

bash
lingo purge --locale ja

정리를 참고하세요.

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

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