.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 Estas opções que 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.), elas podem ser especificadas em parâmetros de consulta `upload`, `Download` ou no arquivo de configuração `phrase.yml`.	key_index comment_index: 4 tag_column: 5 max_characters_allowed_column column_separator: ";" quote_char header_content_row enable_pluralization exportar_código export_max_characters_allowed custom_metadata_columns

TXT armazena informações de texto simples sem nenhuma opção de formatação incorporada, como negrito, itálico ou imagens.

O parâmetro locale_mapping (do tipo hashmap) é necessário para 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	integer
Upload	Sim
Baixar	Não
Padrão	[Vazio]
Descrição	Índice da coluna que contém os nomes das chave. Os índices de coluna começam em 1.

Identificador	comment_index: 4
Tipo	integer
Upload	Sim
Baixar	Não
Padrão	[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: 5
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 de coluna 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 de 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 de quebras de linha e separador 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	exportar_código
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 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 valores de metadados Personalizados que precisam ser importados ou exportados: Chave = Nome da propriedade de metadados Personalizados, conforme definido em Phrase Strings. Valor = Índice da coluna (1, 2, 3, etc.) onde a propriedade está no arquivo importado/onde a propriedade deve estar no arquivo exportado.

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    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    "---
- first item
- second item
- third item
"
simple_key    Apenas uma chave simples com uma mensagem simples.
unverified_key    Esta tradução não está verificada e aguarda por isso. (Em alguns formatos, nós também exportar este estado)

Estrutura de arquivo

Uma estrutura de arquivo .TXT típica:

1 (Coluna da chave)    2 (Coluna da tradução)    3 (Coluna de comentar)
app_title    Meu projeto de software    Este é o título principal
apples.zero    uma maçã    meu comentar
...

Exemplo de configuração

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

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

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