Tipos de arquivos aceitos (Strings)

.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
Esse artigo foi útil?

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.