Dateien und Formate
Sehen Sie alle Dateiformate, die AI Glot akzeptiert, die jeweilige Größenobergrenze, welche Struktur beim Roundtrip erhalten bleibt und wie Sie einen Export vorbereiten, der sauber re-importiert werden kann.
AI Glot akzeptiert zwölf Formatfamilien. Unabhängig davon, was Sie hochladen, gilt das Versprechen: Die Wörter ändern sich, die Struktur nicht, sodass die Datei genau dorthin zurückkehrt, woher sie kam.
Was Sie hochladen können
Die Größenobergrenzen gelten pro Format, nicht global. Ein Limit, das für eine Tabellenkalkulation funktioniert, wäre für eine Locale-Datei viel zu großzügig, da dort bereits einige Megabyte einen enormen Katalog darstellen.
| Format | Erweiterungen | Obergrenze |
|---|---|---|
| CSV | .csv | 60 MB |
| Excel | .xlsx | 50 MB |
| Archiv | .zip | 20 MB |
| XLIFF | .xlf, .xliff | 12 MB |
| Android resources | .xml | 12 MB |
| .NET resources | .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 ihre Obergrenze überschreitet, wird abgelehnt, bevor Bytes gespeichert werden. Ein zu großer Upload kostet Sie also nichts außer der Zeit, es zu bemerken.
Was den Roundtrip übersteht
Struktur ist keine Dekoration: Sie macht das Ergebnis nutzbar. Jede Familie hat ihre eigene Definition davon, was sich nicht ändern darf.
| Familie | Wird exakt beibehalten |
|---|---|
| CSV, Excel | Spaltenreihenfolge, Identifikatoren, Preise, URLs, Leerzeilen, Whitespace |
| JSON, YAML | Jeder Key, Verschachtelungsebene, Array-Reihenfolge, Einrückung und interpolierte Variable |
| XLIFF | Lokalisierungseinheiten, Platzhalter und Inline-Markup |
| gettext | Message-IDs, Kontexte und Pluralformen |
| Android, iOS, .NET, Java | Resource-Keys und deren Format-Specifier |
| Untertitel | Cue-Nummerierung und Zeitstempel |
| Archiv | Der Ordnerbaum und jeder darin enthaltene Dateiname |
Keys sind Struktur, keine Wörter. Eine übersetzte JSON-Datei kann direkt in das Repository zurückgeführt werden, da sich außerhalb der Werte nichts verschoben hat.
Länge pro Zelle
Jeder einzelne für die Übersetzung ausgewählte Quellwert kann bis zu 50.000 Unicode-Zeichen enthalten. Teilen Sie längere HTML- oder redaktionelle Inhalte vor dem Upload in mehrere Zeilen oder kleinere Felder auf.
Ein übersetzter Wert ist oft länger als das Original. Daher hält AI Glot über der Eingabekapazität zusätzlichen Speicherplatz für die fertige Datei bereit.
Ein Archiv wird zudem danach beurteilt, wie viele Werte seine enthaltenen Dateien insgesamt aufweisen, nicht nur nach der 20 MB Obergrenze: Eine Übersetzung, die weit unter diesem Limit liegt, kann dennoch abgelehnt werden, wenn die Dateien kombiniert zu viele zu übersetzende Werte enthalten. Teilen Sie ein großes Archiv in diesem Fall in kleinere auf.
Vorbereitung eines Tabellen-Exports
CSV und Excel sind die zwei Formate, die meist manuell erstellt werden, und die zwei, bei denen ein unachtsamer Export später die meisten Probleme verursacht.
Stabile Identifikatoren beibehalten
Fügen Sie den Key hinzu, den Ihr Zielsystem zum Abgleich von Zeilen verwendet, wie eine Produkt-ID oder eine Datensatz-ID, und schließen Sie diesen von der Übersetzung aus.
Spalten eindeutige Namen geben
Ersetzen Sie leere oder doppelte Header vor dem Upload. description_en und description_fr sind wesentlich einfacher zuzuordnen als zwei Spalten, die beide description heißen.
CSV als UTF-8 exportieren
Wählen Sie in Ihrem Tabellenprogramm die Option UTF-8 CSV. Das Umbenennen einer Dateierweiterung konvertiert nicht den Inhalt. Sie müssen jedoch gar nicht mehr konvertieren, da .xlsx direkt akzeptiert wird.
Eine Quellkopie behalten
Die Struktur bleibt erhalten, aber der ursprüngliche Export ist immer noch das sicherste Backup, falls Ihr Zielsystem einen Import aus eigenen Gründen ablehnt.
CSV-Besonderheiten
| Anforderung | Unterstütztes Verhalten |
|---|---|
| Kodierung | Strikt UTF-8 |
| Trennzeichen | Komma oder Semikolon, wird automatisch erkannt |
| Zeilenenden | LF, CRLF oder CR |
| Quotierung | RFC 4180, inklusive eingebetteter Kommas und Zeilenumbrüche |
| Header | Jede Spalte benötigt einen eindeutigen, nicht leeren Header |
| Zeilen | Mindestens eine Datenzeile; jede Zeile muss der Breite des Headers entsprechen |
Abgelehnte Dateien
Der Browser wendet dieselben Strukturregeln wie die Translation Engine an, bevor der Upload startet. So schlägt eine fehlerhafte Datei sofort fehl und nicht erst nach mehreren Minuten. Es werden leere Dateien, ungültiges UTF-8, nicht geschlossene oder nicht maskierte Anführungszeichen, leere oder doppelte Header, fehlende Datenzeilen, Zeilen mit falscher Spaltenanzahl, nicht unterstützte Erweiterungen sowie jede Datei über ihrer Format-Obergrenze abgelehnt.
Über die API erfolgen dieselben Ablehnungen als unsupported_format und file_too_large.