Traduire un fichier CSV de chaînes en coréen

Ce que le coréen change dans une table de chaînes

Le coréen s’écrit de gauche à droite, avec des espaces entre groupes de mots, mais sa grammaire bouscule plusieurs habitudes des fichiers de localisation.

• L’ordre des mots. Le verbe vient en fin de phrase. Delete {item}? devient {item}을(를) 삭제할까요? : la variable passe en tête. Elle est conservée, seule sa place change, ce qui est normal.
• Les particules. Les marques 을/를, 이/가, 은/는 ou (으)로 dépendent de la dernière syllabe du mot qui précède : avec ou sans consonne finale. Quand ce mot est une variable dont on ignore la valeur, on écrit la forme double 을(를) ou l’on reformule pour éviter la particule.
• Le pluriel. Le coréen n’a qu’une catégorie CLDR, other. On ne distingue pas un élément de plusieurs, mais on emploie des classificateurs : 항목 {count}개 pour des objets, {count}명 pour des personnes. Si votre CSV a des clés coins_one et coins_other, les deux valeurs coréennes seront souvent identiques.
• La politesse. Le registre se lit dans la terminaison des verbes : 저장합니다 (formel) ou 저장해요 (poli et plus familier). Les boutons prennent souvent une forme nominale, 저장 pour « Enregistrer ». L’essentiel est de ne pas mélanger les registres d’un écran à l’autre.
• La ponctuation. Points, virgules, points d’interrogation et d’exclamation sont ceux de l’alphabet latin, sans espace avant ? ni !, contrairement au français.

Ce que Manuce rend exactement, et ce qu’il ne fait pas

Manuce reconnaît un CSV « développeur » : une colonne de clés (key, id…) et des colonnes de langue (en, fr, de_DE…), comme dans Unity ou Godot.

• Si une colonne coréenne existe, elle est remplie ; sinon, elle est ajoutée en dernière colonne. Une colonne comment ou context sert de contexte au moteur.
• Le fichier rendu est le même : ordre des clés, guillemets, commentaires, fins de ligne, encodage et BOM conservés. Seules les valeurs changent.
• Chaque valeur traduite est comparée à la source : si {0}, %s ou <b> manque ou se trouve altéré et que l’écart persiste, la valeur source est gardée et le rapport le signale.
• Ne sont pas traduits : clés, valeurs vides, URL, adresses email, nombres, couleurs, formats de date, identifiants et tout ce qui est marqué non traduisible.
• Le prix porte sur les mots des valeurs, clés et balises exclues, avec un coefficient ×1.6 pour le coréen.

Un CSV sans colonne de clés n’est pas un fichier de langue : il est alors traduit comme un texte. Manuce ne modifie pas vos polices, ne teste pas l’affichage dans le jeu ou l’application et ne peut pas choisir la particule exacte qui suivra une variable connue seulement à l’exécution.

Préparer le CSV avant de le déposer

1. Passez en UTF-8. L’encodage d’origine est conservé : un fichier enregistré en Windows-1252 ou Latin-1 ne peut pas contenir de hangeul. Convertissez-le en UTF-8 avant le dépôt ; si votre outil exige un BOM, ajoutez-le, il sera gardé.
2. Choisissez le nom de colonne. Unity, Godot ou votre propre lecteur attendent ko, ko_KR ou ko-KR. Pour maîtriser l’en-tête, créez vous-même une colonne vide avec le nom exact : elle sera remplie telle quelle.
3. Renseignez le contexte. Une colonne context avec « bouton, 6 caractères max » ou « nom du joueur en début de phrase » aide à choisir entre forme nominale et phrase, et à placer la particule.
4. Regroupez les phrases coupées. Trois clés You have, {n}, coins ne se recollent pas en coréen, où l’ordre s’inverse : 코인 {n}개를 가지고 있어요. Une seule chaîne avec variable est traduisible, trois morceaux ne le sont pas.
5. Repérez les noms propres. Nom du jeu, de personnages, de la marque : vérifiez dans l’extrait gratuit puis dans la traduction qu’ils sont restés tels que vous le souhaitez.

Vérifier le fichier coréen dans le projet

• Lisez le rapport. Il liste les chaînes laissées en langue source et la raison, par exemple une variable qui ne correspondait pas. Corrigez-les à la main ou ajustez la source.
• Contrôlez la police. Si la police du projet ne contient pas les glyphes hangeul, le texte s’affiche en carrés vides. Il faut une police coréenne ou une police de repli ; c’est un réglage du moteur, pas du CSV.
• Testez les particules. Affichez une phrase avec un nom terminé par une consonne, 민준, puis par une voyelle, 지우. La forme 을(를) reste lisible dans les deux cas ; une particule simple peut être fautive dans l’un.
• Regardez la longueur et les retours à la ligne. Le coréen compte souvent moins de caractères que l’anglais, mais chaque glyphe est plus large. Les lignes se coupent normalement aux espaces : vérifiez qu’aucun mot n’est tranché au milieu dans les zones étroites.
• Ouvrez le bon fichier. Si le coréen paraît illisible dans un tableur, c’est en général l’import qui suppose un autre encodage : rouvrez le fichier en précisant UTF-8.

En pratique

1. Enregistrez le CSV en UTF-8 et vérifiez qu’il a une colonne de clés.
2. Ajoutez si besoin une colonne vide ko ou ko_KR et une colonne context.
3. Déposez le fichier, lisez le devis et l’extrait gratuit en coréen.
4. Récupérez le CSV traduit et le rapport, puis remettez-le dans le projet.
5. Testez police, retours à la ligne et particules après les variables.