.XLSX - Planilha 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 Estas opções que podem ser especificadas quando um arquivo é feito upload e/ou Download. Dependendo do método de upload/Download (API, CLI, sincronização de repositório etc.), eles podem ser especificados em parâmetros de consulta `upload`, `Download` ou no arquivo de configurações `phrase.yml`.	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, ele geralmente segue a convenção de uma coluna por idioma. Para traduzir .XLSX, forneça pelo menos a coluna de nome da chave e uma coluna de tradução. Por padrão, assume-se que o conteúdo comece na primeira linha. Junto com as chaves e a tradução, meta-informações como comentar, códigos e o máximo de caractere permitido para as traduções podem ser importados.

Se um arquivo for feito upload com múltiplas planilhas ou abas, apenas a primeira planilha será detectada. gravar 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 de arquivo de configurações 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	integer
Upload	Sim
Baixar	Não
Padrão	1
Descrição	Índice da primeira linha que contém 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 códigos 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 da chave junto com chaves e traduções.

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

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

Exemplo de estrutura

key_name	en-US	de-DE*	comentar*	Códigos*	max_characters*
app_title	Meu projeto	Mein Projekt	Este é o título principal	app, title	30
saudação	Olá 'usuário'!	Hallo 'User'!	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 meta informações:

comentar: para adicionar uma descrição à chave
códigos: para adicionar códigos a chaves individuais no arquivo
max_characters: para definir um limite de caractere 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:
        - 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