XLIFF
원문과 번역 단위 식별 정보를 유지하면서 지원되는 XLIFF 번역문을 업데이트합니다.
XLIFF에는 원문과 번역문, 둘을 연결하는 식별 정보가 담겨 있습니다. xliff 파일 핸들러는 XLIFF 1.2 및 2.x 문서의 <source> 내용을 번역해 <target> 값으로 저장합니다. 일반 텍스트와 인라인 코드를 지원하며, 번역 시스템으로 가져올 수 있도록 원문과 단위 식별자를 유지합니다.
지원하는 단위 구조 #
다음 XLIFF 1.2 단위의 원문은 일반 텍스트입니다.
<xliff version="1.2">
<file source-language="en" datatype="plaintext" original="checkout">
<body>
<trans-unit id="delivery">
<source>Choose delivery</source>
</trans-unit>
</body>
</file>
</xliff>XLIFF 1.2에서는 중첩된 그룹 안의 항목을 포함해 trans-unit 항목을 읽습니다. 2.x에서는 각 unit와 그 안의 segment 항목을 읽습니다. 한 단위에 세그먼트가 여러 개 있으면 세그먼트마다 별도의 번역 작업이 생성됩니다.
<g> 및 <pc>처럼 쌍을 이루는 인라인 코드는 텍스트가 번역되어도 구조가 유지됩니다. <ph> 같은 독립형 코드는 보호됩니다. 단위와 인라인 코드의 식별자는 고유한 값을 사용하고 변경하지 마세요. 중복된 단위 식별자는 등장 순서로 구분하며, 한 단위 안에 있는 여러 세그먼트는 위치를 기준으로 대응됩니다. translate="no"는 단위나 그룹을 번역에서 제외합니다.
번역문과 언어 메타데이터 #
현재 원문이 문서의 기준이 됩니다. 변경되지 않은 단위는 원문과 인라인 코드가 여전히 일치하면 비어 있지 않은 기존 번역문을 유지할 수 있습니다. 번역문이 없거나 비어 있으면 번역이 필요합니다. 핸들러는 번역된 단위에 <target> 요소가 없으면 새로 생성합니다.
XLIFF 1.2 출력에서는 각 파일의 target-language에, 2.x 출력에서는 루트의 trgLang에 값을 기록합니다. XML 직렬화 과정에서 레이아웃이 정규화될 수 있습니다. 교체된 <target>는 새 요소로 기록되므로, 번역 문구뿐 아니라 가져오기 도구별 속성과 검토 상태도 확인하세요.
설정 및 결과 가져오기 #
CLI는 .xlf 및 .xliff에서 xliff을 추론합니다. CLI 설정 또는 GitHub를 통해 파일을 선택하세요.
실제로 사용할 가져오기 도구로 결과를 검증하세요. 원문, 대상 언어 메타데이터, 인라인 코드, 세그먼트 포함 범위를 비교하세요. 중복된 식별 정보와 의도적으로 번역에서 제외한 단위를 확인한 뒤, 가져온 번역문을 검토하세요.