CLI 버전 0의 키 제어와 수동 수정

레거시 카탈로그에서 원문에 따라 관리되는 값, 사람이 관리하는 번역, 일반 수정 사항을 명확히 구분하세요.

일반적인 수동 수정과 키 보존은 유지 기간이 다릅니다. 버전 0은 보통 원문이 바뀌지 않는 한 기존 번역 값을 유지합니다. 반면, 키를 보존하면 원문이 바뀌어도 사람이 해당 값을 계속 관리하도록 지정됩니다.

일반 번역 수정하기 #

번역 값을 직접 수정하고 확정한 문구를 커밋하세요. 원문이 그대로라면 일반적인 변경분 처리에서 해당 값을 유지할 수 있습니다. 원문 체크섬이 바뀌면 해당 키는 다시 번역 대상이 됩니다. 강제 실행 시에는 원문이 바뀌지 않아도 값이 교체될 수 있습니다.

원문이 바뀌면 의미를 다시 검토해야 하는 수정에는 이 방식을 사용하세요. 사람이 계속 관리해야 하는 콘텐츠라면 보존을 선택하고 원문 변경 사항을 검토할 절차를 마련하세요.

관리 주체를 명확히 지정하기 #

제어 기능레거시 출력 동작
lockedKeys원문 값을 복사합니다. 이 과정에서 수정한 번역 값을 덮어쓸 수 있습니다.
ignoredKeys선택한 콘텐츠를 번역과 출력에서 제외합니다.
preservedKeys누락된 값을 원문 값으로 채운 뒤, 사람이 관리할 수 있도록 번역 값을 유지합니다.
json
{
  "buckets": {
    "json": {
      "include": ["locales/[locale].json"],
      "lockedKeys": ["brand/name"],
      "ignoredKeys": ["internal/*"],
      "preservedKeys": ["legal/terms"]
    }
  }
}

이 예에서는 브랜드 이름이 그대로 유지되고, 내부 항목은 출력에서 빠지며, 법률 용어는 사람이 계속 관리합니다. 새로 보존한 원문 언어의 자리표시자는 출시 전에 번역해야 합니다. 애플리케이션에 무시된 키가 필요하다면 대체 값을 제공하거나 해당 키가 없어도 작동하도록 변경하세요.

문서에 없는 우선순위를 가정하지 말고 서로 겹치는 제어 패턴을 살펴보세요. 이러한 버전 0의 동작은 현재의 번역 값 보존 제어 기능과 다릅니다.

중첩 키와 리터럴 키 지정하기 #

레거시 경로는 슬래시로 계층을 탐색합니다. brand/name은 brand 안의 name을 선택하고, modules/ai.translation은 modules 안에서 이름에 점이 포함된 리터럴 키를 선택합니다. 와일드카드는 레거시 일치 규칙을 따르므로 의도한 깊이에서 테스트해야 합니다. 현재의 점·대괄호 구문과는 바꿔 쓸 수 없습니다.

이름 변경 시 재사용하기 #

기존 변경분 처리 방식은 동일한 처리 경로 맥락에서 새 키의 원문 값 해시와 삭제된 키의 이전 해시를 대조해 일치 여부를 확인할 수 있습니다. 텍스트가 그대로라면 새로 번역하지 않고 기존 번역 값을 이름이 바뀐 키로 옮길 수 있습니다.

키와 원문을 모두 바꾸면 새 작업이 필요합니다. 서로 독립적인 경로 사이로 옮기거나 동일한 문자열을 반복해서 사용할 때는 확인이 필요합니다. 이 일치 기능은 제약 없이 활용할 수 있는 번역 메모리가 아닙니다. 현재의 제이슨 식별 체계는 경로를 기반으로 하며 이 동작을 이어받지 않습니다.

의도적으로 교체하려면 재번역을, 문맥을 안내하려면 번역자 메모를 사용하세요. 다만 어느 쪽도 출력 값의 관리 주체를 정하는 일을 대신할 수는 없습니다.