Comment traduire des fichiers YAML en ligne

La traduction de fichiers de localisation YAML est simple avec notre outil assisté par IA. Suivez ces étapes pour obtenir un fichier YAML entièrement traduit en quelques minutes :

1. Collez le contenu de votre fichier .yaml ou .yml dans l'éditeur ci-dessus.
2. Définissez la langue source (ou laissez vide pour la détection automatique) et entrez le code de langue cible (par ex. es, de, ja, zh).
3. Cliquez sur Traduire et attendez que l'IA traite votre contenu YAML. La traduction peut prendre quelques minutes pour les fichiers volumineux.
4. Copiez la sortie traduite ou téléchargez-la sous forme de fichier .yaml prêt à être envoyé vers votre dépôt.

Qu'est-ce qu'un fichier YAML ?

YAML (YAML Ain't Markup Language) est un format de sérialisation de données lisible par l'homme, largement utilisé pour les fichiers de configuration et la localisation dans le développement logiciel moderne. Sa syntaxe propre, basée sur l'indentation, le rend facile à lire et à écrire par rapport au JSON ou au XML.

Les fichiers YAML utilisent l'extension .yaml ou .yml et sont le format de localisation standard pour Ruby on Rails, Symfony (PHP), Vue i18n, Flutter ARB, Spring Boot et de nombreux autres frameworks. Un seul fichier YAML contient généralement toutes les chaînes traduites pour une langue.

Parce que YAML prend en charge les clés imbriquées, les listes et les commentaires en ligne, il est particulièrement bien adapté pour organiser de grands ensembles de chaînes d'interface utilisateur dans une structure hiérarchique qui reflète l'arborescence des composants de l'application.

Structure de fichier YAML pour la localisation

Un fichier de localisation YAML typique utilise des paires clé-valeur imbriquées pour organiser les chaînes par fonctionnalité ou composant. Voici un exemple de structure YAML courante :

# Application configuration
app:
  name: "My Application"
  version: "2.0.0"
  description: "A powerful tool for managing your workflow"

navigation:
  home: "Home"
  about: "About Us"
  contact: "Contact"
  login: "Sign In"
  logout: "Sign Out"

messages:
  welcome: "Welcome back, {{name}}!"
  error: "An unexpected error occurred. Please try again."
  success: "Your changes have been saved successfully."

buttons:
  save: "Save"
  cancel: "Cancel"
  delete: "Delete"
  confirm: "Confirm"

• Paires clé-valeur — la base du YAML : key: "Chaîne traduite".
• Clés imbriquées — regroupez les chaînes associées sous un parent commun : button.save: "Enregistrer".
• Listes — séquences ordonnées de valeurs utilisant le préfixe -.
• Commentaires — les lignes commençant par # fournissent un contexte aux traducteurs et sont conservées en option.
• Espaces réservés d'interpolation — les variables comme {{name}} ou %{count} sont conservées telles quelles et ne sont jamais traduites.

Exemple de fichier de localisation YAML

Vous trouverez ci-dessous un fichier de localisation YAML réaliste montrant l'utilisation des clés imbriquées, de l'interpolation et des commentaires, telle qu'on la trouve dans les projets Rails et Vue i18n en production :

# en/messages.yaml
user:
  greeting: "Hello, {{name}}!"
  farewell: "Goodbye, {{name}}. See you soon!"
  profile:
    title: "Your Profile"
    subtitle: "Manage your account settings"
    avatar: "Profile Picture"

errors:
  notFound: "The page you are looking for does not exist."
  unauthorized: "You are not authorized to view this page."
  serverError: "A server error occurred. Please contact support."

forms:
  required: "This field is required."
  email: "Please enter a valid email address."
  minLength: "Must be at least {{min}} characters."

Notre IA traduit toutes les valeurs de chaîne tout en laissant les clés, les variables d'interpolation et l'indentation structurelle complètement inchangées. Le résultat est un fichier de remplacement prêt à l'emploi pour votre langue cible.

Fichiers YAML dans la localisation logicielle

YAML est l'un des formats les plus populaires pour la localisation de logiciels car il trouve le bon équilibre entre lisibilité humaine et analysabilité machine. Les développeurs peuvent modifier les fichiers YAML directement sans outils spéciaux, tandis que les pipelines automatisés peuvent les traiter de manière fiable.

Dans un flux de travail de localisation typique, vous maintenez un fichier YAML par langue (par ex. en.yml, de.yml, ja.yml) dans un répertoire locales ou i18n. Le fichier de langue source est traité comme référence, et des copies traduites sont générées pour chaque locale cible.

Frameworks et outils utilisant YAML pour la localisation

Les fichiers de localisation YAML sont pris en charge par un large éventail de frameworks populaires sur plusieurs langages et plateformes :

• Ruby on Rails — utilise YAML comme format i18n natif (config/locales/en.yml). La gem i18n de Rails prend en charge les clés imbriquées, la pluralisation et l'interpolation nativement.
• Symfony (PHP) — prend en charge les fichiers de traduction YAML aux côtés de XLIFF. Les fichiers YAML dans translations/messages.en.yaml alimentent le composant de traduction de Symfony.
• Spring Boot (Java) — bien que Spring utilise généralement des fichiers .properties, la prise en charge YAML de Spring dans application.yml et les bibliothèques communautaires comme i18n4java étendent YAML à la localisation.
• Flutter / Dart — le package easy_localization et des bibliothèques i18n Flutter similaires utilisent des fichiers YAML pour gérer les traductions pour les applications mobiles et de bureau.
• Vue i18n — le plugin officiel d'internationalisation de Vue.js prend en charge les fichiers de messages YAML. Vite-plugin-vue-i18n permet d'importer des fichiers .yaml directement en tant que composants Vue.
• React / Next.js — des bibliothèques telles que next-i18next et react-i18next peuvent charger des fichiers de traduction YAML via des backends personnalisés, ce qui en fait un choix populaire pour la localisation Next.js.

Génération de glossaire par IA pour les traductions YAML

Notre fonctionnalité de génération de glossaire par IA vous aide à maintenir une terminologie cohérente dans tous vos fichiers de localisation YAML. Activez l'enregistrement et la réutilisation en activant générer et enregistrer le glossaire dans les options de traduction :

• Terminologie cohérente — l'IA analyse votre YAML source et les traductions cibles existantes pour construire un glossaire de termes clés, garantissant que les noms de produits, les étiquettes d'interface et les termes techniques sont traduits de la même manière dans toute votre application.
• Termes spécifiques au domaine — fournissez un échantillon de contenu YAML déjà traduit dans le champ des chaînes cibles. L'IA apprend votre terminologie préférée et l'applique automatiquement aux nouvelles chaînes.
• Comment l'utiliser — collez votre contenu YAML traduit dans le champ optionnel des chaînes cibles qui apparaît lorsque la génération de glossaire est activée. L'IA extraira les termes récurrents et les utilisera comme guide de traduction. Si aucune chaîne cible n'est fournie, l'IA génère des entrées de glossaire à partir du contenu source seul, ce qui peut toujours améliorer la cohérence.

Pourquoi utiliser L10n.dev pour la traduction YAML ?

• Précision assistée par IA — notre moteur de traduction comprend le contexte de localisation YAML, pas seulement le texte brut. Il traduit les chaînes lisibles par l'homme tout en ignorant les clés, les ancres, les alias et la syntaxe structurelle.
• Préservation de la structure — l'indentation, l'imbrication et la hiérarchie YAML sont toujours préservées. Le fichier traduit est un document YAML valide qui peut être analysé sans modification.
• Prise en charge de l'interpolation — les espaces réservés comme {{name}}, %{count}, :variable et les variables au format de message ICU sont détectés et laissés intacts pendant la traduction.
• Conscience des clés imbriquées — l'IA comprend la structure hiérarchique des fichiers YAML profondément imbriqués et maintient un contexte précis pour chaque chaîne en fonction de sa position dans l'arborescence.
• Compatibilité multi-framework — la sortie est compatible avec Ruby on Rails, Symfony, Vue i18n, Flutter, Spring Boot et tout autre framework qui consomme des fichiers de localisation YAML standard.
• Traduisez jusqu'à 10,000 caractères gratuitement. Les plans payants offrent une tarification évolutive pour les projets plus importants.Voir les tarifs
• Optimisé pour les fichiers volumineux — pour les très gros fichiers YAML (centaines de kilo-octets), utilisez la page traduction de fichiers i18n qui prend en charge les téléchargements de fichiers jusqu'à 5 Mo.

Cas d'utilisation courants de la traduction YAML

La traduction YAML est utilisée dans un large éventail de types d'applications et de flux de travail de développement :

• Applications Ruby on Rails — traduisez config/locales/en.yml en fichiers de langue supplémentaires pour les applications Rails multilingues.
• Projets Symfony PHP — localisez translations/messages.en.yaml et les fichiers de traduction spécifiques au domaine pour les sites Web et API basés sur Symfony.
• Applications Vue.js / Nuxt.js — traduisez les fichiers de messages YAML de Vue i18n pour ajouter la prise en charge linguistique aux applications Vue monopage et aux sites statiques Nuxt.js.
• Applications mobiles Flutter — traduisez les fichiers de localisation assets/lang/en.yaml pour les applications Flutter multiplateformes ciblant plusieurs marchés.
• Configuration et contenu CMS — traduisez les fichiers de configuration YAML utilisés par les générateurs de sites statiques comme Jekyll, Hugo ou Gatsby pour le contenu de sites multilingues.
• Générateurs de sites statiques — Jekyll utilise des fichiers YAML _data/ pour les chaînes à l'échelle du site, Hugo utilise des fichiers YAML i18n/ et Gatsby prend en charge YAML via gatsby-plugin-react-i18next.
• Pipelines CI/CD et DevOps — intégrez la traduction YAML dans votre pipeline de déploiement en utilisant l'API REST L10n.dev pour automatiser la localisation dans le cadre de votre flux de travail de publication.

YAML vs JSON pour la localisation

YAML et JSON sont tous deux largement utilisés pour les fichiers de localisation, mais ils ont des forces différentes. La syntaxe lisible par l'homme du YAML, la prise en charge des commentaires et les chaînes multilignes compactes le rendent préféré dans des communautés comme Ruby et PHP où les développeurs modifient fréquemment les fichiers de traduction à la main.

JSON est plus universellement pris en charge dans les écosystèmes JavaScript (React, Angular, Vue) et est plus facile à analyser par programmation. Si votre projet utilise les deux formats, L10n.dev prend en charge les deux — vous pouvez traduire les fichiers JSON sur la page de traduction JSON et les fichiers YAML ici.

Pour la plupart des projets, le choix du format est dicté par le framework que vous utilisez. Si vous utilisez Rails, Symfony ou Vue i18n, YAML est le choix naturel. Si vous utilisez Angular i18next, React i18next ou Next.js, JSON est plus courant. L10n.dev gère les deux aussi bien.

Questions fréquentes

Quelles parties de mon fichier YAML sont préservées pendant la traduction ?

Tous les éléments structurels YAML sont préservés : clés, indentation, imbrication, ancres (&), alias (*), commentaires (#) et syntaxe de liste (-). Les espaces réservés d'interpolation comme {{variable}}, %{name} et :symbol sont toujours laissés inchangés. Seules les valeurs de chaîne lisibles par l'homme sont traduites.

Les variables d'interpolation et les espaces réservés sont-ils sûrs pendant la traduction ?

Oui. Notre IA détecte les modèles d'interpolation courants utilisés par Rails (%{name}), Vue i18n ({name}), Symfony (%variable%), Flutter ({name}) et le format de message ICU. Ces variables sont préservées exactement telles qu'elles sont écrites et ne sont jamais traduites ou modifiées.

Comment traduire un fichier YAML ?

Collez le contenu de votre fichier .yaml ou .yml dans l'éditeur ci-dessus, définissez le code de langue cible (par ex. fr, de, ja, zh) et cliquez sur traduire. L'IA renvoie un fichier YAML entièrement traduit avec toutes les clés et la structure préservées. Téléchargez le résultat sous forme de fichier .yaml.

Comment la génération de glossaire par IA aide-t-elle avec la traduction YAML ?

Activer générer et enregistrer le glossaire vous permet de coller le contenu YAML traduit existant à côté de votre fichier source. L'IA extrait les termes récurrents et les utilise comme guide de traduction, garantissant que les noms de produits, les étiquettes de fonctionnalités et les termes de domaine sont traduits de manière cohérente dans tout le fichier et lors des futures traductions.

Puis-je traduire de gros fichiers de localisation YAML ?

Cette page fonctionne bien pour les fichiers YAML individuels allant jusqu'à quelques centaines de kilo-octets. Pour la traduction YAML en masse ou les fichiers très volumineux, utilisez la page traduction de fichiers i18n qui prend en charge les téléchargements de fichiers jusqu'à 5 Mo et offre une livraison plus fiable pour les projets de localisation à grande échelle.