.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	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 (durch Kommata getrennte Werte) ist ein beliebtes Format für Datenübertragungen in verschiedenen Anwendungen und Programmen. In einer CSV-Datei ist jede Zeile ein Datensatz. Jeder Eintrag besteht aus ein paar Feldern, die durch Kommata getrennt sind. Stelle vor dem Import sicher, dass die CSV-Dateien drei Felder für eine Zeile enthalten, die Inhalt, Übersetzung und Kommentare in der Ausgangssprache repräsentiert (optional).

Der Parameter Sprache_Mapping (Typ Hashmap) ist erforderlich, um anzugeben, welche Spalte im Dokument jeder Sprache entspricht. Beispiele siehe Beispiel Konfigurationsdatei und API Dokumentation für uploads.

Format-Optionen

Identifikator	key_index
Typ	Ganzzahl
Hochladen	Ja
Herunterladen	Nein
Standard	[leer]
Beschreibung	Index der Spalte mit den Key Names. Spaltenindizes beginnen bei 1.

Identifikator	comment_index
Typ	Ganzzahl
Hochladen	Ja
Herunterladen	Nein
Standard	[leer]
Beschreibung	Index der Spalte mit Beschreibung für den Key. Spaltenindizes beginnen bei 1.

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

Identifikator	max_characters_allowed_column
Typ	Ganzzahl
Hochladen	Ja
Herunterladen	Nein
Standard	[leer]
Beschreibung	Index der Spalte, die eine maximale Zeichenanzahl 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 für Kostenvoranschläge und Spaltentrennzeichen 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 soll.

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 sowie Keys und Übersetzungen.

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

Identifikator	custom_metadata_columns
Typ	Hash
Hochladen	Ja
Herunterladen	Ja
Standard	[leer]
Beschreibung	HashMap mit benutzerdefinierten Metadaten, die importiert oder exportiert werden müssen: Key = Name der benutzerdefinierten Metadateneigenschaft, wie in Phrase Strings definiert. Wert = Spaltenindex (1, 2, 3 usw.), in dem sich die Eigenschaft in der importierten Datei befindet/in dem sich die Eigenschaft in der exportierten Datei befinden soll.

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

Identifikator	key_id_column
Typ	Ganzzahl
Hochladen	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, sieh es dir an! This key has a description! (Zumindest in einigen Formaten).Dies ist die erstaunliche Beschreibung für diesen Key!
key_with_line-break,"This translations contain\na line-break.",
ein Zeilenumbruch."
"nested.deeply.key": "Wow, this key is nested even deeper."
nested.key,Dieser Key ist in einem Namespace verschachtelt.
null_translation,
pluralized_key.one, "Nur ein Kätzchen gefunden."
"pluralized_key.other": "Wow, you have %s kittens!",
"pluralized_key.zero": "Du hast keine Kätzchen."
sample_collection,"---
- erstes Element
- zweites Element
- drittes Element
"
simple_key,Nur ein einfacher Key mit einer einfachen Nachricht.
unverified_key,Diese Übersetzung ist noch nicht überprüft und wartet darauf. (In einigen Formaten exportieren wir auch diesen Status)

Dateistruktur

Eine typische .CSV-Dateistruktur:

1 (Key), 2 (Übersetzungsspalte), 3 (kommentieren)
app_title, Mein Software Projekt, Dies ist der Haupttitel
apples.zero, one apple, mein kommentieren
...

Konfigurationsbeispiel

Beispiel für den push Bereich einer .phrase.yml für .CSV Dateien:

push:
    sources:
        - Datei: „./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), 2 (Übersetzungsspalte), 3 (kommentieren)
messages.zero, Keine Nachrichten empfangen,
messages.one, Eine Nachricht empfangen,
messages.other, %s messages received,