.TXT (Strings)

Contenuti tradotti automaticamente dall'inglese con Phrase Language AI.

Estensioni dei file	.txt, .tsv
Estensione API	.txt, .tsv
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 `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

TXT archivia informazioni in testo semplice senza alcuna opzione di formattazione incorporata come grassetto, corsivo o immagini.

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 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	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	\t
Descrizione	Carattere utilizzato per separare le colonne.

Identificatore	quote_char
Tipo	stringa
Caricamento	Sì
Download	No
Predefinito	"
Descrizione	Carattere utilizzato per racchiudere tra virgolette nuove righe e separatori 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 i tag insieme alle chiavi e alle traduzioni.

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

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

Esempio 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 fantastica descrizione per questa chiave!
key_with_line-break    \"Questa traduzione contiene
a line-break."
nested.deeply.key    \"Wow, questa chiave è annidata ancora più in profondità.\""
nested.key    Questa chiave è annidata all'interno di uno spazio dei nomi.
null_translation    
pluralized_key.one    \"Trovato solo un gattino.\""
pluralized_key.other    \"Wow, hai %s gattini!\"
pluralized_key.zero    \"Non hai gattini.\""
sample_collection    \"---
- first item
- second item
- third item
"
simple_key    Solo una chiave semplice con un messaggio semplice.
unverified_key    Questa traduzione non è ancora verificata e attende di esserlo. (In alcuni formati esportiamo anche questo stato)

Struttura del file

Una tipica struttura di file .TXT:

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

Esempio di configurazione

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

push:
    sources:
        - file: "./multi.txt"
          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 (Colonna chiave)    2 (Colonna traduzione)    3 (Colonna commentare)
messages.zero    Nessun messaggio ricevuto,
messages.one    Un messaggio ricevuto,
messages.other    %s messaggi ricevuti,