Reiner Text

Übersetze eine Textdatei Zeile für Zeile, sodass jede übersetzte Zeile an der Position der entsprechenden Quellzeile bleibt.

Reine Textdateien wie App-Store-Beschreibungen und Versionshinweise enthalten weder Markup noch Schlüssel. Der Dateihandler txt übersetzt jede Zeile einzeln und schreibt die Übersetzung an dieselbe Stelle zurück. So hat die Zieldatei genauso viele Zeilen wie die Quelldatei.

Zeilen und Einheiten #

Zum Beispiel:

text
Plan your trips offline.

  • Download maps for any region
  • Share routes with friends

Jede Zeile mit Text wird zu einer Übersetzungseinheit mit der Zeilennummer als Schlüssel. Hier werden die Zeilen 1, 3 und 4 übersetzt. Leere Zeilen und Zeilen, die nur Leerzeichen oder Tabulatoren enthalten, bilden keine Einheit und werden unverändert kopiert.

Leerzeichen und Tabulatoren am Anfang und Ende einer Zeile bleiben außerhalb der Einheit. So bleiben Einrückungen und nachgestellte Leerzeichen bei der Übersetzung erhalten. Übersetzt wird nur der Text dazwischen.

Rekonstruierte Ausgabe #

Bei der Ausgabe wird der Text jeder Zeile der aktuellen Quelldatei ersetzt. Alles andere bleibt Byte für Byte erhalten: Leerzeilen, Einrückungen und die jeweiligen Zeilenenden (LF oder CRLF, auch gemischt). Auch ob die Datei mit einem Zeilenumbruch endet, bleibt unverändert. Die Zieldatei hat daher genauso viele Zeilen wie die Quelldatei.

Leerzeichen und Zeilenumbrüche vor und nach einer Übersetzung werden entfernt. Zeilenumbrüche innerhalb der Übersetzung werden jeweils durch ein einzelnes Leerzeichen ersetzt, sodass durch die Übersetzung keine zusätzliche Zeile entsteht. Bei einer leeren Übersetzung schlägt das Zusammensetzen der Ausgabe für diese Sprache fehl.

Wie bei SubRip-Untertiteleinträgen richtet sich die Wiederverwendung nach dem unveränderten Zeilentext und seiner Position in der Datei. Eine geänderte Einrückung erfordert keine erneute Übersetzung. Werden Zeilen hinzugefügt oder entfernt, behalten Zeilen, deren Text nur einmal in der Datei vorkommt, ihre Übersetzung. Zeilen mit mehrfach vorkommendem Text werden dagegen erneut übersetzt. Weicht die Zeilenanzahl einer Zieldatei von der vorherigen Quelldatei ab, lässt sich daraus kein Text wiederverwenden. Bewahre deshalb die vorherige Quelldatei zusammen mit der zugehörigen akzeptierten Zieldatei auf.

Text konfigurieren und kontrollieren #

Die CLI und die GitHub App leiten txt aus .txt ab. Eine .txt-Datei wird nur von einem Dateieintrag erfasst, dessen Muster auf .txt endet, etwa metadata/en/*.txt, oder der "format": "txt" festlegt. Ein Eintrag mit "format": "txt" wählt ausschließlich .txt-Dateien aus. Ein breit gefasstes Muster wie docs/en/**/* überspringt .txt-Dateien. Dateien wie LICENSE.txt oder requirements.txt werden daher nicht übersetzt; ein späterer Eintrag, der .txt ausdrücklich angibt, kann sie dennoch auswählen. Ebenso überspringt ein breit gefasster Eintrag mit "format": "txt" Bilder und andere Dateien, die keine Textdateien sind. Nutze für die Dateiauswahl die CLI-Konfiguration oder GitHub. Die Eingrenzung auf Schlüssel ist in der CLI nicht verfügbar, da Zeilennummern Positionen und keine stabilen Schlüssel sind.

Jede Zeile wird als eigene Einheit übersetzt. Ein Absatz, der sich über mehrere Zeilen erstreckt, wird daher Zeile für Zeile übersetzt. Schreibe jeden Absatz in eine einzige Zeile, wenn die Zielsprache eine andere Satzstellung erfordert. Kontrolliere den Zieltext dort, wo er verwendet wird: Ein Store-Eintrag oder ein Feld mit Längenbegrenzung kann eine Übersetzung ablehnen, die länger als der Quelltext ist.