. CSV (Strings)

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

Extensões de arquivo	.csv
Extensão da API	csv
Importação	Sim
Exportação	Sim, exceto através da CLI/API
Suporte a formulários plurais	Sim
Suporte de descrição	Sim
Opções de formato	locale_mapping (obrigatório) key_index comment_index tag_column max_characters_allowed_column column_separator quote_char header_content_row enable_pluralization export_tags export_max_characters_allowed custom_metadata_columns

CSV (valores separados por vírgula) é um formato de arquivo popular usado principalmente para transferência de dados em vários aplicativos e programas. Em um arquivo CSV, cada linha é um registro de dados. Cada registro consiste em alguns campos separados por vírgulas. Antes de importar, verifique se os arquivos CSV têm três campos para uma única linha que representa o conteúdo de origem, a tradução e os comentários (opcional).

Opções de formato

Identificador	locale_mapping (obrigatório)
Tipo	hash
Carregar	Sim
Baixar	Não
Inadimplência	[opcional]
Descrição	Mapeamento de hash de cada nome de localidade para o índice de coluna em que ele está contido. Os índices de coluna começam em 1

Identificador	key_index
Tipo	inteiro
Carregar	Sim
Baixar	Não
Inadimplência	[vazio]
Descrição	Índice da coluna que contém os nomes das chaves. Os índices de coluna começam em 1.

Identificador	comment_index
Tipo	inteiro
Carregar	Sim
Baixar	Não
Inadimplência	[vazio]
Descrição	Índice da coluna que contém a descrição da chave. Os índices de coluna começam em 1 .

Identificador	tag_column
Tipo	inteiro
Carregar	Sim
Baixar	Não
Inadimplência	[vazio]
Descrição	Índice da coluna que contém uma marca para a chave. Os índices de coluna começam em 1.

Identificador	max_characters_allowed_column
Tipo	inteiro
Carregar	Sim
Baixar	Não
Inadimplência	[vazio]
Descrição	Índice da coluna que contém um número máximo de caracteres para a chave. Os índices de coluna começam em 1.

Identificador	column_separator
Tipo	string
Carregar	Sim
Baixar	Não
Inadimplência	,
Descrição	Char que é usado para separar colunas.

Identificador	quote_char
Tipo	string
Carregar	Sim
Baixar	Não
Inadimplência	"
Descrição	Char que é usado para citar novas linhas e separador de coluna.

Identificador	header_content_row
Tipo	booleano
Carregar	Sim
Baixar	Não
Inadimplência	falso
Descrição	Indica se a primeira linha contém apenas informações de cabeçalho e deve ser ignorada.

Identificador	enable_pluralization
Tipo	booleano
Carregar	Sim
Baixar	Não
Inadimplência	verdadeiro
Descrição	Permite a detecção de chaves pluralizadas. Todas as chaves correspondentes serão mantidas como chaves pluralizadas.

Identificador	export_tags
Tipo	booleano
Carregar	Não
Baixar	Sim
Inadimplência	falso
Descrição	Exporta tags junto com chaves e traduções.

Identificador	export_max_characters_allowed
Tipo	booleano
Carregar	Não
Baixar	Sim
Inadimplência	falso
Descrição	Exporta o limite de caracteres chave junto com chaves e traduções.

Identificador	custom_metadata_columns
Tipo	hash
Carregar	Sim
Baixar	Sim
Inadimplência	[vazio]
Descrição	HashMap de valores de metadados personalizados que precisam ser importados ou exportados: Chave = Nome da propriedade de metadados personalizados, conforme definido em Cadeias de caracteres de frase. Valor = Índice de coluna (1, 2, 3, etc.) onde a propriedade está no arquivo importado/onde a propriedade deve estar no arquivo exportado.

Exemplo de código

boolean_key", --- verdade
"
empty_string_translation,""
key_with_description, confira! Esta chave tem uma descrição! (Pelo menos em alguns formatos), Esta é a descrição incrível para esta chave!
key_with_line-break,"Esta tradução contém
uma quebra de linha".
nested.deeply.key "Uau, essa chave está aninhada ainda mais profundamente."
nested.key,Essa chave está aninhada dentro de um namespace.
null_translation,
pluralized_key.um, "Apenas um gatinho encontrado".
pluralized_key.other,"Uau, você tem %s gatinhos!"
pluralized_key.zero,"Você não tem gatinhos".
sample_collection,"---
- primeiro item
- segundo item
- terceiro item
"
simple_key, apenas uma chave simples com uma mensagem simples.
unverified_key,Esta tradução ainda não está verificada e aguarda por ela. (Em alguns formatos também exportamos esse status)boolean_key,"--- true"empty_string_translation,""key_with_description,Confira! Esta chave tem uma descrição! (Pelo menos em alguns formatos),Esta é a descrição incrível para esta chave!key_with_line-break,"Esta tradução contém uma quebra de linha."nested.deeply.key,"Uau, esta chave está aninhada ainda mais profunda."nested.key,Esta chave está aninhada dentro de um namespace.null_translation,pluralized_key.one, "Apenas um gatinho encontrado."pluralized_key.other,"Uau, você tem %s gatinhos!"pluralized_key.zero, "Você não tem gatinhos."sample_collection,"---- primeiro item- segundo item- terceiro item"simple_key,Apenas uma chave simples com um message.unverified_key simples,Esta tradução ainda não está verificada e espera por isso. (Em alguns formatos também exportamos esse status)

Estrutura de arquivos

Um típico . Estrutura do arquivo CSV:

1 (coluna Chave), 2 (coluna Tradução), 3 (coluna Comentário)
app_title, My Software Project, Este é o título principal
apples.zero, uma maçã, meu comentário
...

Exemplo de configuração

Um exemplo para a seção push de um .phrase.yml para . Arquivos CSV:

push:
    Fontes:
        - Arquivo: "./multi.csv"
          params:
              update_translations: true
              locale_mapping:
                  en: 2
                  de: 3
              format_options:
                  comment_index: 4
                  tag_column: 5

Formas plurais

Esse formato usa categorias nomeadas para identificar as diferentes pluralizações de uma chave. As seguintes categorias são reservadas para formas plurais:

.zero | .one | .two | .few | .many | .other

Exemplos de nomes para chaves pluralizadas corretamente identificadas, persistentes e marcadas:

inbox.messages.notification.one
inbox.messages.notification.other

Os arquivos devem seguir esta estrutura:

1 (coluna Chave), 2 (coluna Tradução), 3 (coluna Comentário)
messages.zero, Nenhuma mensagem recebida,
messages.one, Uma mensagem recebida,
messages.other, %s mensagens recebidas,