Stefano Bernardi headshot
Ciao, professionisti del marketing globale!
Hai bisogno di bilanciare costi, qualità e tempi di consegna dei tuoi progetti di traduzione?
Iscriviti oggi al nostro webinar!

Come tradurre la documentazione tecnica esportata come file XLIFF

Indice

Se gestisci la documentazione tecnica, il file da tradurre non sembra sempre un documento. A volte è un file che termina con .xliff o .xlf, che ti viene passato dallo strumento che usa il tuo team, e non si apre bene in Word.

Questo succede spesso a chi scrive documentazione tecnica e deve tradurre i propri contenuti in 5, 10 o più lingue. Succede spesso proprio con MadCap Flare: Flare non esporta direttamente XLIFF, ma MadCap Lingo, il suo strumento complementare, sì. Quel file XLIFF di solito segna il punto in cui il lavoro del team di documentazione finisce e inizia quello di traduzione di qualcun altro.

Ecco cos'è davvero un file XLIFF, perché uno strumento come MadCap Lingo lo genera e quali sono le opzioni per tradurlo nel modo giusto.

‍

Cos'è un file XLIFF?

XLIFF sta per XML Localization Interchange File Format. È uno standard aperto basato su XML, creato apposta per spostare il testo tra lo strumento che lo ha generato e quello (o la persona) che lo traduce, senza perdere la struttura originale.

Invece di far lavorare il traduttore direttamente nell'applicazione di origine, il contenuto viene estratto in un file XLIFF: solo il testo da tradurre, con abbastanza struttura per far capire allo strumento di destinazione dove va ogni parte. Un traduttore, o uno strumento di traduzione, inserisce la lingua di destinazione e il file, che ora contiene sia il testo originale che quello tradotto, torna dove deve andare.

Ci sono due versioni comunemente usate: XLIFF 1.2 e XLIFF 2.x. XLIFF 1.2 è la versione più vecchia e più supportata, ed è quella che genera MadCap Lingo.

Da dove arrivano i file XLIFF nella documentazione tecnica

Non scrivi un file XLIFF a mano. Viene generato dallo strumento che gestisce i tuoi contenuti di origine, come passaggio di esportazione prima della traduzione.

Per la documentazione tecnica, la fonte più comune è MadCap Flare, tramite MadCap Lingo. Se il tuo team crea manuali, schede tecniche o documenti di conformità in Flare, MadCap Lingo è lo strumento che genera il file XLIFF 1.2 da quei contenuti, pronto per essere tradotto. Se la tua documentazione si trova in un altro strumento di authoring, il problema di base è lo stesso anche se l'esportazione è diversa: il contenuto creato per un sistema non esce come un documento e qualcuno deve sapere cosa fare con il file che viene prodotto. Questa guida spiega nel dettaglio il caso di MadCap Flare e MadCap Lingo, visto che è quello che vale la pena capire bene.

MadCap Flare, MadCap Lingo e il file XLIFF nel mezzo

È utile essere precisi su cosa fa ogni strumento, perché "MadCap Flare" e "MadCap Lingo" vengono spesso confusi, ma non sono la stessa cosa.

MadCap Flare crea i tuoi documenti tecnici. MadCap Lingo è lo strumento separato di MadCap per preparare quei contenuti alla traduzione, ed è quello che genera effettivamente il file XLIFF 1.2. Flare non esporta direttamente XLIFF.

Il lavoro di Lingo si ferma alla generazione di quel file. Non ti offre uno spazio condiviso dove un traduttore, un'agenzia o più traduttori possano lavorare insieme sul contenuto. E la maggior parte dei team che traducono la documentazione Flare non ha comunque una licenza Lingo per ogni traduttore.

C'è anche un passaggio al ritorno che è facile dimenticare. Flare non può importare direttamente un file XLIFF tradotto. Il file tradotto deve prima tornare in Lingo, che poi esporta il progetto Flare finito nella lingua di destinazione. In breve: Flare crea il contenuto, Lingo genera il file XLIFF, la traduzione avviene altrove, il file XLIFF tradotto torna in Lingo e Lingo esporta il progetto Flare tradotto. Qualunque strumento tu usi per tradurre il file XLIFF, considera sempre il passaggio di ritorno tramite Lingo. Non è opzionale.

Come tradurre davvero un file XLIFF

