CLI 0 버전 레퍼런스

승인된 번역과 원문 기준 상태를 보존하며 기존에 설치된 i18n.json 프로젝트를 유지 관리하세요.

이 설명서는 이전 버전의 lingo.dev 패키지와 해당 패키지의 i18n.json/i18n.lock 워크플로를 다룹니다. 예제는 0.138.10를 기준으로 합니다. 마이그레이션을 계획하는 동안에는 기존 프로젝트의 Lockfile에 기록된 버전을 유지하세요. 언제든 바뀔 수 있는 최신 버전을 설치하는 방식으로는 복구 과정을 재현할 수 없습니다.

새 프로젝트라면 현재 CLI로 시작하세요. 현재 버전의 서버 측 푸시/풀 워크플로는 상태와 선택 규칙이 다릅니다.

설치된 0 버전의 실행 방식 #

버킷 설정에 따라 파서를 선택하고 원본 파일과 대상 파일을 찾으며, 필요한 경우 [locale]를 확장합니다. 파서는 콘텐츠를 추출하고 번역 불가로 인식한 값을 분리합니다. 차이 분석 과정에서는 원문 값, 기존 번역문, 이전 원문 체크섬을 비교해 새로 추가되거나 변경되거나 삭제되거나 이름이 바뀐 항목을 찾습니다.

선택된 텍스트는 Lingo.dev 로컬라이제이션 엔진이나 직접 연결하도록 설정한 제공업체를 거칩니다. 반환된 번역은 대상 파일이나 공유 파일의 로캘별 섹션으로 재구성됩니다. 다른 작업이 실패하기 전에 일부 작업이 성공한 결과를 파일에 쓸 수 있으므로, 프로젝트 전체가 하나의 원자적 트랜잭션으로 처리되지는 않습니다.

기준 상태를 콘텐츠와 함께 보관하기 #

i18n.json, 승인된 로캘별 결과물, i18n.lock를 함께 커밋하세요. Lockfile은 원문 상태를 기록하며, 번역문의 모든 수정 사항이나 언어별 승인 내역까지 기록하지는 않습니다. 일반 실행은 원문 체크섬을 갱신하지만, 대상 로캘이나 키로 범위를 한정한 실행은 기존 기준 상태를 갱신하지 않고 결과물을 쓸 수 있습니다.

Lockfile 레퍼런스에서는 범위를 한정해 실행한 뒤 일반 작업을 수행하면 원문 변경 사항을 다시 처리할 수 있는 이유를 설명합니다. 기존 번역에서는 현재 값을 모두 교체하지 않고 기존 번역을 도입하는 방법을 다룹니다.

다음 작업 찾기 #

첫 파일 처리 절차에 따라 이전 버전의 소규모 실행을 재현하세요. 설정과 형식에서는 설치된 구버전이 무엇을 읽고 쓰는지 확인할 수 있습니다.

작업을 이어갈 때는 로캘에서 대상 로캘을 추가하는 방법을, 키 제어에서 일반 수정 사항과 사람이 관리하는 값을 구분하는 방법을, 재번역에서 의도적으로 갱신할 범위를 지정하는 방법을 확인하세요. 모노레포와 병렬 처리에서는 작업자 수를 늘려도 제공업체의 제한이 사라지는 것은 아니라는 점을 전제로 관리 책임과 처리량을 다룹니다.