Stefano Bernardi headshot
Salut, les spécialistes du marketing international !
Tu as besoin de trouver le bon équilibre entre le coût, la qualité et les délais de réalisation de tes projets de traduction ?
Inscris-toi à notre webinaire aujourd’hui !

Comment traduire de la documentation technique exportée en fichier XLIFF

Sommaire

Si tu gères de la documentation technique, le fichier à traduire ne ressemble pas toujours à un document. Parfois, c'est un fichier qui se termine par .xliff ou .xlf, généré par l'outil utilisé par ton équipe, et il ne s'ouvre pas facilement dans Word.

C'est courant pour les rédacteurs techniques qui doivent traduire leur documentation en 5, 10 ou même plus de langues. Ça arrive souvent avec MadCap Flare en particulier : Flare n'exporte pas XLIFF lui-même, mais MadCap Lingo, son outil compagnon, le fait. Ce fichier XLIFF marque généralement la fin du boulot de l'équipe documentation et le début du travail de traduction de quelqu'un d'autre.

Voilà ce qu'est vraiment un fichier XLIFF, pourquoi un outil comme MadCap Lingo en génère un, et quelles sont tes options pour le faire traduire correctement.

‍

C'est quoi un fichier XLIFF ?

XLIFF veut dire XML Localization Interchange File Format. C'est un standard ouvert basé sur XML, conçu spécialement pour transférer du texte entre l'outil qui l'a créé et l'outil, ou la personne, qui le traduit, sans perdre la structure d'origine.

Au lieu qu'un traducteur bosse directement dans l'appli source, le contenu est extrait dans un fichier XLIFF : juste le texte à traduire, balisé avec assez de structure pour que l'outil qui le reçoit sache où chaque morceau va. Un traducteur, ou un outil de traduction, remplit la langue cible, et le fichier, qui contient maintenant le texte source et le texte traduit, retourne là où il doit aller.

Il y a deux versions courantes : XLIFF 1.2 et XLIFF 2.x. XLIFF 1.2 est la version la plus ancienne et la plus répandue, et c'est celle que MadCap Lingo génère.

D'où viennent les fichiers XLIFF dans la documentation technique

Tu n'écris pas un fichier XLIFF à la main. Il est généré par l'outil qui gère ton contenu source, comme étape d'export avant la traduction.

Pour la documentation technique en particulier, la source la plus courante c'est MadCap Flare, via MadCap Lingo. Si ton équipe crée des manuels, des fiches techniques ou des documents de conformité dans Flare, MadCap Lingo est l'outil qui génère le fichier XLIFF 1.2 à partir de ce contenu, prêt à être envoyé pour traduction. Si ta documentation est dans un autre outil de rédaction, c'est le même souci même si l'étape d'export est différente : le contenu créé pour un système ne ressemble plus à un document en sortant, et il faut que quelqu'un sache quoi faire du fichier généré. Ce guide détaille le cas de MadCap Flare et MadCap Lingo, parce que c'est celui qu'il est utile de bien comprendre.

MadCap Flare, MadCap Lingo, et le fichier XLIFF au milieu

C'est important d'être précis sur qui fait quoi, parce que "MadCap Flare" et "MadCap Lingo" sont souvent confondus, alors que ce n'est pas la même chose.

MadCap Flare crée tes documents techniques. MadCap Lingo est l'outil séparé de MadCap pour préparer ce contenu à la traduction, et c'est lui qui génère vraiment le fichier XLIFF 1.2. Flare n'exporte pas XLIFF directement.

Le boulot de Lingo s'arrête à la génération de ce fichier. Il ne te donne pas d'espace partagé pour qu'un traducteur, une agence ou plusieurs traducteurs bossent ensemble sur le contenu. Et la plupart des équipes qui traduisent de la doc Flare n'ont pas une licence Lingo pour chaque traducteur de toute façon.

Il y a aussi une étape sur le retour qui est facile à zapper. Flare ne peut pas importer un fichier XLIFF traduit directement. Le fichier traduit doit d'abord repasser par Lingo, et c'est Lingo qui exporte le projet Flare final dans la langue cible. En résumé : Flare crée le contenu, Lingo génère le fichier XLIFF, la traduction se fait ailleurs, le XLIFF traduit retourne dans Lingo, et Lingo exporte le projet Flare traduit. Quel que soit l'outil que tu utilises pour traduire le fichier XLIFF, prévois ce passage retour par Lingo. Ce n'est pas optionnel.

Comment vraiment traduire un fichier XLIFF

