.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 Essas opções podem ser especificadas quando um arquivo é enviado e/ou baixado. 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ção `phrase.yml`.	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írgula) é um formato de arquivo popular usado principalmente para transferência de dados em várias aplicações e programas. Em um arquivo CSV, cada linha é um registro de dados. Cada registro consiste em alguns campos separados por vírgulas. Antes da importação, certifique-se de que os arquivos CSV tenham três campos para uma única linha representando o conteúdo de origem, tradução e comentários (opcional).

O parâmetro locale_mapping (do tipo hashmap) é necessário para especificar qual coluna no documento corresponde a cada localidade. Para exemplos, veja o exemplo de arquivo de configuração e a documentação da API para uploads.

Opções de formato

Identificador	key_index
Tipo	integer
Upload	Sim
Baixar	Não
Padrão	[Vazio]
Descrição	Índice da coluna contendo os nomes das chaves. Os índices das colunas começam em 1.

Identificador	comment_index
Tipo	integer
Upload	Sim
Baixar	Não
Padrão	[Vazio]
Descrição	Índice da coluna contendo a descrição da chave. Os índices das colunas começam em 1.

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

Identificador	max_characters_allowed_column
Tipo	integer
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 das colunas 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 citar quebras de linha e separadores de coluna.

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 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 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 ID da chave junto com chaves e traduções.

Identificador	custom_metadata_columns
Tipo	hash
Upload	Sim
Baixar	Sim
Padrão	[Vazio]
Descrição	HashMap de metadados personalizados valores que precisam ser importados ou exportados: Chave = Nome da propriedade de metadados personalizados, conforme definido nas Strings de Frase. Valor = Índice da coluna (1, 2, 3, etc.) onde a propriedade está no arquivo importado/onde a propriedade deve estar no arquivo exportado.

Identificador	export_key_id
Tipo	Booleano
Upload	Não
Download	Sim
Padrão	false
Descrição	Exporta o limite de caracteres da chave junto com chaves e traduções.

Identificador	key_id_column
Tipo	integer
Upload	Não
Download	Sim
Padrão	[Vazio]
Descrição	Índice da coluna que contém o ID da chave. Os índices das colunas começam em 1.

Amostra de código

boolean_key,"--- true
"
empty_string_translation,""
key_with_description,Check it out! 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
a line-break."
nested.deeply.key,"Wow, this key is nested even deeper."
nested.key,This key 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,"---
- first item
- second item
- third item
"
simple_key,Just a simple key with a simple message.
unverified_key,This translation is not yet verified and waits for it. (Em alguns formatos, também exportamos este estado)

Estrutura do arquivo

Uma estrutura típica de arquivo .CSV:

1 (Key column), 2 (Translation column), 3 (Comment column)
app_title,      My Software Project,    This is the main title
apples.zero,    one apple,              my comment
...

Exemplo de configuração

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

push:
    sources:
        - file: "./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 seguir esta estrutura:

1 (Key column), 2 (Translation column), 3 (Comment column)
messages.zero,  No messages received,
messages.one,   One message received,
messages.other,  %s messages received,