Una volta che hai il file, hai tre opzioni realistiche.

  • ‍Aprilo come file di testo normale o XML. È tecnicamente possibile, visto che XLIFF sotto sotto è XML. Non consigliato a meno che tu non ami modificare il markup grezzo a mano e ricontrollare di non aver rotto la struttura dei tag dopo.‍
  • Usa un editor XLIFF dedicato. Questi esistono proprio per aprire e modificare file XLIFF senza mostrare l'XML grezzo. Gestiscono il formato correttamente, ma la maggior parte è pensata per un solo traduttore che lavora da solo su un file. Non ti danno una Memoria di traduzione, un Glossario condiviso o un modo per far lavorare più traduttori sullo stesso progetto contemporaneamente.‍
  • Usa una piattaforma di traduzione che accetta direttamente XLIFF 1.2. Qui entra in gioco uno strumento come Redokun: carica il file XLIFF, invita il tuo traduttore (o più di uno) e lavora con una Memoria di traduzione e un Glossario condivisi, gli stessi Strumenti che useresti per tradurre un file Word o InDesign. Nessuno deve toccare l'XML grezzo e la terminologia resta coerente sia che lavori un solo traduttore, sia che ne lavorino cinque.

Tradurre il tuo file XLIFF di MadCap Flare in Redokun

  1. Carica il file nel tuo workspace di Redokun.
  2. Aggiungi le tue lingue di destinazione e invita i tuoi traduttori.
  3. Traduci il contenuto nell'editor condiviso di Redokun, con Memoria di traduzione e Glossario attivi.
  4. Quando la traduzione è finita, scarica il file XLIFF tradotto.
  5. Importa il file in MadCap Lingo.
  6. Esporta il progetto finito, nella lingua di destinazione, da Lingo e pubblicalo.

I primi quattro passaggi avvengono in Redokun. Gli ultimi due, l’importazione e l’esportazione del progetto tradotto, avvengono in MadCap Lingo. Non sostituisce Lingo. Colma il vuoto che Lingo lascia per il vero lavoro di traduzione.

Questa è un'integrazione dedicata di MadCap Flare?

Redokun non ha un plugin dedicato per Flare o Lingo. Non ne hai bisogno, perché accetta il file XLIFF 1.2 come uno dei formati che già supporta: InDesign, documento Word, PowerPoint, Excel, XLIFF, XML, JSON e altro ancora. Lo stesso supporto XLIFF funziona sia che il file provenga da MadCap Lingo sia da un altro strumento di documentazione.

‍

Domande frequenti

Cos'è la traduzione della documentazione tecnica?

È il processo di traduzione di manuali, schede tecniche, documenti di conformità e altri contenuti tecnici in altre lingue, di solito per un prodotto venduto in più mercati. È un lavoro diverso dalla traduzione di marketing: il contenuto spesso esce da uno strumento di authoring dedicato invece che da un formato documento standard, ed è per questo che file come XLIFF compaiono nel processo.

Cos'è XLIFF 1.2?

XLIFF 1.2 è una versione dell'XML Localization Interchange File Format, uno standard aperto per trasferire contenuti traducibili tra lo strumento che li ha creati e chi li traduce. È la versione che MadCap Lingo genera e che Redokun supporta.

Mi serve MadCap Lingo per ottenere un file XLIFF da Flare?

Sì. MadCap Flare non esporta XLIFF da solo. MadCap Lingo è lo strumento che genera il file XLIFF 1.2 dal tuo contenuto Flare.

MadCap Flare può importare direttamente un file XLIFF tradotto?

No. Il file XLIFF tradotto deve prima essere reinserito in MadCap Lingo. Lingo è quello che esporta il progetto Flare finito nella lingua di destinazione; Flare da solo non accetta direttamente un file XLIFF tradotto.

Quali altri formati di file supporta Redokun?

Oltre a XLIFF (.xliff, .xlf), Redokun supporta InDesign (.idml), documento Word (.docx), PowerPoint (.pptx), Excel (.xlsx), HTML (.html), XML (.xml), JSON (.json), testo normale (.txt) e file di sottotitoli (.srt).

Va bene anche se ho solo un progetto di documentazione da tradurre?

Se stai traducendo un solo progetto ora e non hai bisogno continuo, Project Pass è fatto proprio per questo: acquisto una tantum, senza abbonamento. Se il tuo team traduce documentazione regolarmente, una prova gratuita del piano Workspace è il punto di partenza migliore.

Pronto a provarlo? Se hai un progetto di documentazione tecnica da tradurre, inizia con Project Pass. Se la traduzione è una parte ricorrente del tuo lavoro di documentazione, inizia una prova gratuita del piano Workspace.

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse varius enim in eros elementum tristique. Duis cursus, mi quis viverra ornare, eros dolor interdum nulla, ut commodo diam libero vitae erat. Aenean faucibus nibh et justo cursus id rutrum lorem imperdiet. Nunc ut sem vitae risus tristique posuere.

Scarica la guida
Blue arrow pointing right
Nessuna email richiesta
Icon of an eye

Semplificate il flusso di lavoro di traduzione senza tempi di inattività. Scoprite come.

yellow double swoosh