Lokalisierungs-CSV-Dateien übersetzen
Eine CSV-Datei für Spielelokalisierung hat eine Schlüsselspalte und eine Spalte pro Sprache. KAERIS liest den Schlüssel und die Quellspalte und fügt eine Spalte für jede Zielsprache hinzu.
KAERIS hat diese Seite übersetzt und jede Zeile durch Rückübersetzung geprüft. Ein Muttersprachler hat sie noch nicht überprüft. Englisches Original
Wie eine Lokalisierungs-CSV aufgebaut ist
Die erste Spalte ist der Schlüssel, die zweite der Quelltext; die Kopfzeile benennt die Spalten (keys,en). Zellen mit Kommas oder Zeilenumbrüchen werden in Anführungszeichen gesetzt. Völlig leere Zeilen werden ignoriert.
keys,en GREETING,"Welcome back, %s!" ITEMS,"You have {count} items, %d of them new" QUIT,Quit game
Worauf Sie bei CSV-Übersetzungen achten sollten
Eine Spalte pro Sprache
Die Ausgabe enthält die Schlüsselspalte, die Quellspalte, dann
de,jaund so weiter. Ihre Schlüssel- und Quellspaltennamen bleiben erhalten.Formeln
Eine Zelle, die mit
=,+,-oder@beginnt, wird mit einem führenden Apostroph geschrieben, damit Excel Text anzeigt, anstatt eine Formel auszuführen.Printf- und Klammer-Variablen
%s,%dund{count}in einer Zelle werden mit der Quelle verglichen. Im realen Durchlauf unten kamen alle drei zurück.Anführungszeichen
Kommas und Anführungszeichen innerhalb einer Zelle werden von einem CSV-Writer in Anführungszeichen gesetzt, sodass eine übersetzte Zelle nicht in die nächste Spalte überlaufen kann.
Ein realer Durchlauf: ins Deutsche übersetzt und geprüft
Ein realer Durchlauf, 27. Oktober 2026, nichts von Hand bearbeitet: kaeris translate translations.csv --langs de mit kaeris 0.2.35, 2,5 Sekunden, Modell google/gemini-2.5-flash-lite, der Standard der kostenlosen Stufe. Unten die deutsche Datei, die es geschrieben hat, und was kaeris check dazu sagt.
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
Was KAERIS damit macht
Gleiche Spalten, mehr Sprachen
Die Schlüssel- und Quellspalten bleiben erhalten; jede Zielsprache ist eine neue Spalte. Im Terminal wird das Ergebnis neben der Quelle in
translations/localization.csvgeschrieben, undkaeris checkliest es von dort.Tabellenkalkulationssichere Zellen
Formelähnliche Zellen werden als Text geschrieben. Sehen Sie sich die Spiele-Seite für die Seite der Spiel-Engines an.
Kostenlose Prüfung für dieses Format
Die kostenlose Prüfung auf /check liest dieses Format und läuft ohne Schlüssel oder Konto. Der Terminalbefehl
kaeris checkliest es ebenfalls: Er verarbeitet alle 13 Formate seit kaeris 0.2.35, mit denselben Regeln und ohne Übertragung von Daten.
In drei Schritten ausführen
CLI installieren
Führen Sie
pip install kaerisaus.Die Tabelle übersetzen
Führen Sie
kaeris translate localization.csv --langs de,ja,fraus.Das Ergebnis prüfen
Führen Sie
kaeris check --source localization.csv --langs de,ja,fraus oder laden Sie die Datei auf der kostenlosen Prüfseite hoch: Beide lesen die Spalte jeder Sprache.
pip install kaeris kaeris translate localization.csv --langs de,ja,fr --verify
Fragen
Funktioniert es für Godot und Unity?
Das Format ist Schlüsselspalte, Quellspalte, Sprachspalten, wie diese Engines es erwarten. Sehen Sie sich die Spiele-Seite an.
Wird eine Zelle, die mit = beginnt, als Formel ausgeführt?
Nein. Solche Zellen werden so geschrieben, dass eine Tabellenkalkulation sie als Text anzeigt.
Ist es kostenlos?
Ja, ohne Konto: 10.000 Zeichen pro Datei und bis zu 8 Sprachen pro Lauf. Ein kostenloser API-Schlüssel erhöht das Dateilimit auf 50.000 Zeichen. Lebenslang kostet es einmalig 79 $, mit deinem eigenen OpenRouter-Schlüssel; monatliche Pläne beginnen bei 19 $. Preise
Kann ich es vom Terminal oder in CI ausführen?
Ja. pip install kaeris, dann kaeris translate localization.csv --langs de,ja. Die GitHub Action führt dieselbe Übersetzung in einem Pull Request aus. CLI-Dokumentation · GitHub Action
Weiter geht's
CLI-Referenz · Check-Referenz · Im Browser übersetzen · Kostenlose Prüfung · Formate konvertieren · Pseudo-Lokalisierung
Andere Formate: JSON · YAML · .po · ARB · XLIFF · .strings · .xcstrings · .properties · .resx · Markdown · Fluent · Android XML