.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 de API	csv
Importar	Sim
Exportar	Sim
Suporte para formas plurais	Sim
Suporte para descrição	Sim
Opções de formato	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 export_key_id key_id_column

CSV (valores separados por vírgulas) é 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 é composto de alguns campos separados por vírgulas. Antes de importar, certifique-se de que os arquivos CSV têm três campos para uma única linha que representa o conteúdo do texto texto original, a tradução e os comentários (opcionais).

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_index
Tipo	inteiro
Upload	Sim
Baixar	Não
Padrão	[Vazio]
Descrição	Índice da coluna que contém os nomes das chaves. Os índices da coluna começam em 1.

Identificador	comment_index
Tipo	inteiro
Upload	Sim
Baixar	Não
Padrão	[Vazio]
Descrição	Índice da coluna que contém uma descrição para a chave. Os índices da coluna começam em 1.

Identificador	tag_column
Tipo	inteiro
Upload	Sim
Baixar	Não
Padrão	[Vazio]
Descrição	Índice da coluna que contém um código para a chave. Os índices da coluna começam em 1.

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

Identificador	column_separator
Tipo	string
Upload	Sim
Baixar	Não
Padrão	,
Descrição	Caractere que é usado para separar colunas.

Identificador	quote_char
Tipo	string
Upload	Sim
Baixar	Não
Padrão	"
Descrição	Caractere que é usado para orçamento novas linhas e separador de colunas.

Identificador	header_content_row
Tipo	Booleano
Upload	Sim
Baixar	Não
Padrão	false
Descrição	Indica se a primeira linha contém apenas informações de cabeçalho e se deve ser ignorada.

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	HashMap de valores de metadados personalizados que precisam ser importados ou exportados: Chave = Nome da propriedade de metadados personalizados, como definidos no Phrase Strings. Valor = Índice de coluna (1, 2, 3, etc.) em que a propriedade está no arquivo importado/onde a propriedade deveria estar no arquivo exportado.

Identificador	export_key_id
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	key_id_column
Tipo	inteiro
Upload	Não
Download	Sim
Padrão	[Vazio]
Descrição	Índice da coluna que contém o ID para a chave. Os índices da coluna começam em 1.

Amostra de código

boolean_key,"--- true
"
empty_string_translation,""
key_with_description, Cheque! This key has a description! (Pelo menos em alguns formatos),Esta é a descrição incrível para esta chave!
"key_with_line-break": "This translations contains\na line-break.",
uma quebra de linha."
"nested.deeply.chave": "Wow, this chave is nested even deeper."
"nested.chave", "This chave is nested inside a namespace."
null_translation,
"pluralized_key.one": "Only one kitten found.",
"pluralized_key.other": "Wow, you have %s kittens!",
"pluralized_key.zero": "You have no kittens.",
sample_collection,"---
- primeiro item
- segundo item
- terceiro item
"
simple_chave,Just a simple chave with a simple message.
marcou como não verificada_chave,Esta tradução ainda não foi verificada e está esperando por ela. (Em alguns formatos, nós também exportamos este estado)

Estructura do arquivo

Uma estrutura típica de arquivo .CSV:

1 (coluna chave), 2 (coluna de tradução), 3 (coluna de comentar)
app_title, Meu projeto de software, Este é o título principal
apples.zero, one apple, meu comentar
...

Exemplo de configuração

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

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

Formas plurais

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

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

Nomes de exemplos de chaves pluralizadas identificadas, persistentes e marcadas corretamente:

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

Os arquivos devem obedecer a esta estrutura:

1 (coluna chave), 2 (coluna de tradução), 3 (coluna de comentar)
messages.zero, Nenhuma mensagem recebida,
messages.one, Uma mensagem recebida,
messages.other, %s messages received.