.CSV (Strings)

Contenuti tradotti automaticamente dall'inglese con Phrase Language AI.

Estensioni dei file	.csv
Estensione API	csv
Importa	Sì
Esporta	Sì
Supporto forme plurali	Sì
Supporto descrizione	Sì
Opzioni di formato Queste opzioni possono essere specificate quando un file viene caricato e/o Scarica. A seconda del metodo di caricare/Scarica (API, CLI, sincronizzazione Repo ecc.), possono essere specificate nei parametri di query `caricare`, `Scarica` o nel file di configurazione `phrase.yml`.	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 (valori separati da virgola) è un popolare formato di file utilizzato principalmente per il trasferimento di dati in varie applicazioni e programmi. In un file CSV, ogni riga è un record di dati. Ogni record è costituito da alcuni campi separati da virgole. Prima di importare, assicurarsi che i file CSV abbiano tre campi per una singola riga che rappresentano origine contenuto, traduzione e commenti (opzionale).

Il parametro locale_mapping (di tipo hashmap) è richiesto per specificare quale colonna nel documento corrisponde a ciascuna impostazioni locali. Per esempi, vedere l'esempio di file di configurazione e la documentazione API per i caricamenti.

Opzioni di formato

Identificatore	key_index
Tipo	integer
Caricamento	Sì
Download	No
Predefinito	[vuoto]
Descrizione	Indice della colonna contenente i nomi delle chiave. Gli indici delle colonne iniziano da 1.

Identificatore	comment_index
Tipo	integer
Caricamento	Sì
Download	No
Predefinito	[vuoto]
Descrizione	Indice della colonna contenente la descrizione per la chiave. Gli indici delle colonne iniziano da 1.

Identificatore	tag_column
Tipo	integer
Caricamento	Sì
Download	No
Predefinito	[vuoto]
Descrizione	Indice della colonna contenente un tag per la chiave. Gli indici delle colonne iniziano da 1.

Identificatore	max_characters_allowed_column
Tipo	integer
Caricamento	Sì
Download	No
Predefinito	[vuoto]
Descrizione	Indice della colonna contenente un numero massimo di caratteri per la chiave. Gli indici delle colonne iniziano da 1.

Identificatore	column_separator
Tipo	stringa
Caricamento	Sì
Download	No
Predefinito	,
Descrizione	Carattere utilizzato per separare le colonne.

Identificatore	quote_char
Tipo	stringa
Caricamento	Sì
Download	No
Predefinito	"
Descrizione	Carattere utilizzato per racchiudere tra quote le nuove righe e il separatore di colonna.

Identificatore	header_content_row
Tipo	booleano
Caricamento	Sì
Download	No
Predefinito	false
Descrizione	Indica se la prima riga contiene solo informazioni di intestazione e deve essere saltata.

Identificatore	enable_pluralization
Tipo	booleano
Caricamento	Sì
Download	No
Predefinito	vero
Descrizione	Abilita il rilevamento di chiavi pluralizzate. Tutte le chiavi corrispondenti verranno mantenute come chiavi pluralizzate.

Identificatore	export_tags
Tipo	booleano
Caricamento	No
Download	Sì
Predefinito	false
Descrizione	Esporta tag insieme a chiavi e traduzioni.

Identificatore	export_max_characters_allowed
Tipo	booleano
Caricamento	No
Download	Sì
Predefinito	false
Descrizione	Esporta l'ID chiave insieme a chiavi e traduzioni.

Identificatore	custom_metadata_columns
Tipo	hash
Caricamento	Sì
Download	Sì
Predefinito	[vuoto]
Descrizione	HashMap di valori Personalizzato metadati che devono essere importati o esportati: chiave = Nome della proprietà di metadati Personalizzato, come definito in Phrase Strings. Valore = Indice della colonna (1, 2, 3, ecc.) dove si trova la proprietà nel file importato/dove la proprietà dovrebbe trovarsi nel file esportato.

Identificatore	export_key_id
Tipo	booleano
Caricamento	No
Download	Sì
Predefinito	false
Descrizione	Esporta il limite di carattere della chiave insieme a chiavi e traduzioni.

Identificatore	key_id_column
Tipo	integer
Caricamento	No
Download	Sì
Predefinito	[vuoto]
Descrizione	Indice della colonna contenente l'ID per la chiave. Gli indici delle colonne iniziano da 1.

Esempio di codice

boolean_key,"--- true
"
empty_string_translation,""
key_with_description,Check it out! Questa chiave ha una descrizione! (Almeno in alcuni formati),Questa è la fantastica descrizione per questa chiave!
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 alcuni formati esportiamo anche lo stato)

Struttura del file

Una tipica struttura di file .CSV:

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
...

Esempio di configurazione

Un esempio per la sezione push di un file .phrase.yml per file .CSV:

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

Forme plurali

Questo formato utilizza categorie denominate per identificare le diverse pluralizzazioni di una chiave. Le categorie seguenti sono riservate alle forme plurali:

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

Esempi di nomi per chiavi pluralizzate correttamente identificate, persistenti e contrassegnate:

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

I file dovrebbero seguire questa struttura:

1 (Key column), 2 (Translation column), 3 (Comment column)
messages.zero,  No messages received,
messages.one,   One message received,
messages.other,  %s messages received,