XLIFF
Atualize os destinos XLIFF compatíveis sem perder o texto de origem nem a identidade das unidades de tradução.
O XLIFF armazena o texto de origem, o texto de destino e os identificadores que os conectam. O manipulador de arquivos xliff traduz o conteúdo de <source> em valores de <target> em documentos XLIFF 1.2 e 2.x. Ele aceita texto simples e códigos inline, preservando o texto de origem e os identificadores das unidades para importação no seu sistema de tradução.
Estruturas de unidade compatíveis #
Esta unidade XLIFF 1.2 contém texto de origem sem formatação:
<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>No XLIFF 1.2, o manipulador lê as entradas trans-unit, inclusive as que estão em grupos aninhados. No 2.x, lê cada unit e suas entradas segment. Uma unidade com vários segmentos gera uma tarefa de tradução separada para cada segmento.
Códigos inline em pares, como <g> e <pc>, mantêm sua estrutura enquanto o texto é traduzido. Códigos independentes, como <ph>, permanecem protegidos. Mantenha os identificadores das unidades e dos códigos inline estáveis e exclusivos: IDs de unidade repetidos dependem da ordem de ocorrência, e os segmentos de uma mesma unidade são associados por posição. translate="no" exclui uma unidade ou um grupo da tradução.
Destinos e metadados de idioma #
O conteúdo de origem atual define o documento. Unidades inalteradas podem preservar o conteúdo de destino existente e não vazio, desde que o texto de origem e os códigos inline ainda correspondam. Destinos ausentes ou vazios precisam de tradução. O manipulador cria elementos <target> para as unidades traduzidas que ainda não têm esse elemento.
A saída XLIFF 1.2 define o target-language de cada arquivo; a saída 2.x define o trgLang do elemento raiz. A serialização XML pode normalizar a formatação. Um <target> substituído é gravado como um novo elemento. Por isso, além do texto, confira seus atributos específicos do importador e seu estado de revisão.
Configure e importe o resultado #
A CLI infere xliff a partir de .xlf e .xliff. Selecione os arquivos pela configuração da CLI ou pelo GitHub.
Valide o resultado com o importador que pretende usar. Compare o texto de origem, os metadados do idioma de destino, os códigos inline e a cobertura dos segmentos. Confira os identificadores repetidos e as unidades excluídas intencionalmente da tradução. Em seguida, revise o texto de destino importado.