Chaves são usadas para identificar strings de texto traduzível dentro do código de software. Isso permite que o uso de uma chave (como um nome de código para uma string traduzível) seja referenciado 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 correspondendo a um idioma local diferente do projeto. A função é semelhante à da chave primária em bancos de dados relacionais, com as traduções sendo um atributo da chave. Chaves são armazenadas em arquivos de recurso e são usadas para identificar idiomas de texto original e de tradução.
O uso de chaves permite que plataformas de gerenciamento de localização apresentem texto traduzível aos tradutores sem ter que apresentar código.
Chaves normalmente não precisam ser adicionadas a um projeto, pois são idealmente criadas quando um arquivo de recurso é enviado através da aba de uma página de projeto.
Para evitar que chaves sejam enviadas ou criadas, usar a funcionalidade bloqueio de chave. Se uma chave bloqueada já existir, ela não poderá ser traduzida no editor.
Para Excluir chaves da exportar, usar a funcionalidade Excluir chaves. Chaves Excluídas também não podem ser traduzidas no editor.
Chaves em um projeto podem ser duplicadas selecionando Mais/Duplicar chave na seção de uma página de projeto ou na parte superior do painel do Strings Editor.
Chaves de tradução diferentes com os mesmos valores em um ou vários projetos podem ser vinculadas para automatizar atualizações de conteúdo. Chaves vinculadas são usadas para garantir consistência entre projetos e eliminar trabalho repetitivo em conteúdo idêntico.
Alterações nas chaves podem ser revertidas a partir da janela de atividade da barra lateral no Strings Editor.
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 para serem excluídas permanentemente. Isso serve para evitar a exclusão acidental de chaves devido a erros ou acidentes no Phrase ou no repositório.
No Strings, as chaves podem ser de diferentes tipos, dependendo do formato do arquivo enviado:
-
string (padrão)
Nota
Tradutores só podem editar chaves de string a menos que a opção esteja ativada nas configurações avançadas de projeto.
-
Matriz
-
Booleano
-
Markdown
-
Número
O tipo de chave é exibido na seção da barra lateral do editor.
Nomes de chaves devem ser únicos dentro de um projeto.
Existem múltiplas estratégias para nomear chaves:
-
Descritivo
O texto original é identificado pela função. Isso pode tornar mais difícil identificar o texto ao ler o código, mas permanecerá constante.
Exemplo:
-
Strings de texto original (não recomendado)
O texto original é usado como a chave, o que torna fácil identificar o uso do texto. Isso é problemático, pois se o texto original mudar, a relação com as traduções é quebrada.
Exemplo:
Se as chaves não forem enviadas por upload, elas podem ser criadas manualmente.
Para criar uma chave, siga estas etapas:
-
Na aba , clique em adicionar chave.
A janela adicionar chave é aberta.
-
Na aba , forneça um , , quaisquer
-
Se necessário, Ativar plural forms na aba e escolha o tipo de forma plural.
-
selecionar idiomas excluídos na aba , se necessário.
-
Forneça detalhes técnicos na aba , se necessário.
Por exemplo, é possível definir um limite de caractere para traduções no campo . Se definido, o limite de caractere é exibido por um indicador no Strings Editor ao editar as traduções da chave relevante.
-
Clique em Gravar.
A chave é adicionada ao projeto e pode ser visualizada na aba .
Excluir uma chave do editor ou da aba excluirá todas as traduções associadas dessa chave e não poderá ser revertido.
Em projetos com mais de 10.000 chaves, chaves não mencionadas não serão calculadas em uploads futuros. Chaves não mencionadas são chaves que não estão incluídas no upload atual, mas ainda existem no projeto.
O bloqueio impede que chaves inteiras sejam adicionadas a um projeto; se o nome de uma chave bloqueada aparecer em um arquivo de upload, essa chave será omitida e não adicionada ao projeto.
O bloqueio é usado para omitir chaves de um projeto para que elas não sejam gerenciadas de forma alguma.
Chaves normalmente bloqueadas:
-
Strings de formato de data e hora.
-
Chaves incluindo configurações.
-
Chaves que causam problemas quando gerenciadas com a Phrase gem.
Gerencie chaves bloqueadas em um arquivo de idioma separado que não é 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 estas etapas:
-
Em uma página de projeto, Selecionar a aba .
-
Clique em Add key to the blocked keys list.
A janela abre.
-
Forneça um nome para a chave ou uma expressão regular (regex) e clique em gravar.
A chave é adicionada à lista.
Dica
Chatbots de IA podem ser muito eficazes na geração e verificação de regex.
usar Ferramentas como Regex101 para testar regex com diferentes entradas.
As chaves podem ser modificadas posteriormente clicando em ou excluídas
.
Algumas chaves podem precisar ser excluídas de certos idiomas e podem ser marcadas como excluídas. Essas chaves são carregadas e existem dentro de um projeto, mas são ignoradas.
Traduções excluídas são:
-
Excluído da exportar do idioma relacionado.
-
Excluído dos relatórios do idioma relacionado.
Se o conteúdo estiver vazio, ele não é contado como não traduzido.
-
Visível, mas não editável no editor de tradução.
Opções de exclusão:
-
Excluir uma única tradução em um idioma dentro do editor de tradução.
-
Excluir múltiplas traduções em um idioma dentro do editor de tradução.
-
Excluir múltiplas traduções selecionando os idiomas ao criar ou editar a chave.
Para excluir uma chave, siga estas etapas:
-
Na página de chaves, clique em
para a chave que requer exclusão.
A janela abre.
-
Selecione a aba .
-
Selecione idiomas para exclusão.
-
Clique em Gravar.
A seleção é excluída na chave especificada.
Chaves também podem ser excluídas individualmente ou em massa da lista de chaves do editor selecionando a(s) chave(s) e usando o menu .