.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	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 virgole) è un formato di file popolare 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 pochi campi separati da virgole. Prima di importare, assicurati che i file CSV abbiano tre campi per una singola riga che rappresentano contenuto d’origine, traduzione e commenti (facoltativo).

Il parametro impostazioni locali_mapping (di tipo hashmap) è necessario per specificare quale colonna del documento corrisponde a ciascuna impostazione locale. Per esempi, vedere l'esempio di file di configurazione e la documentazione API for uploads.

Opzioni di formato

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

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

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

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

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

Identificatore	quote_char
Tipo	stringa
Caricamento	Sì
Download	No
Predefinito	"
Descrizione	Carattere che viene usato per il preventivo di ritorni a capo e separazione di colonne.

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 tags insieme a chiavi e traduzioni.

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

Identificatore	custom_metadata_columns
Tipo	hash
Caricamento	Sì
Download	Sì
Predefinito	[vuoto]
Descrizione	HashMap dei valori dei metadati personalizzati che devono essere importati o esportati: Chiave = nome della proprietà dei metadati personalizzata, come definita in Phrase Strings. Valore = indice delle colonne (1, 2, 3, ecc.) in cui la proprietà si trova nel file importato/dove la proprietà dovrebbe essere nel file esportato.

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

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

Campione di codice

boolean_key,"--- true
"
empty_string_translation,""
key_with_description, dai un'occhiata! Questa chiave ha una descrizione! (Almeno in alcuni formati), questa è la descrizione incredibile per questa chiave!
key_with_line-break,"This translations contains
a line-break."
Chiave nested.deeply.key: "Wow, this chiave is nested even deep."
"nested.key": "This chiave 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,"---
- primo elemento
- secondo elemento
- terzo elemento
"
simple_key, solo una chiave semplice con un messaggio semplice.
unverified_key,Questa traduzione non è ancora verificata e la attende. (In alcuni formati esportiamo anche questo stato)

Struttura dei file

Una tipica struttura di file .CSV:

1 (colonna chiave), 2 (colonna traduzione), 3 (colonna commento)
app_title, Il mio progetto software, Questo è il titolo principale
apples.zero, una mela, il mio commento
...

Esempio di configurazione

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

push:
    sources:
        - file: "./multi.csv"
          params:
              update_translations: true
              locale_mapping:
                  it: 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 devono seguire questa struttura:

1 (colonna chiave), 2 (colonna traduzione), 3 (colonna commento)
messages.zero, Nessun messaggio ricevuto,
messages.one, Un messaggio ricevuto,
messages.other, %s messaggi ricevuti,