.TXT (Strings)

Inhalte werden von Phrase Language AI maschinell aus dem Englischen übersetzt.

Dateierweiterungen	.txt, .tsv
API-Erweiterung	.txt, .tsv
Import	Ja
Exportieren	Ja
Unterstützung für Pluralformen	Ja
Unterstützung für Beschreibungen	Ja
Format-Optionen Diese Optionen können beim Hochladen und/oder Herunterladen einer Datei angegeben werden. Abhängig von der Methode für Upload/Download (API, CLI, Repo-Sync etc.) können diese in Query-Parametern `Upload`, `Download` oder in der Konfigurationsdatei `phrase.yml` angegeben werden.	key_index comment_index tag_column max_characters_allowed_column column_separator quote_char header_content_row enable_pluralization export_tags export_max_characters_allowed custom_metadata_columns

TXT speichert reine Textinformationen ohne eingebettete Formatierungsoptionen wie Fett, Kursiv oder Bilder.

Der Parameter locale_mapping (vom Typ Hashmap) ist erforderlich, um anzugeben, welche Spalte im Dokument welcher Sprache entspricht. Beispiele sind im Konfigurationsdatei-Beispiel und in der API-Dokumentation für Uploads zu finden.

Format-Optionen

Identifikator	key_index
Typ	integer
Hochladen	Ja
Herunterladen	Nein
Standard	[leer]
Beschreibung	Index der Spalte, die die Key-Namen enthält. Spaltenindizes beginnen bei 1.

Identifikator	comment_index
Typ	integer
Hochladen	Ja
Herunterladen	Nein
Standard	[leer]
Beschreibung	Index der Spalte, die die Beschreibung für den Key enthält. Spaltenindizes beginnen bei 1.

Identifikator	tag_column
Typ	integer
Hochladen	Ja
Herunterladen	Nein
Standard	[leer]
Beschreibung	Index der Spalte, die ein Tag für den Key enthält. Spaltenindizes beginnen bei 1.

Identifikator	max_characters_allowed_column
Typ	integer
Hochladen	Ja
Herunterladen	Nein
Standard	[leer]
Beschreibung	Index der Spalte, die eine maximale Anzahl an Zeichen für den Key enthält. Spaltenindizes beginnen bei 1.

Identifikator	column_separator
Typ	Zeichenfolge
Hochladen	Ja
Herunterladen	Nein
Standard	\t
Beschreibung	Zeichen, das zum Trennen von Spalten verwendet wird.

Identifikator	quote_char
Typ	Zeichenfolge
Hochladen	Ja
Herunterladen	Nein
Standard	"
Beschreibung	Zeichen, das zum Quoten von Zeilenumbrüchen und Spaltentrennern verwendet wird.

Identifikator	header_content_row
Typ	Boolean
Hochladen	Ja
Herunterladen	Nein
Standard	false
Beschreibung	Gibt an, ob die erste Zeile nur Header-Informationen enthält und übersprungen werden sollte.

Identifikator	enable_pluralization
Typ	Boolean
Hochladen	Ja
Herunterladen	Nein
Standard	true
Beschreibung	Ermöglicht die Erkennung von pluralisierten Keys. Alle passenden Keys werden als pluralisierte Keys beibehalten.

Identifikator	export_tags
Typ	Boolean
Upload	Nein
Download	Ja
Standard	false
Beschreibung	Exportiert Tags zusammen mit Keys und Übersetzungen.

Identifikator	export_max_characters_allowed
Typ	Boolean
Upload	Nein
Download	Ja
Standard	false
Beschreibung	Exportiert das Zeichenlimit für den Key zusammen mit Keys und Übersetzungen.

Identifikator	custom_metadata_columns
Typ	hash
Hochladen	Ja
Herunterladen	Ja
Standard	[leer]
Beschreibung	HashMap von benutzerdefinierten Metadatenwerten, die importiert oder exportiert werden müssen: Key = Name der individuellen Metadaten-Eigenschaft, wie in Phrase Strings definiert. Value = Spaltenindex (1, 2, 3 usw.), an dem sich die Eigenschaft in der importierten Datei befindet/an dem die Eigenschaft in der exportierten Datei sein sollte.

Codebeispiel

boolean_key    "--- true
"
empty_string_translation    ""
key_with_description    Anschauen! This key has a description! (At least in some formats),This is the amazing description for this key!
key_with_line-break    "Diese Übersetzung enthält
a line-break."
nested.deeply.key    "Wow, dieser Key ist noch tiefer verschachtelt."
nested.key    Dieser Key ist innerhalb eines Namespace verschachtelt.
null_translation    
pluralized_key.one    "Nur ein Kätzchen gefunden."
pluralized_key.other    "Wow, es sind %s Kätzchen vorhanden!"
pluralized_key.zero    "Keine Kätzchen vorhanden."
sample_collection    "---
- first item
- second item
- third item
"
simple_key    Nur ein einfacher Key mit einer einfachen Nachricht.
unverified_key    Diese Übersetzung ist noch nicht überprüft und wartet darauf. (In manchen Formaten exportieren wir auch diesen Status)

Dateistruktur

Eine typische .TXT-Dateistruktur:

1 (Key-Spalte)    2 (Übersetzungsspalte)    3 (Kommentarspalte)
app_title    Mein Software-Projekt    Dies ist der Haupttitel
apples.zero    ein Apfel    mein Kommentar
...

Konfigurationsbeispiel

Ein Beispiel für den Push-Abschnitt einer .Phrase.yml für .CSV-Dateien:

push:
    sources:
        - file: "./multi.txt"
          params:
              update_translations: true
              locale_mapping:
                  en: 2
                  de: 3
              format_options:
                  comment_index: 4
                  tag_column: 5

Pluralformen

Dieses Format verwendet benannte Kategorien, um die verschiedenen Pluralisierungen eines Key zu identifizieren. Folgende Kategorien sind Pluralformen vorbehalten:

.zero | .one | .two | .few | .many | .other

Beispielnamen für korrekt identifizierte, persistierende und markierte pluralisierte Keys:

inbox.messages.notification.one
inbox.messages.notification.other

Dateien sollten dieser Struktur folgen:

1 (Key-Spalte)    2 (Übersetzungsspalte)    3 (Kommentarspalte)
messages.zero    Keine Nachrichten empfangen,
messages.one    Eine Nachricht empfangen,
messages.other    %s Nachrichten empfangen,