.XLIFF - Formato di File di Intercambio di Localizzazione XML (Strings)

Contenuti tradotti automaticamente dall'inglese con Phrase Language AI.

Estensioni dei file	.xlf, .xliff
Estensione API	xlf
Importa	Sì
Esporta	Sì
Supporto forme plurali	Sì
Supporto descrizione	Sì
Opzioni di formato Queste opzioni possono essere specificate quando un file viene caricato e/o scaricato. A seconda del metodo di caricamento/scaricamento (API, CLI, sincronizzazione Repo, ecc.), possono essere specificate nei parametri di query `Carica`, `Scarica` o nel file di configurazione `phrase.yml`.	enclose_in_cdata include_translation_state indent_size indent_style ignore_source_translations ignore_target_translations export_key_id_as_resname export_key_name_hash_as_extradata override_file_language strip_placeholder_delimiters delimit_placeholders

Il formato di file più utilizzato nell'industria della traduzione. Può essere visto come lo specchio del file sorgente che scompone il contenuto sorgente in vari segmenti memorizzati in tag (ad es. <trans-unit>, <seg-source>).

XLIFF è basato su XML e soggetto a convenzioni XML di base come validità e ben formato. Esegui sempre un controllo di sanità prima della traduzione cambiando l'estensione del file da .xliff (.xlf) a .xml e aprendolo in un browser web. Se il file è valido, viene presentata una struttura documentale ben organizzata e, in caso contrario, sarà non renderizzabile o con un messaggio di errore.

XLIFF è stato aggiornato con XLIFF 2.0. È simile all'XLIFF più ampiamente utilizzato, ma è un formato di file diverso solitamente incompatibile con XLIFF.

Xcode può impacchettare stringhe localizzabili nel formato XLIFF standard del settore da inviare per la localizzazione con Phrase.

Opzioni di formato

Identificatore	enclose_in_cdata
Tipo	booleano
Caricamento	No
Download	Sì
Predefinito	false
Descrizione	Includere traduzioni contenenti tag html in CDATA. Se disabilitato, le entità HTML non supportate vengono sostituite con i loro valori decodificati. Ad esempio: `£` viene sostituito con £. `™` viene sostituito con ™.

Identificatore	include_translation_state
Tipo	booleano
Caricamento	No
Download	Sì
Predefinito	false
Descrizione	Includere stato delle traduzioni nella lingua di destinazione. Ogni `<target>` tag avrà un attributo `stato`, che può essere uno di: `nuovo`, `approvato`, `tradotto`

Identificatore	indent_size
Tipo	integer
Caricamento	No
Download	Sì
Predefinito	4
Descrizione	Specifica il numero di caratteri di indentazione

Identificatore	indent_style
Tipo	stringa
Caricamento	No
Download	Sì
Predefinito	spazio
Descrizione	Specifica il carattere di indentazione. I valori consentiti sono `spazio` e `scheda`.

Identificatore	ignore_source_translations
Tipo	booleano
Caricamento	Sì
Download	No
Predefinito	false
Descrizione	Ignora le traduzioni di origine nel file durante il caricamento (per evitare aggiornamenti accidentali della lingua di origine)

Identificatore	ignore_target_translations
Tipo	booleano
Caricamento	Sì
Download	No
Predefinito	false
Descrizione	Ignora le traduzioni di destinazione nel file durante il caricamento (per evitare aggiornamenti accidentali della lingua di origine)

Identificatore	export_key_id_as_resname
Tipo	booleano
Caricamento	No
Download	Sì
Predefinito	false
Descrizione	Esporta l'ID chiave come attributo resname.

Identificatore	export_key_name_hash_as_extradata
Tipo	booleano
Caricamento	No
Download	Sì
Predefinito	false
Descrizione	Esporta l'hash del nome chiave come attributo extradata.

Identificatore	override_file_language
Tipo	booleano
Caricamento	Sì
Download	No
Predefinito	false
Descrizione	Questo formato di file contiene tipicamente informazioni sulla lingua nel file stesso. Usa questa opzione per sovrascrivere la lingua con una che specifichi.

Identificatore	strip_placeholder_delimiters
Tipo	booleano
Caricamento	Sì
Download	No
Predefinito	false
Descrizione	Rimuove i tag `<ph>` dalle traduzioni

Identificatore	delimit_placeholders
Tipo	booleano
Caricamento	No
Download	Sì
Predefinito	false
Descrizione	Avvolgi i segnaposto delle traduzioni nei tag `<ph>`. Deve avere stili di segnaposto validi definiti nelle impostazioni del progetto.

Campione di codice

<?xml version="1.0" encoding="UTF-8"?>
<xliff xmlns="urn:oasis:names:tc:xliff:document:1.2" version="1.2">
  <file original="global" datatype="plaintext" source-language="de-DE" target-language="en-GB">
    <body>
      <trans-unit id="boolean_key">
        <source xml:lang="de-DE">--- vero
</source>
        <target xml:lang="en-GB">--- true
</target>
      </trans-unit>
      <trans-unit id="empty_string_translation">
        <source xml:lang="de-DE"/>
        <target xml:lang="en-GB"/>
      </trans-unit>
      <trans-unit id="key_with_description">
        <source xml:lang="de-DE">Guarda questo! Questa chiave ha una descrizione!</source>
        <target xml:lang="en-GB">Controllalo! Questa chiave ha una descrizione! (Almeno in alcuni formati)</target>
        <note>Questa è la descrizione sorprendente per questa chiave!</note>
      </trans-unit>
      <trans-unit id="key_with_line-break">
        <source xml:lang="it-IT">Questa traduzione contiene
einen Zeilenumbruch.</source>
        <target xml:lang="it-IT">Questa traduzione contiene
un'interruzione di linea.</target>
      </trans-unit>
      <trans-unit id="nested.deeply.key">
        <source xml:lang="it-IT">Sono una chiave profondamente annidata.</source>
        <target xml:lang="it-IT">Sono una chiave profondamente annidata.</target>
      </trans-unit>
      <trans-unit id="nested.key">
        <source xml:lang="it-IT">Questa chiave è annidata all'interno di uno spazio dei nomi.</source>
        <target xml:lang="it-IT">Questa chiave è annidata all'interno di uno spazio dei nomi.</target>
      </trans-unit>
      <trans-unit id="null_translation">
        <source xml:lang="de-DE"/>
        <target xml:lang="en-GB"/>
      </trans-unit>
      <trans-unit id="sample_collection">
        <source xml:lang="de-DE">---
- primo elemento
- secondo elemento
</source>
        <target xml:lang="en-GB">---
- first item
- second item
- third item
</target>
      </trans-unit>
      <trans-unit id="simple_key">
        <source xml:lang="it-IT">Chiave semplice, messaggio semplice, così semplice</source>
        <target xml:lang="it-IT">Chiave semplice, messaggio semplice, così semplice.</target>
      </trans-unit>
      <trans-unit id="unverified_key">
        <source xml:lang="it-IT">Questa traduzione non è ancora verificata e aspetta!</source>
        <target xml:lang="it-IT">Questa traduzione non è ancora verificata e aspetta per essa. (In alcuni formati esportiamo anche questo stato)</target>
      </trans-unit>
    </body>
  </file>
</xliff>

Forme plurali

Le chiavi plurali vengono esportate utilizzando la seguente sintassi:

<trans-unit id="plural_key">
  <source xml:lang="en">{"one":"one chair","other":"{nrOfChairs} chairs","zero":"no chairs"}</source>
  <target xml:lang="de">{"one":"ein Stuhl","other":"{nrOfChairs} Stühle","zero":"keine Stühle"}</target>
</trans-unit>