.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 scaricato. A seconda del metodo di caricamento/scaricamento (API, CLI, sincronizzazione Repo, ecc.), possono essere specificate nei parametri di query `Carica`, `Scarica` o nel file di configurazione `phrase.yml`.	key_index comment_index colonna_tag max_characters_allowed_column column_separator quote_char header_content_row enable_pluralization esporta_tag export_max_characters_allowed custom_metadata_columns export_key_id key_id_column

CSV (valori separati da virgola) è 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 è composto da alcuni campi separati da virgole. Prima dell'importazione, assicurati che i file CSV abbiano tre campi per una singola riga che rappresenta il contenuto sorgente, la traduzione e i commenti (opzionale).

Il parametro mappatura_locale (di tipo hashmap) è necessario per specificare quale colonna nel documento corrisponde a ciascuna impostazione locale. Per esempi, vedere il 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 chiavi. 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	colonna_tag
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 citare le nuove righe e il separatore 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	esporta_tag
Tipo	booleano
Caricamento	No
Download	Sì
Predefinito	false
Descrizione	Esporta i 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 metadati personalizzati valori che devono essere importati o esportati: Chiave = Nome della proprietà di metadati personalizzati, come definito nelle stringhe Phrase. Valore = Indice della colonna (1, 2, 3, ecc.) dove la proprietà si trova 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 caratteri 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 descrizione sorprendente 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 questo 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 .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 devono 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,