Traduire les fichiers CSV de localisation
Un fichier CSV de localisation de jeux possède une colonne de clé et une colonne par langue. KAERIS lit la clé et la colonne source et ajoute une colonne pour chaque langue cible.
KAERIS a traduit cette page et vérifié chaque ligne en la retraduisant. Un locuteur natif ne l'a pas encore revue. Original anglais
Comment un fichier CSV de localisation est construit
La première colonne est la clé, la seconde le texte source ; l'en-tête nomme les colonnes (keys,en). Les cellules contenant des virgules ou des sauts de ligne sont mises entre guillemets. Les lignes entièrement vides sont ignorées.
keys,en GREETING,"Welcome back, %s!" ITEMS,"You have {count} items, %d of them new" QUIT,Quit game
Points à surveiller dans les traductions CSV
Une colonne par langue
La sortie contient la colonne de clé, la colonne source, puis
de,jaet ainsi de suite. Vos noms de colonnes de clé et source sont conservés.Formules
Une cellule commençant par
=,+,-ou@est écrite avec une apostrophe initiale pour qu'Excel affiche le texte au lieu d'exécuter une formule.Variables Printf et accolades
%s,%det{count}dans une cellule sont comparés à la source. Dans l'exécution réelle ci-dessous, les trois sont revenus.Mise entre guillemets
Les virgules et les guillemets à l'intérieur d'une cellule sont mis entre guillemets par un générateur CSV, de sorte qu'une cellule traduite ne puisse pas déborder dans la colonne suivante.
Une vraie exécution : traduite en allemand et vérifiée
Une exécution réelle, le 27 octobre 2026, rien édité à la main : kaeris translate translations.csv --langs de avec kaeris 0.2.35, 2,5 secondes, modèle google/gemini-2.5-flash-lite, le défaut du niveau gratuit. Ci-dessous, le fichier allemand qu'il a écrit et ce que kaeris check en dit.
keys,en,de GREETING,"Welcome back, %s!","Willkommen zurück, %s!" ITEMS,"You have {count} items, %d of them new","Sie haben {count} Artikel, davon %d neu" QUIT,Quit game,Spiel beenden
$ kaeris check --source translations.csv --langs de ✓ de: complete & placeholder-safe ✓ all locales complete & placeholder-safe
Ce que KAERIS en fait
Mêmes colonnes, plus de langues
Les colonnes de clé et source sont conservées ; chaque langue cible est une nouvelle colonne. Dans le terminal, le résultat est écrit dans
translations/localization.csvà côté de la source, etkaeris checkle lit à partir de là.Cellules compatibles tableur
Les cellules ressemblant à des formules sont écrites sous forme de texte. Voir la page Jeux pour le côté moteur de jeu.
Vérification gratuite pour ce format
La vérification gratuite sur la page /check lit ce format et s'exécute sans clé ni compte. La commande terminal
kaeris checkla lit aussi : elle prend les 13 formats depuis kaeris 0.2.35, avec les mêmes règles et rien n'est envoyé ailleurs.
Exécutez-le en trois étapes
Installer le CLI
Exécutez
pip install kaeris.Traduire la feuille
Exécutez
kaeris translate localization.csv --langs de,ja,fr.Vérifier le résultat
Exécutez
kaeris check --source localization.csv --langs de,ja,frou téléversez le fichier sur la page de vérification gratuite : les deux lisent la colonne de chaque langue.
pip install kaeris kaeris translate localization.csv --langs de,ja,fr --verify
Questions
Est-ce que cela fonctionne pour Godot et Unity ?
Le format est colonne de clé, colonne source, colonnes de langue, comme ces moteurs l'attendent. Voir la page Jeux.
Une cellule commençant par = sera-t-elle exécutée comme une formule ?
Non. Ces cellules sont écrites de manière à ce qu'un tableur les affiche comme du texte.
Est-ce gratuit ?
Oui, sans compte : 10 000 caractères par fichier et jusqu'à 8 langues par exécution. Une clé API gratuite augmente la limite de fichiers à 50 000 caractères. La licence à vie est de 79 $ une fois, sur votre propre clé OpenRouter ; les plans mensuels commencent à 19 $. Tarifs
Puis-je l'exécuter depuis le terminal ou en CI ?
Oui. pip install kaeris, puis kaeris translate localization.csv --langs de,ja. Le GitHub Action exécute la même traduction dans une pull request. Docs CLI · GitHub Action
Continuer
Référence CLI · Référence Check · Traduire dans le navigateur · Vérification gratuite · Convertir les formats · Localisation fictive
Autres formats : JSON · YAML · .po · ARB · XLIFF · .strings · .xcstrings · .properties · .resx · Markdown · Fluent · Android XML