로캘 추가하기

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

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

정리를 참고하세요.