lingo push
원본 변경 사항을 제출하고, 누락된 대상 파일을 채우거나, 선택한 번역을 필요에 따라 새로 생성하세요.
첫 파일 설정을 마친 뒤에는 일반적인 원본 수정에 lingo push --wait를 사용하세요. CLI는 원본 바이트를 기준 상태와 비교해 변경된 부분의 작업을 요청하고, 완료된 대상 파일을 다운로드합니다. 바이트가 완전히 동일한 원본은 건너뜁니다.
다른 모드는 각각 용도가 다릅니다. 모든 푸시를 전체 번역으로 생각하지 말고, 무엇을 변경할지에 따라 모드를 선택하세요.
작업 선택 #
| 호출 방식 | 동작 |
|---|---|
| 유효한 기준 상태가 없는 일반 푸시 | 원본 바이트를 저장하며, 최초 번역은 자동으로 요청하지 않습니다. |
| 기준 상태가 있는 일반 푸시 | 원본 변경 사항을 증분 방식으로 번역합니다. |
lingo push 'locales/en.json' | 일반적인 이전 원본과의 차이 비교 없이 지정된 범위의 작업을 계획합니다. 기존 대상 파일을 채택할 수도 있습니다. |
lingo push --backfill-missing | 설정된 원본 전체에서 누락된 대상 파일을 생성합니다. |
--force를 사용한 범위 지정 푸시 | 기존 대상의 맥락을 유지하지 않고, 선택한 별도 파일 형식의 대상을 다시 생성합니다. |
--key를 사용한 푸시 | 기존 대상에서 고정 키 단위를 선택합니다. 변경되지 않은 값의 재사용 여부는 형식에 따라 달라집니다. |
백필은 이미 있는 일반 대상 파일에 새 키나 변경된 키를 추가하지 않습니다. 기준 상태 이후에 원본이 변경되었다면 경고를 표시합니다. 기존 언어를 최신 상태로 유지하려면 백필 전에 일반 푸시로 이러한 업데이트를 마치세요. 설정된 로캘 중 일부만 다루는 문서는 기존 원본 기준 상태를 유지하므로, 나중에 일반 푸시로 나머지 로캘에 남아 있는 수정 사항을 처리할 수 있습니다. 공유 엑스시스트링 카탈로그는 로캘별 계획을 사용합니다. 위치 인수 패턴은 임의의 파일을 허용하지 않고, 설정된 파일 중 패턴과 일치하는 파일만 선택합니다.
옵션 #
| 옵션 | 효과 |
|---|---|
| 위치 인수 패턴 | 설정된 파일을 선택합니다. 셸 와일드카드는 따옴표로 감싸세요. |
--force, -f | 파일 전체의 번역을 교체합니다. 파일 패턴을 명시적으로 지정하거나 백필을 사용하세요. |
--backfill-missing | 누락된 대상 파일을 처음 생성합니다. |
--key <pattern> | 고정 단위를 선택합니다. 반복 지정할 수 있습니다. |
--yes, -y | 강제 실행 확인을 건너뜁니다. |
--wait, -w | 제출 후 바로 반환하지 않고, 완료될 때까지 기다린 뒤 다운로드합니다. |
--estimate | 번역하거나 작업을 생성하지 않고 작업 범위와 비용을 산정합니다. |
--with <stage> | 이번 푸시에서만 단계를 실행합니다. 여러 번 지정할 수 있습니다. |
--without <stage> | 이번 푸시에서만 단계를 건너뜁니다. 여러 번 지정할 수 있습니다. |
--review-*, --content-length | 이번 푸시에서만 단계 설정을 조정합니다. |
불리언 플래그의 기본값은 거짓입니다. 대상은 설정에서 가져오며, 푸시에는 로캘 플래그가 없습니다. 파일 전체를 강제 실행할 때는 자동 동의, 키 범위 지정 또는 견적 옵션으로 확인을 생략하지 않는 한 확인 메시지가 표시됩니다. 위치 인수 패턴이 없으면 --force는 설정된 모든 원본 파일과 대상 로캘을 선택합니다. 넓은 범위를 교체하기 전에는 파일 패턴을 명시적으로 지정하고 --estimate로 범위를 확인하세요. 강제 실행은 별도 파일 형식에서 현재 대상의 맥락을 지우므로, 대상을 수동으로 수정한 내용까지 덮어쓸 수 있습니다. 엑스시스트링 카탈로그와 CSV 테이블은 공유 원본 파일에 포함된 번역을 계속 재사용할 수 있습니다.
선택한 키 새로 생성 #
저장된 지침은 바뀌었지만 원문은 그대로이거나, 특정 부분만 다시 번역해야 한다면 키 새로 생성을 사용하세요:
lingo push 'locales/en.json' --key 'checkout.title' --key 'checkout.submit' --wait키는 점과 대괄호로 표현하는 경로입니다. 객체를 선택하면 그 아래의 모든 문자열이 포함됩니다. auth.login에는 auth.login.title가 포함되지만 auth.login_url는 포함되지 않습니다. *는 경로의 한 구간 전체를 뜻합니다. 이전 CLI에서 사용하던 auth/login 같은 슬래시 형식도 사용할 수 있습니다. JSON, JSONC, 타입스크립트, PHP는 원본이 변경되지 않아도 선택한 문자열을 다시 생성합니다. YAML과 루트 키 YAML은 키 선택을 지원하지만, 원본이 저장된 기준 상태와 일치하면 현재 대상 값을 재사용할 수 있습니다. YAML의 표현을 고치려면 대상을 직접 편집하세요. 지침 변경 후 더 넓은 범위를 다시 생성하려면 채택한 대상을 저장하고, --key 없이 파일 전체에 --force를 사용하세요.
누락된 대상 로캘과 고정 키가 없는 형식은 메시지를 표시한 뒤 건너뜁니다. 그 밖의 형식은 오류를 표시하고 푸시를 중단합니다. 누락된 대상은 별도로 먼저 생성하세요. --key에 --force를 추가해도 키 범위의 작업 계획은 달라지지 않으며, YAML의 기존 값 재사용도 막지 않습니다.
키 범위를 지정한 푸시는 push --wait로 결과를 가져오든 나중에 pull로 가져오든 전체 원본의 기준 상태를 변경하지 않습니다. 따라서 아직 처리하지 않은 일반 원본 수정 사항은 다음 일반 푸시에서 처리됩니다. 형식별 지원 표와 키 문법은 범위에서 설명합니다.
넓은 범위 교체 전 견적 확인 #
lingo push 'locales/en.json' --force --estimate견적은 번역하거나 작업을 생성하지 않고 정확한 변경분을 계획합니다. 이 계획에 필요한 파일 중 서버에 없는 파일을 업로드하므로, 오프라인 모의 실행이 아니라 실제 서비스 호출입니다. 저장된 풀 포인터나 완료된 기준 상태를 대체하지는 않습니다. 첫 푸시는 원본만 저장하므로, 견적을 실행하면 산정할 항목이 없다고 알리고 lingo push --estimate --backfill-missing를 안내합니다.
출력에는 계획된 비용, 생성할 번역과 재사용할 번역, 출력 토큰 수, 로캘별 행이 표시됩니다. 후속 수정 시 발생할 수 있는 조건부 비용과 사용 중인 인공지능 제공업체가 직접 청구하는 비용은 별도 줄에 표시되며, 계획된 총비용에서 제외됩니다. 이어지는 경고에는 견적에서 제외된 항목이 명시됩니다. ~로 표시된 금액은 근삿값입니다. 이는 계획에 대한 수치이지, 측정된 사용량이나 확정 견적이 아닙니다. 푸시 규모가 너무 커서 견적을 산정할 수 없으면 서버가 제공하는 사유와 함께 실패합니다. 일부만 산정하려면 파일 패턴을 전달하세요.
이번 푸시에만 적용할 단계 변경 #
lingo push 'locales/en.json' --force --wait --with human-review --review-level strict --review-timeout 12 --without pre-edit단계 플래그는 이번 푸시에 한해 엔진의 파이프라인을 변경합니다. 따라서 엔진을 수정하거나 다시 만들지 않고도 구성을 시험해 볼 수 있습니다. 플래그로 지정하지 않은 모든 설정은 휴먼 리뷰 풀을 포함해 엔진의 설정을 따릅니다.
--with 및 --without에는 pre-edit, rephrase, human-review, post-edit, content-length 또는 back-translation을 지정할 수 있습니다. 번역은 항상 실행됩니다. --without는 건너뛴 단계가 필요한 다른 단계도 함께 건너뜁니다. --without human-review은 AI 평가와 후편집을 건너뜁니다.
| 설정 | 값 |
|---|---|
--review-level | everything은 모든 단위를 검토자에게 보냅니다. strict, medium 또는 lax는 AI 평가에서 해당 심각도로 표시된 단위만 보냅니다. |
--review-pool <name> | 검토 시 엔진의 풀 대신 이 풀을 사용합니다. |
--review-languages <locales> | --review-pool 풀이 검토할 로캘을 쉼표로 구분해 지정합니다. 기본값은 모든 로캘입니다. |
--review-timeout <hours> | 검토자에게 주어지는 시간을 시간 단위로 지정합니다. |
--content-length <rule> | source, match:<percent> 또는 max:<columns>. |
설정은 단계를 조정할 뿐 활성화하지는 않으므로, 해당 단계가 실행되지 않으면 푸시가 실패합니다. --with human-review 또는 --with content-length를 추가하세요. 검토 풀이 없는 엔진에서 --with human-review을 사용하려면 --review-pool가 필요합니다. 요금제에 포함되지 않은 단계를 요청하면 해당 단계를 건너뛰는 대신 푸시가 실패합니다. 이 푸시도 다른 푸시와 마찬가지로 결과를 기록합니다. 변경되지 않은 단위도 다시 번역하려면 --force 또는 --key을 추가하고, 구성에 따른 비용을 먼저 확인하려면 --estimate을 추가하세요. 재시도할 때는 동일한 단계 플래그를 다시 지정해야 합니다.
새 언어를 추가하려면 먼저 기존 대상에 대한 일반 원본 업데이트를 마치세요. 그런 다음 해당 언어를 targetLocales에 추가하고 lingo push --backfill-missing --estimate를 확인한 뒤, 원본 리비전을 바꾸지 않은 채 백필을 요청하세요. 언어 추가에서는 이 순서부터 애플리케이션 점검까지 안내합니다. 로캘을 제거하면 이후 선택 대상에서 제외되지만 파일은 삭제되지 않습니다. 공유 엑스시스트링 카탈로그에는 로캘 완전 삭제를 사용하지 마세요.
결과 수집 및 복구 #
대기 옵션을 사용하지 않는다면 풀로 결과를 가져올 때까지 checkout과 해당 기기의 로컬 포인터를 유지하세요. 다른 푸시가 이 포인터를 대체할 수 있습니다. 대기 옵션을 사용한다면 실패하거나 일부 실패한 결과와 실제로 다운로드된 파일을 확인하세요. 미완료 대상이 모두 사람이 하는 검토를 기다리는 상태가 되면 대기가 중단됩니다. 검토자가 검토를 마친 뒤 풀을 실행하세요. 대기 중에 결과를 직접 수집할 때는 대상을 편집하지 마세요. 이 방식은 풀과 달리 최신 로컬 수정 사항을 비교하지 않습니다.
실패한 작업을 다시 시도하려면 원인을 해결하고 실패한 실행 복구 절차를 따르세요. 상태를 유지한 채 해당 푸시를 다시 실행하고, 출력된 작업 식별자를 확인한 뒤 결과물을 점검하세요. 이전 푸시의 결과를 아직 수집하지 않았고 요청도 바뀌지 않았다면, 푸시는 요청을 중복 생성하지 않고 기존 요청을 재사용합니다. 실행 중인 작업에는 다시 연결하고, 완료된 작업은 결과를 수집하며, 실패한 작업은 새 작업으로 교체합니다.