As chaves são usadas para identificar strings de texto traduzíveis no código de software. Isso permite que o uso de uma chave (como um nome de código para uma string traduzível) seja referido apenas uma vez pelo Phrase em vez de para cada tradução necessária da string.
Uma chave pode ter várias traduções associadas a ela, cada uma correspondente a um local de idioma diferente do projeto. A função é semelhante à da chave primária em bases de dados relacionais, com as traduções sendo um atributo da chave. As chaves são armazenadas em arquivos de recurso e são usadas para identificar os idiomas de origem e destino.
O uso de chaves permite que as plataformas de gerenciamento de localização apresentem textos traduzíveis aos tradutores sem ter de apresentar o código.
As chaves normalmente não precisam ser adicionadas a um projeto, pois são idealmente criadas quando um arquivo de recurso é enviado por meio da aba de uma página de projeto.
Para evitar que chaves sejam enviadas por upload ou criadas, use a funcionalidade de chave de bloqueio. Se já existir uma chave bloqueada, ela não poderá ser traduzida no editor.
Para excluir chaves da exportação, use a funcionalidade de excluir chaves. As chaves excluídas também não podem ser traduzidas no editor.
As chaves em um projeto podem ser duplicadas selecionando Mais/Chave Duplicada na seção de uma página de projeto ou na parte superior do pano Editor Strings.
Diferentes chaves de tradução com os mesmos valores em um ou mais projetos podem ser vinculadas para automatizar atualizações de conteúdo. As chaves vinculadas são usadas para garantir a consistência entre projetos e evitar trabalhos repetitivos em conteúdo idêntico.
As alterações das chaves podem ser revertidas a partir da janela de atividade da barra lateral no editor Strings.
Nota
Ao trabalhar com repositórios (GitHub, GitLab, etc.) e excluir chaves, as chaves devem ser excluídas tanto do Phrase quanto do repositório a ser excluído permanentemente. Isso é para evitar exclusões acidentais de chaves devido a erros ou acidentes no Phrase ou no repositório.
Em Strings, chaves podem ser de diferentes tipos dependendo do formato do arquivo enviado por upload:
-
String (padrão)
Nota
Os tradutores só podem editar chaves de string a menos que a opção esteja ativada nas configurações avançadas do projeto.
-
Matriz
-
Booleano
-
Markdown
-
Número
O tipo de chave é exibido na seção da barra lateral do editor.
Os nomes das chaves precisam ser exclusivos em um projeto.
Existem várias estratégias para dar nome a chaves:
-
Descriptivo
O texto original é identificado pela função . Isso pode dificultar a identificação do texto ao ler o código, mas permanecerá constante.
Exemplo:
-
Strings de texto original (não recomendado)
O próprio texto original é usado como chave que facilita a identificação do uso do texto. Isto é problemático como se o texto original for alterado, isso quebra a relação com as traduções.
Exemplo:
Se as chaves não forem enviadas por upload, elas podem ser criadas manualmente.
Para criar uma chave, siga estes passos:
-
Na aba , clique em Adicionar chave.
A janela Adicionar chave é aberta.
-
Na aba , forneça um , , quaisquer disponíveis e uma .
-
Ative as formas plurais na aba , se necessário.
-
Selecione os idiomas excluídos da aba , se necessário.
-
Forneça detalhes técnicos na aba , se necessário.
Por exemplo, é possível definir um limite de caracteres para traduções no . Se definido, o limite de caracteres é exibido por um indicador no editor Strings ao editar as traduções da chave relevante.
-
Clique em Gravar.
A chave é adicionada ao projeto e pode ser visualizada na aba .
A exclusão de uma chave do editor ou da aba excluirá todas as traduções associadas a essa chave e é impossível revertê-la.
Em projetos com mais de 10.000 chaves, chaves não mencionadas não serão calculadas em uploads adicionais. As chaves não mencionadas são chaves que não estão incluídas no upload atual, mas ainda existem no projeto.
O bloqueio evita que chaves inteiras sejam adicionadas a um projeto. Se o nome de uma chave bloqueada aparecer em um arquivo com upload feito, essa chave é omitida e não adicionada ao projeto.
O bloqueio é usado para omitir chaves de um projeto para que elas não sejam gerenciadas nada.
Chaves normalmente bloqueadas:
-
Strings de formato de data e hora.
-
Chaves incluindo configurações.
-
Chaves causando problemas quando gerenciadas com a joia do Phrase.
Gerencie chaves bloqueadas em um arquivo de idioma separado que não seja processado ou mantido.
Essas chaves podem causar problemas e, se usadas, devem ser bloqueadas quando um projeto é criado.
-
activemodel.errors* -
number.format* -
number.currency* -
number.percentage* -
datetime.prompts*
Para bloquear uma chave, siga estes passos:
-
Em uma página de projeto, selecione a aba .
-
Clique em Adicionar chave à lista de chaves bloqueadas.
A janela é aberta.
-
Forneça um nome para a chave ou uma expressão regular (expressão regular) e clique em Gravar.
A chave está adicionada à lista.
Dica
Os chatbots da IA podem ser muito efetivos na geração e verificação de expressões regulares.
Use ferramentas como Regex101 para testar expressões regulares com diferentes entradas.
As chaves podem ser modificadas posteriormente clicando em ou excluindo
.
Algumas chaves podem precisar ser excluídas de certos idiomas e podem ser marcadas como excluídas. Essas chaves são enviadas por upload e existem em um projeto, mas são ignoradas.
As traduções excluídas são:
-
Excluídas da exportação do idioma relacionado.
-
Excluídas dos relatórios de idioma relacionados.
Se o conteúdo estiver vazio, ele não será contado como não traduzido.
-
Odo Visível, mas não editável no editor de tradução.
Opções de exclusão:
-
Exclua uma tradução única em um idioma no editor de tradução.
-
Exclua várias traduções em um idioma no editor de tradução.
-
Exclua várias traduções selecionando os idiomas ao criar ou editar a chave.
Para excluir uma chave, siga estes passos:
-
Na página de chaves, clique em
para a chave que requer exclusão.
A janela é aberta.
-
Selecione a aba .
-
Selecionar idiomas para exclusão.
-
Clique em Gravar.
A seleção é excluída na chave especificada.
As chaves também podem ser excluídas individualmente ou em lote da lista de chaves do editor selecionando a(s) chave(s) e usando o menu .