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:

xml
<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.