XLIFF

Atualize os destinos XLIFF suportados sem perder o texto de origem nem a identidade das unidades de tradução.

O XLIFF contém o texto de origem, o texto de destino e os identificadores que os associam. O processador de ficheiros xliff traduz o conteúdo de <source> para os valores de <target> em documentos XLIFF 1.2 e 2.x. Suporta texto simples e códigos em linha, preservando o texto de origem e os identificadores das unidades para importação para o seu sistema de tradução.

Estruturas de unidades suportadas #

O texto de origem desta unidade XLIFF 1.2 está em texto simples:

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 processador lê as entradas trans-unit, incluindo as que se encontram em grupos aninhados. Nas versões 2.x, lê cada unit e as respetivas entradas segment. Numa unidade com vários segmentos, cada segmento é traduzido separadamente.

Os códigos em linha emparelhados, como <g> e <pc>, mantêm a sua estrutura enquanto o respetivo texto é traduzido. Os códigos autónomos, como <ph>, permanecem protegidos. Mantenha os identificadores das unidades e dos códigos em linha estáveis e únicos: os IDs de unidade repetidos dependem da ordem de ocorrência e os vários segmentos de uma unidade são associados pela posição. translate="no" exclui uma unidade ou um grupo da tradução.

Destinos e metadados de idioma #

O texto de origem atual define o documento. As unidades inalteradas podem manter o conteúdo de destino existente, desde que não esteja vazio e que o texto de origem e os códigos em linha continuem a corresponder. Os destinos em falta ou vazios precisam de tradução. O processador cria elementos <target> para as unidades traduzidas que ainda não os tenham.

Ao gerar XLIFF 1.2, o processador define o target-language de cada ficheiro; nas versões 2.x, define o trgLang do elemento raiz. A serialização XML pode normalizar a formatação. Um <target> substituído é escrito como um novo elemento, pelo que deve verificar não só o texto, mas também os atributos específicos do importador e o estado de revisão.

Configurar e importar o resultado #

A CLI infere xliff a partir de .xlf e .xliff. Selecione os ficheiros através da configuração da CLI ou do GitHub.

Valide o resultado com o importador que pretende utilizar. Compare o texto de origem, os metadados do idioma de destino, os códigos em linha e a cobertura dos segmentos. Verifique os identificadores repetidos e as unidades deliberadamente excluídas da tradução. Em seguida, faça a revisão do texto de destino importado.