애플 복수형 문자열 사전

속성 목록의 제어 필드와 형식 선택 구조는 그대로 유지하면서 지원되는 복수형 리소스 문자열을 번역합니다.

애플 복수형 리소스에는 독자에게 표시되는 텍스트와 올바른 형태를 선택하는 지침이 함께 들어 있습니다. xcode-stringsdict 파일 처리기는 속성 목록에서 지원되는 문자열 슬롯을 번역하고, 애플 서식 지정기가 사용하는 제어 값은 그대로 보존합니다.

텍스트 슬롯과 제어 키 #

다음 코드 조각은 개수에 따라 달라지는 메시지를 정의합니다.

xml
<plist version="1.0">
<dict>
  <key>items</key>
  <dict>
    <key>NSStringLocalizedFormatKey</key>
    <string>%#@count@</string>
    <key>count</key>
    <dict>
      <key>NSStringFormatSpecTypeKey</key>
      <string>NSStringPluralRuleType</string>
      <key>NSStringFormatValueTypeKey</key>
      <string>d</string>
      <key>one</key><string>%d item</string>
      <key>other</key><string>%d items</string>
    </dict>
  </dict>
</dict>
</plist>

NSStringFormatSpecTypeKey 및 NSStringFormatValueTypeKey에는 제어 데이터가 들어 있어 번역 대상에서 제외됩니다. NSStringLocalizedFormatKey을 비롯해 지원되는 다른 <string> 값은 텍스트 슬롯으로 처리됩니다. 번역을 검토할 때는 %#@count@ 및 %d 같은 서식 지정 토큰을 변경하지 마세요.

슬롯은 딕셔너리와 배열 안의 속성 목록 키 경로를 기준으로 서로 연결됩니다. 비어 있는 <string/> 요소도 문자열 값으로 읽으며, 대체 값을 기록할 때 <string>...</string> 형태로 확장될 수 있습니다.

재구성과 복수형 #

속성 목록 구조는 현재 원본에서 가져옵니다. 이전 원본 값으로 변경 사항을 파악하고, 일치하는 기존 대상 슬롯에서 승인된 문구를 가져올 수 있습니다. 대체 시에는 인코딩된 텍스트를 원본에 삽입하며, 지원되는 구간을 둘러싼 헤더와 서식은 그대로 유지합니다.

처리기는 기존 복수형 선택 구조를 유지합니다. 대상 언어의 모든 복수형 범주를 자동으로 생성하거나 문구가 모든 수량에 적합한지 검증하지는 않습니다. one 및 other만 따로 살펴보지 말고, 해당 리소스를 사용하는 애플 서식 지정기로 복수형 리소스를 테스트하세요.

복수형 리소스 설정 및 테스트 #

CLI는 .stringsdict에서 xcode-stringsdict을 추론하며, 키 범위 지정 모드는 지원하지 않습니다. CLI 설정 또는 GitHub를 통해 파일을 선택하세요.

이러한 로캘별 리소스는 애플리케이션의 .lproj 디렉터리에 문자열 테이블과 함께 보관하세요. 속성 목록의 유효성을 검사하고, 서로 다른 형태가 선택되도록 수량을 바꿔 가며 앱에서 불러오세요. 문자열 카탈로그는 하나의 공유 파일에 여러 로캘을 담는 별도의 구조를 사용합니다.