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:
|
Identificador |
translation_columns |
Tipo |
hash |
Upload |
Sim |
Baixar |
Sim |
Padrão |
[Vazio] |
Descrição |
|
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