겟텍스트

메시지 문맥과 원문 식별 정보를 보존하고 복수형 재구성의 한계를 고려해 PO 대상 값을 번역합니다.

겟텍스트는 원문과 번역문을 같은 항목에 저장합니다. po 파일 처리기는 msgid을 읽어 번역문을 msgstr에 기록하고, 원문은 그대로 유지합니다. 또한 msgctxt을 사용해 서로 다른 상황에서 쓰이는 동일한 단어를 구분합니다.

문맥으로 메시지 구분하기 #

예를 들어, 다음 항목에서는 “뒤로”에 해당하는 원문을 각각 다르게 번역할 수 있습니다:

text
msgctxt "checkout navigation"
msgid "Back"
msgstr ""

msgctxt "product surface"
msgid "Back"
msgstr ""

이 항목들은 msgid이 같아도 별개의 단위로 처리됩니다. 문맥은 번역 힌트로도 제공됩니다. 주석과 플래그 줄은 항목과 함께 유지됩니다. 다만, 이 줄들이 보존된다고 해서 모든 주석이 지침으로 해석되거나 검토 플래그가 갱신된다는 뜻은 아닙니다.

이 전용 파서는 지원 범위에 해당하는 따옴표로 묶인 PO 필드와 이어지는 줄을 처리합니다. 입력에는 UTF-8을 사용하세요. 임의의 레거시 인코딩을 변환하지는 않습니다. .pot 자동 검색은 CLI의 .po 추론 규약에 포함되지 않습니다.

복수형 재구성의 한계 #

복수형 항목에서 msgid과 msgid_plural는 각각 단수형과 복수형의 별도 텍스트 단위가 됩니다. 처리기는 대상 슬롯을 최소 두 개 생성합니다. 기존 대상에 슬롯이 더 많으면 변경되지 않은 항목은 기존에 확정된 형태를 유지합니다. 처음 두 대상 형태 중 하나라도 바뀌면 추가 슬롯에는 개별적으로 생성된 형태가 아니라 새로운 복수형 값이 들어갑니다.

컴파일하기 전에 복수형 출력을 검토하세요. 서로 구별되는 여러 형태가 필요한 언어는 각 슬롯에 올바른 문구가 있어야 하며, 이에 맞는 Plural-Forms 헤더도 필요합니다. 기존 대상 헤더가 우선 사용됩니다. 첫 출력에서는 소스 헤더를 그대로 가져오되 Language를 대상 로캘로 변경합니다. 처리기는 대상 언어에 맞춰 Plural-Forms을 다시 작성하지 않습니다.

업데이트 및 직렬화 #

변경 사항은 이전 소스를 바탕으로 문맥, 메시지 식별 정보, 단수형·복수형 단위를 기준으로 식별합니다. 유지할 msgstr 값은 기존 대상 항목에서 가져옵니다. 소스 식별 정보가 바뀌면 기존에 확정된 번역 문구를 여전히 활용할 수 있더라도 새 메시지로 간주될 수 있습니다.

재구성 시 소스 필드, 주석 줄, 항목 주변의 배치는 유지하고 msgstr 값과 관련 헤더를 교체합니다. 따옴표로 묶인 번역 값은 서식이 달라질 수 있습니다. 파일 파싱뿐 아니라 메시지 수와 복수형 메타데이터도 검증하세요.

카탈로그 설정 및 컴파일 #

CLI는 .po에서 po을 추론합니다. CLI 설정 또는 GitHub를 통해 소스 카탈로그를 선택하세요.

애플리케이션의 겟텍스트 도구로 출력을 컴파일하거나 가져온 다음, 다양한 수량에 따른 복수형과 문맥별 조회를 테스트하세요. 파싱에 성공하더라도 반복되는 복수형 값과 헤더를 확인하세요. 이 값과 헤더가 애플리케이션에서 각 수량에 표시할 내용을 결정합니다.