.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 heruntergeladen wird. Je nach Upload-/Download-Methode (API, CLI, Repo-Synchronisierung usw.) können sie in Abfrageparametern `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 Dateiformat, das hauptsächlich für den Datenaustausch 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 Import sicher, dass die CSV-Dateien drei Felder für eine einzelne Zeile haben, die den Quellinhalt, die Übersetzung und Kommentare (optional) darstellen.

Der locale_mapping Parameter (vom Typ Hashmap) ist erforderlich, um anzugeben, welche Spalte im Dokument jeder Sprache entspricht. Für Beispiele siehe die Beispiel der Konfigurationsdatei und die API-Dokumentation für Uploads.

Format-Optionen

Identifikator	key_index
Typ	integer
Hochladen	Ja
Herunterladen	Nein
Standard	[leer]
Beschreibung	Index der Spalte, die die Schlüsselbezeichnungen 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 Schlüssel 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 Schlüssel 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 von Zeichen für den Schlüssel enthält. Spaltenindizes beginnen bei 1.

Identifikator	column_separator
Typ	Zeichenfolge
Hochladen	Ja
Herunterladen	Nein
Standard	,
Beschreibung	Zeichen, das verwendet wird, um Spalten zu trennen.

Identifikator	quote_char
Typ	Zeichenfolge
Hochladen	Ja
Herunterladen	Nein
Standard	"
Beschreibung	Zeichen, das verwendet wird, um Zeilenumbrüche und Spaltentrenner zu kennzeichnen.

Identifikator	header_content_row
Typ	Boolean
Hochladen	Ja
Herunterladen	Nein
Standard	false
Beschreibung	Gibt an, ob die erste Zeile nur Headerinformationen 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 Schlüsseln und Übersetzungen.

Identifikator	export_max_characters_allowed
Typ	Boolean
Upload	Nein
Download	Ja
Standard	false
Beschreibung	Exportiert die Schlüssel-ID zusammen mit Schlüsseln 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: Schlüssel = Name der benutzerdefinierten Metadateneigenschaft, wie in Phrase Strings definiert. Wert = Spaltenindex (1, 2, 3, usw.), wo sich die Eigenschaft in der importierten Datei befindet/wo sich die Eigenschaft in der exportierten Datei befinden sollte.

Identifikator	export_key_id
Typ	Boolean
Upload	Nein
Download	Ja
Standard	false
Beschreibung	Exportiert das Zeichenlimit des Schlüssels zusammen mit Schlüsseln und Übersetzungen.

Identifikator	key_id_column
Typ	integer
Hochladen	Nein
Download	Ja
Standard	[leer]
Beschreibung	Index der Spalte, die die ID für den Schlüssel 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 einigen Formaten exportieren wir auch diesen 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-Bereich 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,