Traduci file CSV di localizzazione

Un file CSV per la localizzazione di giochi ha una colonna chiave e una colonna per lingua. KAERIS legge la chiave e la colonna sorgente e aggiunge una colonna per ogni lingua di destinazione.

KAERIS ha tradotto questa pagina e controllato ogni riga ritraducendola. Un madrelingua non l'ha ancora revisionata. Originale in inglese

Traduci il tuo file Controlla i tuoi file gratuitamente

Come viene creato un file CSV per la localizzazione

La prima colonna è la chiave, la seconda il testo sorgente; l'intestazione nomina le colonne (keys,en). Le celle con virgole o interruzioni di riga sono racchiuse tra virgolette. Le righe completamente vuote vengono ignorate.

File sorgentetranslations.csv

keys,en
GREETING,"Welcome back, %s!"
ITEMS,"You have {count} items, %d of them new"
QUIT,Quit game

Cosa osservare nelle traduzioni CSV

Una colonna per lingua
L'output contiene la colonna chiave, la colonna sorgente, quindi de, ja e così via. I nomi delle tue colonne chiave e sorgente vengono mantenuti.
Formule
Una cella che inizia con =, +, - o @ viene scritta con un apostrofo iniziale in modo che Excel mostri il testo invece di eseguire una formula.
Variabili Printf e graffe
%s, %d e {count} in una cella vengono confrontati con la sorgente. Nell'esecuzione reale di seguito sono tornati tutti e tre.
Virgolette
Virgole e virgolette all'interno di una cella vengono racchiuse tra virgolette da uno scrittore CSV, quindi una cella tradotta non può invadere la colonna successiva.

Un'esecuzione reale: tradotto in tedesco e controllato

Un'esecuzione reale, 27 ottobre 2026, nulla modificato manualmente: kaeris translate translations.csv --langs de con kaeris 0.2.35, 2,5 secondi, modello google/gemini-2.5-flash-lite, il predefinito del piano gratuito. Di seguito, il file tedesco che ha scritto e cosa dice kaeris check al riguardo.

Risultato tedescotranslations/translations.csv

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 checkexit code 0

$ kaeris check --source translations.csv --langs de
✓ de: complete & placeholder-safe
✓ all locales complete & placeholder-safe

Cosa fa KAERIS con esso

Stesse colonne, più lingue
Le colonne chiave e sorgente vengono mantenute; ogni lingua di destinazione è una nuova colonna. Nel terminale il risultato viene scritto in translations/localization.csv accanto alla sorgente, e kaeris check lo legge da lì.
Celle sicure per fogli di calcolo
Le celle dall'aspetto di formule vengono scritte come testo. Vedi la pagina Giochi per il lato del game engine.
Controllo gratuito per questo formato
Il controllo gratuito su /check legge questo formato e viene eseguito senza chiave o account. Anche il comando da terminale kaeris check lo legge: gestisce tutti i 13 formati da kaeris 0.2.35, con le stesse regole e nulla inviato da nessuna parte.

Traduci il tuo file Controlla i tuoi file gratuitamente

Eseguilo in tre passaggi

Installa la CLI
Esegui pip install kaeris.
Traduci il foglio
Esegui kaeris translate localization.csv --langs de,ja,fr.
Controlla il risultato
Esegui kaeris check --source localization.csv --langs de,ja,fr oppure carica il file sulla pagina di controllo gratuito: entrambi leggono la colonna di ogni lingua.

pip install kaeris
kaeris translate localization.csv --langs de,ja,fr --verify

Domande

Funziona per Godot e Unity?

Il formato è colonna chiave, colonna sorgente, colonne lingua, come previsto da quei motori. Vedi la pagina Giochi.

Una cella che inizia con = verrà eseguita come formula?

No. Tali celle vengono scritte in modo che un foglio di calcolo le mostri come testo.

È gratuito?

Sì, senza account: 10.000 caratteri per file e fino a 8 lingue per esecuzione. Una chiave API gratuita aumenta il limite di file a 50.000 caratteri. A vita costa $79 una tantum, sulla tua chiave OpenRouter; i piani mensili partono da $19. Prezzi

Posso eseguirlo dal terminale o in CI?

Sì. pip install kaeris, quindi kaeris translate localization.csv --langs de,ja. La GitHub Action esegue la stessa traduzione in una pull request. Documentazione CLI · GitHub Action

Continua

Riferimento CLI · Riferimento Check · Traduci nel browser · Controllo gratuito · Converti formati · Pseudo-localizzazione

Altri formati: JSON · YAML · .po · ARB · XLIFF · .strings · .xcstrings · .properties · .resx · Markdown · Fluent · Android XML