.CSV (Strings)

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

Dateierweiterungen	.csv
API-Erweiterung	csv
Importieren	Ja
Exportieren	Ja
Unterstützung für Pluralformen	Ja
Unterstützung für Beschreibungen	Ja
Format-Optionen Diese Optionen können angegeben werden, wenn eine Datei hochgeladen und/oder Herunterladen wird. Abhängig von der hochladen/Herunterladen-Methode (API, CLI, Repo-Sync usw.) können diese in Query-Parametern `hochladen`, `Herunterladen` oder in der `phrase.yml`-Konfigurationsdatei 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 export_key_id key_id_column

CSV (comma-separated values) ist ein beliebtes Format, das hauptsächlich für die Datenübertragung in verschiedenen Anwendungen und Programmen verwendet wird. In einer CSV-Datei ist jede Zeile ein Datensatz. Jeder Datensatz besteht aus einigen Feldern, die durch Kommas getrennt sind. Stellen Sie vor dem importieren sicher, dass die CSV-Dateien drei Felder für eine einzelne Zeile enthalten, die Ausgangssprache-Content, Übersetzung und Kommentare (optional) darstellen.

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

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	,
Beschreibung	Zeichen, das zum Trennen von Spalten verwendet wird.

Identifikator	quote_char
Typ	Zeichenfolge
Hochladen	Ja
Herunterladen	Nein
Standard	"
Beschreibung	Zeichen, das verwendet wird, um Zeilenumbrüche und Spaltentrennzeichen in Kostenvoranschlag zu setzen.

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 die Key ID zusammen mit Keys und Übersetzungen.

Identifikator	custom_metadata_columns
Typ	Hash
Hochladen	Ja
Herunterladen	Ja
Standard	[leer]
Beschreibung	HashMap von individuellen Metadaten-Werten, die importiert oder exportiert werden müssen: Key = Name der individuellen Metadateneigenschaft, wie in Phrase Strings definiert. Wert = 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.

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

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

Codebeispiel

boolean_key,"--- true
"
empty_string_translation,""
key_with_description,Check it out! This key has a description! (At least in some formats),This is the amazing description for this key!
key_with_line-break,"This translations contains
a line-break."
nested.deeply.key,"Wow, this key is nested even deeper."
nested.key,This key is nested inside a namespace.
null_translation,
pluralized_key.one, "Only one kitten found."
pluralized_key.other,"Wow, you have %s kittens!"
pluralized_key.zero,"You have no kittens."
sample_collection,"---
- first item
- second item
- third item
"
simple_key,Just a simple key with a simple message.
unverified_key,This translation is not yet verified and waits for it. (In some formats we also export this status)

Dateistruktur

Eine typische .CSV-Dateistruktur:

1 (Key column), 2 (Translation column), 3 (Comment column)
app_title,      My Software Project,    This is the main title
apples.zero,    one apple,              my comment
...

Konfigurationsbeispiel

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

push:
    sources:
        - file: "./multi.csv"
          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 column), 2 (Translation column), 3 (Comment column)
messages.zero,  No messages received,
messages.one,   One message received,
messages.other,  %s messages received,