.TXT (Stringhe)

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 che possono essere specificate quando un file viene caricato e/o scaricato. A seconda del metodo di caricare/Scarica (API, CLI, Repo sync ecc.), possono essere specificati nei parametri di query `caricare`, `Scarica` o nel file di configurazione `phrase.yml`.	indice_chiave comment_index tag_column colonna_max_caratteri_consentiti separatore_colonna preventivo_char riga_contenuto_intestazione enable_pluralization esporta_tag 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 il file di configurazione di esempio e la documentazione dell'API per i caricamenti.

Opzioni di formato

Identificatore	indice_chiave
Tipo	integer
Caricamento	Sì
Download	No
Predefinito	[vuoto]
Descrizione	Indice della colonna contenente i nomi delle chiavi. Gli indici di colonna 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 di colonna 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 di colonna iniziano da 1.

Identificatore	colonna_max_caratteri_consentiti
Tipo	integer
Caricamento	Sì
Download	No
Predefinito	[vuoto]
Descrizione	Indice della colonna contenente un numero massimo di caratteri per la chiave. Gli indici di colonna iniziano da 1.

Identificatore	separatore_colonna
Tipo	stringa
Caricamento	Sì
Download	No
Predefinito	\t
Descrizione	Carattere utilizzato per separare le colonne.

Identificatore	preventivo_char
Tipo	stringa
Caricamento	Sì
Download	No
Predefinito	"
Descrizione	Carattere utilizzato per il preventivo di nuove righe e separatore di colonna.

Identificatore	riga_contenuto_intestazione
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 alle chiavi e alle traduzioni.

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

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

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 fantastica descrizione 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    "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 semplice chiave con un semplice messaggio.
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 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.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 commento)
messages.zero    Nessun messaggio ricevuto,
messages.one    Un messaggio ricevuto,
messages.other    %s messaggi ricevuti,