Tipi di file supportati (Strings)

.CSV (Strings)

Contenuti tradotti automaticamente dall'inglese con Phrase Language AI.

Estensioni dei file

.csv

Estensione API

csv

Importa

Esporta

Sì, tranne tramite CLI/API

Supporto alle forme plurali

Supporto alla descrizione

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

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

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

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

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

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

Scarica

No

Predefinito

,

Descrizione

Carattere che viene utilizzato per separare le colonne.

Identificatore

quote_char

Tipo

stringa

Carica

Scarica

No

Predefinito

"

Descrizione

Carattere che viene utilizzato per il preventivo separatore di righe e colonne.

Identificatore

header_content_row

Tipo

booleano

Carica

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

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

Predefinito

falso

Descrizione

Esporta i tag insieme a chiavi e traduzioni.

Identificatore

export_max_characters_allowed

Tipo

booleano

Carica

No

Scarica

Predefinito

falso

Descrizione

Esporta il limite di caratteri chiave insieme a chiavi e traduzioni.

Identificatore

custom_metadata_columns

Tipo

hash

Carica

Scarica

Predefinito

[vuoto]

Descrizione

HashMap di valori di metadati personalizzati che devono essere importati o esportati:

  • Chiave = Nome della proprietà dei metadati personalizzata, come definita in Phrase Strings.

  • Valore = Indice di colonna (1, 2, 3, ecc.) in cui la proprietà si trova nel file importato/in cui la proprietà dovrebbe essere nel file esportato.

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

Forme plurali

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,
Questo articolo ti è stato utile?

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.