Une fois que tu as le fichier, tu as trois options réalistes.

  • ‍Ouvre-le comme un fichier texte ou XML. C'est techniquement possible, vu que XLIFF c'est du XML en dessous. Pas recommandé sauf si tu adores éditer du balisage brut à la main et vérifier ensuite que tu n'as pas cassé la structure des balises.‍
  • Utilise un éditeur XLIFF dédié. Ils existent justement pour ouvrir et éditer des fichiers XLIFF sans voir le XML brut. Ils gèrent bien le format, mais la plupart sont faits pour un seul traducteur qui bosse seul sur un fichier. Ils ne te donnent pas de mémoire de traduction, ni de glossaire partagé, ni de moyen pour que plusieurs traducteurs bossent ensemble sur le même projet.‍
  • Utilise une plateforme de traduction qui accepte directement XLIFF 1.2. C'est là qu'un outil comme Redokun est parfait : importe le fichier XLIFF, invite ton traducteur (ou plusieurs), et bosse avec une mémoire de traduction et un glossaire partagés, les mêmes outils que tu utiliserais pour traduire un fichier Word ou InDesign. Personne n'a besoin de toucher au XML brut, et la terminologie reste cohérente que ce soit un ou cinq traducteurs qui bossent sur le fichier.

Traduire ton fichier XLIFF MadCap Flare dans Redokun

  1. Importe le fichier dans ton espace de travail Redokun.
  2. Ajoute tes langues cibles et invite tes traducteurs.
  3. Traduis le contenu dans l’éditeur partagé de Redokun, avec la mémoire de traduction et le glossaire activés.
  4. Une fois la traduction terminée, télécharge le fichier XLIFF traduit.
  5. Importe le fichier dans MadCap Lingo.
  6. Exporte le projet finalisé en langue cible depuis Lingo, puis publie-le.

Les étapes 1, 6 et 7 se passent dans MadCap Lingo. Redokun gère les étapes 2 à 5. Ça ne remplace pas Lingo. Ça comble le vide que Lingo laisse pour le vrai travail de traduction.

Est-ce une intégration dédiée à MadCap Flare ?

Redokun n’a pas de plugin dédié pour Flare ou Lingo. Tu n’en as pas besoin, car il accepte le fichier XLIFF 1.2 comme l’un des formats déjà pris en charge : InDesign, Word, PowerPoint, Excel, XLIFF, XML, JSON, et bien d’autres. Le support XLIFF fonctionne pareil, que le fichier vienne de MadCap Lingo ou d’un autre outil de documentation.

‍

FAQ

C’est quoi la traduction de documentation technique ?

C’est le processus de traduction de manuels, fiches techniques, documents de conformité et autres contenus techniques dans d’autres langues, souvent pour un produit vendu sur plusieurs marchés. C’est un boulot différent de la traduction marketing : le contenu vient souvent d’un outil d’édition dédié plutôt que d’un format de document classique, c’est pour ça que des fichiers comme XLIFF apparaissent dans le processus.

C’est quoi XLIFF 1.2 ?

XLIFF 1.2 est une version du format d’échange de localisation XML (XML Localization Interchange File Format), une norme ouverte pour transférer du contenu traduisible entre l’outil qui l’a créé et la personne qui le traduit. C’est la version générée par MadCap Lingo, et celle que Redokun prend en charge.

Est-ce qu’il me faut MadCap Lingo pour obtenir un fichier XLIFF depuis Flare ?

Oui. MadCap Flare n’exporte pas XLIFF tout seul. MadCap Lingo est l’outil qui génère le fichier XLIFF 1.2 à partir de ton contenu Flare.

Est-ce que MadCap Flare peut importer directement un fichier XLIFF traduit ?

Non. Le fichier XLIFF traduit doit d’abord retourner dans MadCap Lingo. C’est Lingo qui exporte le projet Flare finalisé en langue cible ; Flare lui-même ne prend pas directement un fichier XLIFF traduit.

Quels autres formats de fichiers Redokun prend-il en charge ?

En plus de XLIFF (.xliff, .xlf), Redokun prend en charge InDesign (.idml), Word (.docx), PowerPoint (.pptx), Excel (.xlsx), HTML (.html), XML (.xml), JSON (.json), texte brut (.txt) et les fichiers de sous-titres (.srt).

Est-ce que c’est adapté si j’ai juste un projet de documentation à traduire ?

Si tu traduis juste un projet en ce moment sans besoin régulier, Project Pass est fait pour ça : un achat unique, sans abonnement. Si ton équipe traduit de la documentation régulièrement, un essai gratuit du Workspace Plan est le meilleur point de départ.

Prêt à essayer ? Si tu as un projet de documentation technique à traduire, commence avec Project Pass. Si la traduction fait partie de ton travail de documentation de façon régulière, commence un essai gratuit du Workspace Plan.

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.

Télécharge le guide
Blue arrow pointing right
Pas besoin d’email
Icon of an eye

Streamline your translation workflow with zero downtime. Discover how.

yellow double swoosh