.TXT (Strings)

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

Extensões de arquivo	.txt, .tsv
Extensão de API	.txt, .tsv
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

O TXT armazena informações de texto simples sem nenhuma opção de formatação integrada, como grosso, cursivo ou imagens.

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	\t
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.

Amostra de código

"boolean_key": "--- true\n",
"
empty_string_translation    ""
key_with_description Verifique! 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.key "Wow, esta chave está aninhada ainda mais."
"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 Apenas uma chave simples com uma mensagem simples.
não verificada_chave Esta tradução ainda não está 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 .TXT:

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.txt"
          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.