.XLSX - Tabela de cálculo 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

O .XLSX é um formato de arquivo amplamente utilizado para localização. Embora o layout de um arquivo .XLSX possa ser diferente com base em configurações específicas, ele geralmente segue a convenção de uma coluna por idioma. Para traduzir .XLSX, forneça pelo menos a coluna Nome da chave e uma coluna de tradução. Por padrão, o conteúdo é assumido começar na primeira linha. Juntamente com as chaves e a tradução, podem ser importadas metadinformações como comentários, tags e os caracteres máximos permitidos para as traduções.

O parâmetro local_mapping (do tipo hashmap) é necessário especificar qual coluna no documento corresponde a cada local. Para exemplos, consulte o exemplo de 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 comentar/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 um código para a chave.

Identificador	first_content_row
Tipo	inteiro
Upload	Sim
Baixar	Não
Padrão	1
Descrição	Índice da primeira linha para conter conteúdo da 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 junto 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 caractere de chave junto com chaves e traduções.

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

Exemplo de estrutura

key_name	en_US	de-DE*	Comentário*	tags*	max_characters*
app_title	Meu projeto	Meu projeto	Este é o título principal	app, título	30
saudação	Olá 'Usuário'!	Olá, usuário!	Ser educado

* colunas opcionais

O arquivo da planilha precisa ter pelo menos a coluna chave e um idioma para pedir o upload. Além de adicionar idiomas adicionais, as seguintes colunas podem ser adicionadas para adicionar metadados:

Comentário: para adicionar uma descrição à chave
tags: para adicionar tags a chaves individuais no arquivo
max_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: "./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