Java-, INI-, Fluent- und PHP-Dateien übersetzen

Auf dieser Seite sind vier Ressourcenformate zusammengefasst, denn für alle gilt: Schlüssel und Struktur bleiben erhalten, nur die Werte ändern sich. Jedes Format wird bis zu 4 MB unterstützt. Für jedes gelten eigene Regeln für Anführungszeichen und Platzhalter, die weiter unten aufgeführt sind. Alle vier Formate enthalten eine Sprache pro Datei.

Java-Properties (.properties)

Schlüssel, Trennzeichen (= oder :), Kommentare und Leerzeilen bleiben unverändert. MessageFormat-Platzhalter wie {0} und {0,number,currency} behalten ihren Index und Formattyp. Das Bundle wird als UTF-8 eingelesen und geschrieben. Speichern Sie ältere Bundles in ISO-8859-1 zuerst als UTF-8. Werte, die mit einem abschließenden Backslash in der nächsten Zeile fortgesetzt werden, werden noch nicht unterstützt. Übersetzt wird nur die erste Zeile. Stellen Sie daher vor dem Upload jeden Wert auf eine Zeile.

INI, Joomla, Inno Setup und .lang (.ini, .isl, .lang)

Schlüssel, [Abschnitte], Kommentare und Anführungszeichen bleiben unverändert. Die Datei wird Zeile für Zeile neu geschrieben, sodass nicht zu übersetzende Zeilen bytegenau erhalten bleiben. Werte in Anführungszeichen bleiben in Anführungszeichen. Anführungszeichen innerhalb einer Übersetzung werden genauso maskiert wie in der jeweiligen Zeile, auch Joomla-"_QQ_". Werte ohne Anführungszeichen werden wörtlich geschrieben, da ein Anführungszeichen in Inno Setup sonst Teil des Textes wäre. Ein INI-Wert steht in einer Zeile: Zeilenumbrüche in der Übersetzung werden durch Leerzeichen ersetzt. Dateien, die nicht UTF-8 sind (Inno-Setup-Dateien verwenden häufig Windows-1252), werden abgelehnt, statt konvertiert zu werden. Speichern Sie sie daher zuerst als UTF-8.

Fluent (.ftl)

Wird von Firefox, Thunderbird und vielen Apps verwendet. Nachrichten-IDs, Attributnamen und Termnamen werden exakt wie übermittelt zurückgegeben. Variablen wie { $count } bleiben geschützt. Jede Plural- oder Auswahlvariante ([one], *[other]) wird als eigener Text übersetzt, während die Variantenschlüssel unverändert bleiben. Die Datei wird nicht neu formatiert: Jede Übersetzung wird an der Stelle des Originaltexts eingefügt. Ein wörtlicher Klammerausdruck oder eine Zeile, die mit [, * oder einem Punkt beginnt, wird maskiert, damit die Datei gültig bleibt.

PHP-Sprachdateien (.php)

Für Sprachdateien von Laravel, Symfony, CodeIgniter und PrestaShop: return [ ... ] oder array( ... ) mit Nachrichten, $lang[...]-Zuweisungen und $_MODULE-Strings. Nur einfache Stringwerte werden geändert. Array-Schlüssel, Funktionsargumente, Verkettungen, Heredocs und jeder sonstige Code bleiben exakt wie zuvor. Die Anführungszeichen jedes Strings bleiben erhalten. Platzhalter wie :attribute, {field}, %s und $name bleiben unverändert. PHP-Dateien, die keine Sprachdateien sind, werden abgelehnt, statt ihren Zweck zu erraten: AI Glot übersetzt keinen Code. Ein Laravel-Plural wie "one apple|:count apples" ist ein einfacher String. Prüfen Sie daher, wie viele Formen Ihre Sprache im Ergebnis benötigt.

Gut zu wissen

• Eine Zielsprache pro Upload gilt für alle vier Formate. Wenn Sie zwei Sprachen angeben, übersetzt der Plan eine davon und weist darauf hin. Führen Sie die Übersetzung für jede Sprache einmal aus. Ihr Glossar wird übernommen, sodass in der deutschen Datei dieselben Begriffe wie in der französischen verwendet werden.
• Mehrere Dateien auf einmal. Legen Sie einen lang-Ordner in eine ZIP-Datei, um ihn in einem Auftrag übersetzen zu lassen.
• Ausgabefilter. Für diese Formate nicht verfügbar: Die gesamte Datei wird zurückgegeben.
• Größenlimit. Für alle vier Formate gilt ein Limit von 4 MB.

Verwandte Themen

• YAML und TOML, JSON und gettext PO für weitere Lokalisierungsformate.
• Alle Dateiformate