Estensioni dei file |
.csv |
Estensione API |
csv |
Importa |
Sì |
Esporta |
Sì, tranne tramite CLI/API |
Supporto alle forme plurali |
Sì |
Supporto alla descrizione |
Sì |
Opzioni formato |
locale_mapping (richiesto) 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 |
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, assicurarsi che i file CSV abbiano tre campi per una singola riga che rappresentano contenuto di origine, traduzione e commenti (facoltativo).
Opzioni formato
Identificatore |
locale_mapping (richiesto) |
Tipo |
hash |
Carica |
Sì |
Scarica |
No |
Predefinito |
[facoltativo] |
Descrizione |
Mappatura hash di ogni nome delle impostazioni locali all'indice di colonna in cui è contenuto. Indici di colonna iniziano da 1 |
Identificatore |
key_index |
Tipo |
intero |
Carica |
Sì |
Scarica |
No |
Predefinito |
[vuoto] |
Descrizione |
Indice della colonna contenente i nomi delle chiavi. Gli indici di colonna iniziano con 1. |
Identificatore |
comment_index |
Tipo |
intero |
Carica |
Sì |
Scarica |
No |
Predefinito |
[vuoto] |
Descrizione |
Indice della colonna contenente la descrizione per la chiave. Gli indici di colonna iniziano con 1 . |
Identificatore |
tag_column |
Tipo |
intero |
Carica |
Sì |
Scarica |
No |
Predefinito |
[vuoto] |
Descrizione |
Indice della colonna contenente un tag per la chiave. Gli indici di colonna iniziano con 1. |
Identificatore |
max_characters_allowed_column |
Tipo |
intero |
Carica |
Sì |
Scarica |
No |
Predefinito |
[vuoto] |
Descrizione |
Indice della colonna contenente un numero massimo di caratteri per la chiave. Gli indici di colonna iniziano con 1. |
Identificatore |
column_separator |
Tipo |
stringa |
Carica |
Sì |
Scarica |
No |
Predefinito |
, |
Descrizione |
Carattere che viene utilizzato per separare le colonne. |
Identificatore |
quote_char |
Tipo |
stringa |
Carica |
Sì |
Scarica |
No |
Predefinito |
" |
Descrizione |
Carattere che viene utilizzato per il preventivo separatore di righe e colonne. |
Identificatore |
header_content_row |
Tipo |
booleano |
Carica |
Sì |
Scarica |
No |
Predefinito |
falso |
Descrizione |
Indica se la prima riga contiene solo informazioni di intestazione e deve essere saltata. |
Identificatore |
enable_pluralization |
Tipo |
booleano |
Carica |
Sì |
Scarica |
No |
Predefinito |
vero |
Descrizione |
Abilita il rilevamento di chiavi pluralizzate. Tutte le chiavi corrispondenti verranno mantenute come chiavi pluralizzate. |
Identificatore |
export_tags |
Tipo |
booleano |
Carica |
No |
Scarica |
Sì |
Predefinito |
falso |
Descrizione |
Esporta i tag insieme a chiavi e traduzioni. |
Identificatore |
export_max_characters_allowed |
Tipo |
booleano |
Carica |
No |
Scarica |
Sì |
Predefinito |
falso |
Descrizione |
Esporta il limite di caratteri chiave insieme a chiavi e traduzioni. |
Identificatore |
custom_metadata_columns |
Tipo |
hash |
Carica |
Sì |
Scarica |
Sì |
Predefinito |
[vuoto] |
Descrizione |
HashMap di valori di metadati personalizzati che devono essere importati o esportati:
|
Campione di codice
chiave_booleana,"--- vero " empty_string_translation,"" chiave_con_descrizione, controllalo! Questa chiave ha una descrizione! (Almeno in alcuni formati), questa è la descrizione sorprendente per questa chiave! key_with_line-break,"Questa traduzione contiene un'interruzione di riga." chiave nidificata.deeply.key,"Wow, questa chiave è nidificata ancora più in profondità." nested.key,Questa chiave è nidificata all'interno di uno spazio dei nomi. null_translation, pluralized_key.one, "Solo un gattino trovato." pluralized_key.other,"Wow, hai %s gattini!" pluralized_key.zero,"Non hai gattini." 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)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!chiave_with_line-break,"Questa traduzione contiene un'interruzione di riga."nested.deeply.chiave,"Wow, questa chiave è nidificata ancora più in profondità."nested.chiave,Questa chiave è nidificata all'interno di uno spazio dei nomi.null_translation,pluralized_chiave.one, "Solo un gattino trovato."pluralized_chiave.other,"Wow, hai %s gattini!"pluralized_chiave.zero,"Non hai gattini."sample_collection,"---- primo elemento- secondo elemento- terzo elemento"simple_chiave, Solo una chiave semplice con un messaggio semplice.unverified_chiave,Questa traduzione non è ancora verificata e lo aspetta. (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: origini: - file: "./multi.csv" parametri: update_translations: vero locale_mapping: it: 2 de: 3 format_options: comment_index: 4 tag_column: 5
Questo formato utilizza categorie denominate per identificare le diverse pluralizzazioni di una chiave. Le seguenti categorie sono riservate alle forme plurali:
.zero | .one | .two | .few | .many | .other
Esempio 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,