Dateien und Formate
Übersicht aller von AI Glot unterstützten Dateiformate, deren Größenbeschränkungen, welche Strukturen beim Roundtrip erhalten bleiben und wie Exporte für einen reibungslosen Re-Import vorbereitet werden.
AI Glot unterstützt zwölf Formatfamilien. Was auch immer Sie hochladen, unser Versprechen gilt: Die Texte ändern sich, die Struktur bleibt unverändert – damit die Datei nahtlos an ihren Ursprungsort zurückgeführt werden kann.
Unterstützte Upload-Formate
Größenbeschränkungen gelten pro Format, nicht global. Ein Limit, das für eine Tabellenkalkulation sinnvoll ist, wäre für eine Lokalisierungsdatei viel zu hoch gegriffen, da dort schon wenige Megabyte einen riesigen Katalog darstellen.
| Format | Dateiendungen | Limit |
|---|---|---|
| CSV | .csv | 60 MB |
| Excel | .xlsx | 50 MB |
| Archiv | .zip | 20 MB |
| XLIFF | .xlf, .xliff | 12 MB |
| Android-Ressourcen | .xml | 12 MB |
| .NET-Ressourcen | .resx | 12 MB |
| JSON | .json, .arb | 8 MB |
| YAML | .yaml, .yml | 4 MB |
| gettext | .po, .pot | 4 MB |
| iOS-Strings | .strings | 4 MB |
| Java-Properties | .properties | 4 MB |
| Untertitel | .srt | 4 MB |
Eine Datei, die ihr Limit überschreitet, wird abgewiesen, noch bevor Daten gespeichert werden. Ein zu großer Upload kostet Sie also nichts – außer der Zeit, es zu bemerken.
Was beim Roundtrip erhalten bleibt
Struktur ist kein Selbstzweck – sie sorgt dafür, dass das Ergebnis sofort einsatzbereit ist. Jede Formatfamilie definiert eigene Regeln dafür, was unverändert bleiben muss.
| Familie | Exakt beibehalten |
|---|---|
| CSV, Excel | Spaltenreihenfolge, Bezeichner, Preise, URLs, Leerzeilen, Whitespace |
| JSON, YAML | Alle Schlüssel, Verschachtelungsebenen, Array-Reihenfolge, Einrückung und interpolierte Variablen |
| XLIFF | Übersetzungseinheiten (Units), Platzhalter und Inline-Markup |
| gettext | Message-IDs, Kontexte und Pluralformen |
| Android, iOS, .NET, Java | Ressourcenschlüssel und deren Formatspezifizierer |
| Untertitel | Cue-Nummerierung und Timecodes |
| Archiv | Verzeichnisstruktur und alle enthaltenen Dateinamen |
Schlüssel gehören zur Struktur, nicht zum Text. Eine übersetzte JSON-Datei lässt sich direkt wieder ins Repository einfügen, da außerhalb der Werte nichts verändert wurde.
Maximale Länge pro Zelle
Jeder einzelne, zur Übersetzung ausgewählte Quellwert darf bis zu 50.000 Unicode-Zeichen umfassen. Teilen Sie längere HTML- oder Redaktionsinhalte vor dem Hochladen in mehrere Zeilen oder kleinere Felder auf.
Da übersetzter Text häufig länger ist als das Original, hält AI Glot über dem Eingabelimit zusätzlichen Speicherplatz für die fertige Datei bereit.
Vorbereitung eines Tabellen-Exports
CSV und Excel werden meist manuell erstellt – und sind genau die Formate, bei denen ein unachtsamer Export später die meisten Probleme verursacht.
Stabile Bezeichner beibehalten
Fügen Sie den Schlüssel ein, den Ihr Zielsystem zum Abgleich der Zeilen verwendet (z. B. eine Produkt- oder Datensatz-ID), und schließen Sie diesen von der Übersetzung aus.
Eindeutige Spaltennamen vergeben
Ersetzen Sie leere oder doppelte Kopfzeilen vor dem Upload. description_en und description_fr lassen sich deutlich eindeutiger zuordnen als zwei Spalten, die beide description heißen.
CSV als UTF-8 exportieren
Wählen Sie in Ihrem Tabellenkalkulationsprogramm die Option „CSV (UTF-8)“. Das bloße Umbenennen der Dateiendung konvertiert den Inhalt nicht. Eine Konvertierung ist jedoch gar nicht mehr nötig, da .xlsx direkt unterstützt wird.
Sicherheitskopie des Originals aufbewahren
Die Struktur bleibt zwar erhalten, der ursprüngliche Export ist jedoch das sicherste Rollback, falls Ihr Zielsystem den Re-Import aus eigenen Gründen ablehnt.
Spezifikationen für CSV
| Anforderung | Unterstütztes Verhalten |
|---|---|
| Codierung | Striktes UTF-8 |
| Trennzeichen | Komma oder Semikolon, automatische Erkennung |
| Zeilenumbrüche | LF, CRLF oder CR |
| Maskierung (Quoting) | RFC 4180, einschließlich eingebetteter Kommas und Zeilenumbrüche |
| Kopfzeilen | Jede Spalte benötigt eine eindeutige, nicht-leere Kopfzeile |
| Datenzeilen | Mindestens eine Datenzeile; jede Zeile muss der Spaltenanzahl der Kopfzeile entsprechen |
Abgelehnte Dateien
Der Browser prüft dieselben strukturellen Regeln wie die Übersetzungs-Engine noch vor Beginn des Uploads. So werden fehlerhafte Dateien sofort gemeldet und nicht erst nach mehreren Minuten. Abgewiesen werden leere Dateien, ungültiges UTF-8, nicht geschlossene oder falsch maskierte Anführungszeichen, leere oder doppelte Kopfzeilen, fehlende Datenzeilen, Zeilen mit falscher Spaltenanzahl, nicht unterstützte Dateiendungen sowie Dateien, die das jeweilige Formatlimit überschreiten.
Über die API werden dieselben Ablehnungen als unsupported_format und file_too_large zurückgegeben.