.XLSX - Spreadsheet Excel (Strings)

O conteúdo de toda a Central de Ajuda é traduzido automaticamente de inglês pelo Phrase Language AI.

Extensões de arquivo	.xlsx
Extensão de API	xlsx
Importar	Sim
Exportar	Sim
Suporte para formas plurais	Sim
Suporte para descrição	Sim
Opções de formato	key_name_column comment_column tag_column first_content_row enable_pluralization export_tags export_max_characters_allowed custom_metadata_columns translation_columns

.XLSX é um formato de arquivo amplamente utilizado para localização. Embora o layout de um arquivo .XLSX possa diferir com base em configurações específicas, geralmente segue a convenção de uma coluna por idioma. Para traduzir .XLSX, forneça pelo menos a coluna do nome da chave e uma coluna de tradução. Por padrão, o conteúdo é assumido como começando na primeira linha. Juntamente com as chaves e traduções, informações meta como comentários, tags e o número máximo de caracteres permitidos para as traduções podem ser importados.

Se um arquivo for enviado com várias planilhas ou abas, apenas a primeira planilha será detectada. Salve planilhas ou abas em arquivos individuais se o conteúdo for necessário para localização.

O parâmetro locale_mapping (do tipo hashmap) é necessário para especificar qual coluna no documento corresponde a cada local. Para exemplos, veja o exemplo do arquivo de configuração e a documentação da API para uploads.

Opções de formato

Identificador	key_name_column
Tipo	string
Upload	Sim
Baixar	Não
Padrão	[Vazio]
Descrição	Coluna que contém o nome/identificação da chave.

Identificador	comment_column
Tipo	string
Upload	Sim
Baixar	Não
Padrão	[Vazio]
Descrição	Coluna que contém comentário/descrição para uma chave.

Identificador	tag_column
Tipo	string
Upload	Sim
Baixar	Não
Padrão	[Vazio]
Descrição	Índice da coluna que contém uma tag para a chave.

Identificador	first_content_row
Tipo	inteiro
Upload	Sim
Baixar	Não
Padrão	1
Descrição	Índice da primeira linha a conter conteúdo de tradução.

Identificador	enable_pluralization
Tipo	Booleano
Upload	Sim
Baixar	Não
Padrão	true
Descrição	Permite a detecção de chaves pluralizadas. Todas as chaves correspondentes persistirão como chaves pluralizadas.

Identificador	export_tags
Tipo	Booleano
Upload	Não
Download	Sim
Padrão	false
Descrição	Exporta tags juntamente com chaves e traduções.

Identificador	export_max_characters_allowed
Tipo	Booleano
Upload	Não
Download	Sim
Padrão	false
Descrição	Exporta o limite de caracteres da chave juntamente com chaves e traduções.

Identificador	custom_metadata_columns
Tipo	hash
Upload	Sim
Baixar	Sim
Padrão	[Vazio]
Descrição	Um hashmap de valores metadados personalizados que precisam ser importados ou exportados: Chave = Nome da propriedade de metadados personalizados, conforme definido em Phrase Strings. Valor = Identificador da coluna (A, B, C, etc.) onde a propriedade está no arquivo importado/o local onde a propriedade deve estar no arquivo exportado.

Identificador	translation_columns
Tipo	hash
Upload	Sim
Baixar	Sim
Padrão	[Vazio]
Descrição	Idioma ID/Nome = Coluna da propriedade de metadados personalizada, conforme definido nas Phrase Strings. Valor = Identificador da coluna (A, B, C, etc.) onde a propriedade está no arquivo importado/o local onde a propriedade deve estar no arquivo exportado.

Exemplo de estrutura

key_name	pt_BR	de-DE*	comentar*	tags*	max_characters*
app_title	Meu Projeto	Meu Projeto	Este é o título principal	app, título	30
saudação	Oi 'Usuário'!	Olá 'Usuário'!	Seja educado

*colunas opcionais

O arquivo de planilha precisa de pelo menos a coluna chave e um idioma para ser carregado. Além de idiomas adicionais, as seguintes colunas podem ser adicionadas para adicionar informações meta:

comentar: para adicionar uma descrição à chave
tags: para adicionar tags a chaves individuais no arquivo
limite_de_caracteres: para definir um limite de caracteres para uma chave através do upload

Exemplo de configuração

Um exemplo para a seção push em um .phraseapp.yml para arquivos XLSX.

push:
    sources:
        - arquivo: "./pt.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:
                  pt: B