.XLSX - Spreadsheet Excel (Strings)

Contenuti tradotti automaticamente dall'inglese con Phrase Language AI.

Estensioni dei file	.xlsx
Estensione API	xlsx
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_name_column comment_column tag_colonna first_content_row enable_pluralization esporta_tag export_max_characters_allowed custom_metadata_columns translation_columns

.XLSX è un formato di file ampiamente utilizzato per la localizzazione. Sebbene il layout di un file .XLSX possa differire in base a impostazioni specifiche, generalmente segue la convenzione di una colonna per lingua. Per tradurre .XLSX, fornire almeno la colonna del nome della chiave e una colonna di traduzione. Per impostazione predefinita, si presume che il contenuto inizi nella prima riga. Insieme alle chiavi e alla traduzione, possono essere importate informazioni meta come commenti, tag e il numero massimo di caratteri consentiti per le traduzioni.

Se un file viene caricato con più fogli o schede, solo il primo foglio verrà rilevato. Salva fogli o schede in file individuali se il contenuto è necessario per la localizzazione.

Il parametro locale_mapping (di tipo hashmap) è necessario per specificare quale colonna nel documento corrisponde a ciascuna impostazione locale. Per esempi, vedere l'esempio del file di configurazione e la documentazione API per i caricamenti.

Opzioni di formato

Identificatore	key_name_column
Tipo	stringa
Caricamento	Sì
Download	No
Predefinito	[vuoto]
Descrizione	Colonna che contiene il nome/identificazione della chiave.

Identificatore	comment_column
Tipo	stringa
Caricamento	Sì
Download	No
Predefinito	[vuoto]
Descrizione	Colonna che contiene commento/descrizione per una chiave.

Identificatore	tag_colonna
Tipo	stringa
Caricamento	Sì
Download	No
Predefinito	[vuoto]
Descrizione	Indice della colonna contenente un tag per la chiave.

Identificatore	first_content_row
Tipo	integer
Caricamento	Sì
Download	No
Predefinito	1
Descrizione	Indice della prima riga per contenere il contenuto della traduzione.

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 il limite di caratteri della chiave insieme a chiavi e traduzioni.

Identificatore	custom_metadata_columns
Tipo	hash
Caricamento	Sì
Download	Sì
Predefinito	[vuoto]
Descrizione	Una mappa hash di metadati personalizzati valori che devono essere importati o esportati: Chiave = Nome della proprietà di metadati personalizzati, come definito nelle Stringhe Phrase. Valore = Identificatore della colonna (A, B, C, ecc.) dove la proprietà si trova nel file importato/dove la proprietà dovrebbe trovarsi nel file esportato.

Identificatore	translation_columns
Tipo	hash
Caricamento	Sì
Download	Sì
Predefinito	[vuoto]
Descrizione	ID/Nome lingua = Colonna della proprietà di metadati personalizzati, come definito nelle Stringhe Phrase. Valore = Identificatore della colonna (A, B, C, ecc.) dove la proprietà si trova nel file importato/dove la proprietà dovrebbe trovarsi nel file esportato.

Esempio di struttura

key_name	en_US	de-DE*	commento*	tags*	max_caratteri*
app_title	Il mio progetto	Il mio progetto	Questo è il titolo principale	app, titolo	30
saluto	Ciao 'Utente'!	Ciao 'Utente'!	Essere gentili

*colonne opzionali

Il file del foglio di calcolo ha bisogno almeno della colonna chiave e di una lingua per essere caricato. Oltre alle lingue aggiuntive, le seguenti colonne possono essere aggiunte per aggiungere informazioni meta:

comment: per aggiungere una descrizione alla chiave
tags: per aggiungere tag a chiavi individuali nel file
max_characters: per impostare un limite di caratteri per una chiave attraverso il caricamento

Esempio di configurazione

Un esempio per la sezione push in un .phraseapp.yml per file XLSX.

push:
    sources:
        - file: "./en.xlsx"
          params:
              file_format: xlsx
              update_translations: true
              format_options:
                  key_name_column: A
                  comment_column: C
                  first_content_row: 2
                  tag_column: D
              locale_mapping:
                  en: B