CLI 버전 0 Lockfile

레거시 원문 기준 상태로 보류 중인 변경 사항을 파악하고, 미완료 번역을 숨기지 않고 복구하세요.

i18n.lock 파일을 통해 버전 0은 변경되지 않은 원문과 번역이 필요한 텍스트를 구분합니다. 이 파일은 해당 원문 및 승인된 번역문과 함께 보관하세요. 사람이 번역문을 수정한 내역을 모두 기록하거나 번역의 정확성을 보증하는 파일은 아닙니다.

파일에 기록되는 내용 #

lingo.dev@0.138.10에서 이 파일은 version: 1 및 checksums 매핑을 포함하는 YAML 형식입니다. 각 최상위 섹션은 처리된 경로 패턴을 해시한 값으로 구분되며, 섹션 내 항목은 원문 키를 MD5 기반 원문 값 체크섬에 연결합니다. 이 항목들은 직접 작성하지 말고 CLI에서 관리하도록 하세요.

체크섬이 변경되면 현재 존재하는 키가 번역 대상이 됩니다. 원문 값의 해시가 일치하면 동일한 처리 맥락에서 새 키를 삭제된 키와 연결해, 이름이 바뀐 키의 번역을 재사용할 수도 있습니다. 어느 방식도 파일 간에 제한 없이 활용할 수 있는 번역 메모리는 아닙니다.

번역과 기준 상태 교체 구분하기 #

작업동작
lingo run계산된 변경분을 번역하고 원문 상태를 갱신합니다.
lingo run --force일반적인 변경분 계산에 의존하지 않고 선택한 출력을 다시 생성합니다.
lingo lockfile이미 내용이 있는 섹션은 그대로 두고 누락된 원문 상태 섹션을 추가합니다.
lingo lockfile --force대상 텍스트를 번역하지 않고 현재 파일을 기준으로 원문 체크섬을 교체합니다.
lingo run --frozen번역 없이 동기화 여부를 확인하되, 기준 상태가 없으면 먼저 초기화합니다.

프랑스어 번역문이 승인된 뒤 영어 원문이 변경되었다고 가정해 보세요. lockfile --force 명령으로 체크섬을 교체하면 프랑스어 번역문이 여전히 이전 의미를 담고 있더라도 새 영어 원문이 기준 상태로 기록됩니다. 따라서 동기화에 실패할 때마다 재구성으로 해결하려 해서는 안 됩니다.

대상 로캘이나 키로 범위를 제한해 실행하면 기존 공유 원문 기준 상태를 갱신하지 않은 채 번역문을 기록할 수 있습니다. 이후 일반 실행에서 같은 원문 변경을 다시 처리하면서 범위 제한 실행 후에 수정한 내용을 덮어쓸 수 있습니다. 공유 기준 상태를 갱신하기 전에 관련 로캘 출력을 꼼꼼히 대조하고 조정하세요.

여러 로캘에 걸친 원문 변경을 확정할 때는 다음과 같이 진행하세요.

  1. 영향을 받는 출력 중 하나라도 미완료 상태라면 원문 리비전을 고정하고 i18n.lock 파일을 보존하세요. 일반적인 프로젝트 전체 업데이트에는 lingo run 명령을 사용하고, 출력별로 작업과 검토를 따로 진행해야 한다면 문서에 안내된 범위 제한 실행을 사용하세요.
  2. 원문 체크섬 교체가 적용되는 모든 로캘 출력을 확인하세요. 가장 최근의 범위 제한 실행에서 다루지 않은 출력도 포함해야 합니다. 실패한 작업을 해결하고, 승인된 수동 수정 사항도 해당 원문과 대조해 조정하세요. 최신 상태가 아니거나 확신할 수 없는 출력이 하나라도 있다면 공유 기준 상태 갱신을 보류하세요.
  3. 범위를 제한한 작업 후에도 기존 기준 상태가 그대로이고 체크섬 교체가 적용되는 모든 출력이 승인되었다면, 의도한 프로젝트 루트에서 lingo lockfile --force 명령을 실행하세요. 이 명령은 번역 없이 원문 체크섬을 교체합니다. 따라서 앞선 검토를 건너뛰는 용도로 사용하거나, 마지막으로 지정한 대상 로캘이 이 교체 범위까지 제한한다고 가정하지 마세요.
  4. Lockfile 변경 내역을 확인한 뒤, 정확한 원문 리비전과 그에 대응하는 승인된 모든 번역문, i18n.lock 파일을 함께 커밋하세요. 이후 lingo run --frozen 명령으로 확정된 기준 상태와의 동기화 여부를 확인할 수 있습니다. 다만 번역문이 최신 상태인지, 번역 품질이 적절한지까지 확인할 수는 없습니다.

i18n.lock 파일이 없으면 고정 모드도 엄밀히 말해 읽기 전용은 아닙니다. 먼저 체크섬을 초기화할 수 있으며, 대상 키가 존재한다는 사실만으로 번역문이 최신 상태임을 입증할 수는 없습니다. 고정 모드 검사 통과를 동기화의 증거로 받아들이기 전에 신뢰할 수 있는 원문과 번역문 쌍을 확보하세요.

누락되거나 충돌한 상태 복구하기 #

Lockfile 파일이 없다고 해서 버전 0이 기존 번역문을 모두 다시 생성하는 것은 아닙니다. 이전 체크섬이 없으면 기존 값을 유지할 수도 있습니다. 새로 생성된 기준 상태를 받아들이기 전에 확신할 수 없는 원문과 번역문 쌍을 확인하세요. 기존 번역을 채택하는 이 경우는 기존 번역에서 다룹니다.

병합 충돌이 발생하면 먼저 양쪽 브랜치의 원문과 번역문 변경 사항을 대조해 조정하세요. 가능하면 신뢰할 수 있는 Lockfile 파일을 복원하세요. 재구성이 불가피하다면 실제 원문과 번역문 쌍을 검토하세요. 재구성으로 기록되는 것은 원문 상태이지, 번역문이 최신 상태인지 여부가 아니기 때문입니다.

레거시 YAML 복구 절차는 중복 항목 중 마지막 항목을 유지하고 제거된 항목을 보고합니다. 이는 구문상 중복을 해결할 뿐, 어느 브랜치의 문구가 올바른지 판단해 주지는 않습니다. 복구된 파일을 승인된 출력과 함께 커밋하기 전에 충돌한 값들을 확인하세요.