키나 용어 하나를 안전하게 업데이트하기

선택한 부분만 다시 번역하고 주변 내용은 보존하세요. 의도한 대로 수정되었는지, 나머지 내용은 그대로인지 함께 확인하세요.

일부만 수정할 때는 두 가지를 충족해야 합니다. 선택한 내용은 더 나아지고, 관련 없는 확정된 내용은 그대로 유지되어야 합니다. 두 가지를 모두 확인할 수 있도록 기존 번역본과 해당 원문 리비전을 보관하세요.

수정할 키나 용어가 정해져 있다면 이 가이드를 활용하세요. 일반적인 원문 변경은 업데이트 중 보존을 참고하세요. 이미 제출한 작업은 추가로 요청하기 전에 복구 상태부터 확인하세요.

확정된 주변 내용도 함께 비교하기 #

예를 들어 카탈로그에 다음과 같은 내용이 있다고 가정해 보겠습니다.

json
{
  "account": {
    "invitation": "Approval is required before access is granted.",
    "support": "Contact support"
  }
}

account.invitation의 번역 문구만 수정해야 한다고 가정해 보세요. 그대로 유지할 확정 문구인 account.support까지 포함해 번역본과 원문 리비전을 저장하세요.

문구 수정 방법 선택하기 #

문구를 한 번만 원하는 대로 정확히 수정하려면 번역 값을 직접 편집하고 애플리케이션에서 확인한 뒤, 검토한 카탈로그를 커밋하세요. 해당 메시지의 원문이 바뀌지 않는 한, 일반적인 원문 업데이트에서도 이 수정 사항을 유지할 수 있습니다.

다시 생성하려면 먼저 다른 번역 결과를 얻는 데 필요한 정보를 제공하세요. 엔진의 용어집에 승인된 용어를 추가하거나, 규칙에서 반복 적용되는 지침을 수정하거나, 메시지의 JSONC 문맥을 더 명확히 작성하세요. 그런 다음 해당 키를 다시 생성하세요. 원문과 지침을 그대로 둔 채 다시 생성하면 같은 문구가 나올 수 있습니다.

의미를 기준으로 용어 선택 범위 정하기 #

메시지를 선택하기 전에 용어의 의미부터 정의하세요. 예를 들어 제품에서 ‘워크스페이스’는 공유 프로젝트 공간을 뜻하지만, 다른 구절에서는 물리적인 작업 공간을 뜻할 수 있습니다. 제품에서 의도한 의미와 팀이 승인한 번역 용어를 용어집에 기록한 다음, 그 의미로 쓰인 메시지만 선택하세요. 이 판단 기준은 용어의 경계에서 자세히 다룹니다.

CLI로 기존 번역 키 선택하기 #

locales/en/account.json에 있는 해당 JSON 원문을 사용하도록 설정한 프로젝트에서 다음을 실행하세요.

bash
lingo push "locales/en/account.json" --key "account.invitation" --wait

JSON에서는 --key 실행 시 원문이 바뀌지 않아도 선택한 단위를 다시 생성합니다. 설정된 로캘 가운데 번역 파일이 이미 있는 각 로캘의 해당 키를 갱신하고, 새 값을 기존 번역본에 병합합니다.

다시 생성하기 전에 기존 수정 사항을 저장하세요. 선택한 키에서는 이번 푸시로 저장된 번역본이 교체될 수 있습니다. 제출 후 번역본을 편집했는지 감지하려면 --wait를 생략하고, 결과를 가져오기 전에 lingo pull --dry-run를 확인하세요. 충돌 처리 방법은 풀의 로컬 편집 분류를 참고하세요.

push --wait로 결과를 가져오든 별도의 풀로 가져오든, 키를 다시 생성해도 전체 원문의 기준 상태는 바뀌지 않습니다. 따라서 아직 반영되지 않은 일반 원문 편집 사항은 이후 일반 푸시에서도 전달됩니다.

키 패턴은 정확한 키, 객체 접두사, 경로 구간 전체에 대응하는 * 와일드카드를 지원합니다. auth.login는 auth.login.title를 포함하면서도 auth.login_url와는 일치하지 않을 수 있습니다. 와일드카드는 따옴표로 감싸고, 원하는 패턴이 여러 개라면 --key를 반복해서 사용하세요.

JSONC, 타입스크립트, PHP도 동일하게 지정한 범위만 다시 생성합니다. YAML과 로캘 루트 YAML에서는 선택한 번역이 바뀌지 않고 유지될 수 있습니다. 원하는 대로 정확히 수정하려면 번역본을 직접 편집하거나, 전체 파일을 다시 생성하기 전에 확정된 번역본을 저장하세요. 형식별 동작과 키 표기법은 CLI 범위에서 확인할 수 있습니다.

용어의 영향을 받는 키나 파일 찾기 #

해당 용어가 의도한 의미로 쓰인 원문 메시지를 찾고 문맥을 살펴보세요. 위 명령에서 --key를 사용해 지원되는 키를 선택하세요. 전체 파일을 다시 생성해야 하는 형식이라면 확정된 번역본을 저장한 뒤 해당 원문 파일을 다시 생성하세요. 예를 들면 다음과 같습니다.

sh
lingo push 'docs/en/workspaces.md' --force --wait

설정에서 이미 선택한 원문 경로를 사용하세요. 그러면 설정된 대상 로캘에서 해당 파일의 번역이 교체됩니다. 용어 주변의 텍스트까지 포함해 다시 작성된 메시지나 파일 전체를 비교하세요.

변경 사항, 보존 여부, 실제 사용 확인하기 #

변경된 각 번역 경로를 저장해 둔 버전과 비교하세요. 이 예시에서 초대 메시지는 접근하려면 먼저 승인이 필요하다는 조건을 유지해야 하고, 지원 메시지는 확정된 기준 상태와 일치해야 합니다. 주변 내용이 빠지거나 예상치 못하게 바뀌었다면 확정하기 전에 범위와 기준 상태를 점검하세요.

변수와 키 제어 기능을 확인하세요. 잠금은 원문을 복사하고, 보존은 번역 값을 유지하며, 무시는 해당 기능을 지원하는 형식의 출력에서 내용을 제외합니다.

출력물을 실제 사용하는 실행 환경에서 불러오세요. 문서라면 변경된 구절과 링크, 구성 요소를 확인하세요. 로컬 편집 사항을 교체하기 전에 풀 충돌을 해결한 뒤, 확정된 번역본을 해당 원문 리비전 및 Lockfile과 함께 커밋하세요.