Meilleures pratiques pour la traduction CSV<\/a><\/li>\n<\/ul>\n<\/div><\/div>\n\nQu\u2019est-ce qu\u2019un fichier CSV pour la traduction ?<\/h2>\n\n
Le CSV (Comma-Separated Values) est un format de texte brut qui organise les donn\u00e9es en lignes et colonnes, chaque valeur \u00e9tant s\u00e9par\u00e9e par une virgule. C\u2019est l\u2019un des formats les plus utilis\u00e9s pour la localisation de logiciels car il est l\u00e9ger, facile \u00e0 \u00e9diter et pris en charge par la plupart des frameworks de d\u00e9veloppement, des plateformes d\u2019e-commerce et des outils de traduction. <\/p>\n\n
Comment structurer un fichier CSV pour la traduction<\/h2>\n\n
Pour pr\u00e9parer un fichier CSV pour la traduction, vous avez besoin d\u2019une ligne d\u2019en-t\u00eate claire, de cl\u00e9s d\u2019identification uniques et d\u2019une colonne pour le texte source. Bien configurer ces \u00e9l\u00e9ments avant de t\u00e9l\u00e9charger votre fichier dans un outil de traduction permet d\u2019\u00e9viter les erreurs d\u2019importation, les cha\u00eenes manquantes et les sorties corrompues. <\/p>\n\n
Faites en sorte que la premi\u00e8re ligne de votre fichier contienne les noms des colonnes et non du contenu. Utilisez des \u00e9tiquettes simples et descriptives comme key<\/code>, source_text<\/code> et context<\/code>. Celles-ci indiquent pr\u00e9cis\u00e9ment \u00e0 votre outil de traduction et aux r\u00e9viseurs humains ce que contient chaque colonne. <\/p>\n\nColonnes requises<\/h3>\n\n
Tout CSV pr\u00eat pour la traduction n\u00e9cessite au minimum une colonne de cl\u00e9 et une colonne de texte source.<\/p>\n\n
La colonne key<\/code> contient un identifiant unique pour chaque cha\u00eene. Votre application l\u2019utilise pour faire correspondre la bonne traduction au moment de l\u2019ex\u00e9cution. Utilisez une convention de nommage coh\u00e9rente, privil\u00e9giez les lettres minuscules, les underscores et les points. Cette colonne n\u2019est pas traduite. Les formats courants incluent button.submit<\/code>, error.invalid_login<\/code> et onboarding.welcome_message<\/code>. <\/p>\n\nLa colonne source_text<\/code> contient le texte original dans votre langue de base, pr\u00eat \u00e0 \u00eatre traduit.<\/p>\n\n\n
\n\n| key<\/th> | source_text<\/th><\/tr>\n<\/thead>\n |
|---|
\n\n| button.submit<\/td>\n | Envoyer<\/td>\n<\/tr>\n |
\n| error.invalid_login<\/td>\n | Nom d\u2019utilisateur ou mot de passe invalide.<\/td>\n<\/tr>\n |
\n| onboarding.welcome_message<\/td>\n | Bienvenue sur notre application !<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n\n<\/div>\n\n Ne modifiez jamais une cl\u00e9 apr\u00e8s le d\u00e9but de la traduction. Cela cr\u00e9erait une nouvelle cha\u00eene et rendrait la traduction existante orpheline. <\/p>\n\n Colonnes optionnelles<\/h3>\n\nIncluez une colonne context<\/code> ou description<\/code> dans la mesure du possible. Les cha\u00eenes courtes comme \u00ab Save \u00bb ou \u00ab Back \u00bb peuvent avoir des significations diff\u00e9rentes selon l\u2019endroit o\u00f9 elles apparaissent dans votre interface. Une br\u00e8ve note vous permet de savoir o\u00f9 chaque cha\u00eene appara\u00eet. <\/p>\n\nPour les fichiers volumineux, une colonne namespace<\/code> ou group<\/code> vous aide \u00e0 organiser les cha\u00eenes par fonctionnalit\u00e9 ou par section, rendant le fichier nettement plus facile \u00e0 g\u00e9rer et \u00e0 r\u00e9viser.<\/p>\n\n\n \n\n| key<\/th> | source_text<\/th> | context<\/th><\/tr>\n<\/thead>\n |
|---|
\n\n| button.save<\/td>\n | Enregistrer<\/td>\n | Barre d\u2019outils de l\u2019\u00e9diteur de documents<\/td>\n<\/tr>\n | \n| checkout.button.save<\/td>\n | Enregistrer<\/td>\n | Formulaire d\u2019adresse de paiement<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n\n<\/div>\n\n Colonnes de langue<\/h3>\n\nSi votre flux de travail n\u00e9cessite de conserver les langues source et cible dans le m\u00eame fichier, ajoutez une colonne pour chaque langue cible en utilisant les codes de langue BCP-47 comme en-t\u00eate. Par exemple, utilisez es_ES<\/code> pour l\u2019espagnol (Espagne) ou fr_FR<\/code> pour le fran\u00e7ais. <\/p>\n\nComment g\u00e9rer les placeholders et les variables dans la traduction CSV<\/h2>\n\nDiff\u00e9rents frameworks utilisent diff\u00e9rentes syntaxes de placeholder. Assurez-vous de conna\u00eetre le format attendu par votre application et utilisez-le de mani\u00e8re coh\u00e9rente dans tout votre fichier : <\/p>\n\n \n \n\n| Format<\/th> | Exemple<\/th><\/tr>\n<\/thead>\n |
|---|
\n\n{variable}<\/code><\/td>\n| Bonjour, {username} !<\/td>\n<\/tr>\n | \n%s<\/code><\/td>\n| Bonjour, %s !<\/td>\n<\/tr>\n | \n{0}<\/code><\/td>\n| Vous avez {0} nouveaux messages.<\/td>\n<\/tr>\n | \n%1$s<\/code><\/td>\n%1$s vous a ajout\u00e9 comme contact.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n\n<\/div>\n\n Si votre texte source inclut des balises HTML comme <strong><\/code>, <br><\/code> ou <a href=\"\"><\/code>, traitez-les de la m\u00eame mani\u00e8re que les placeholders. <\/p>\n\nNe traduisez jamais les placeholders ou les balises HTML. PTC d\u00e9tecte et pr\u00e9serve automatiquement les placeholders et les balises HTML dans tous les formats pris en charge. Il ne les traduit ni ne les modifie jamais, et les maintient \u00e0 la bonne position dans chaque langue cible. <\/p>\n\n Pour g\u00e9rer correctement les pluriels dans toutes les langues, vous devez stocker les formes singuli\u00e8res et plurielles dans des lignes s\u00e9par\u00e9es avec des cl\u00e9s distinctes. Si vous combinez les formes plurielles dans une seule cha\u00eene, les traductions ne s\u2019adapteront pas aux r\u00e8gles grammaticales des autres langues. <\/p>\n\n Par exemple :<\/p>\n\n | | | | | | |
![\"\"](\"https:\/\/ptc.wpml.org\/wp-content\/uploads\/2025\/04\/Border-min-1024x2.png\" "\\"Border-min\\"")
<\/figure><\/div>\n\n\n\n