As chaves são usadas para identificar Strings de texto traduzíveis no código de software. Isso permite que o usar de uma chave (como 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. As chaves são armazenadas em arquivos de texto original e são usadas para identificar os idiomas de origem e tradução.
A usar de chaves permite que plataformas de gerenciamento de localização apresentem texto traduzível a tradutores sem ter de apresentar 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 de uma página de projeto.
Para evitar que as chaves sejam pegos pelo editor, use a funcionalidade de chave de bloqueio. Para exibir chaves no editor, mas evitar que elas sejam traduzidas, use a funcionalidade excluir chaves.
As chaves em um projeto podem ser duplicadas selecionando a chave Mais/Duplicate na seção de uma página de projeto ou na parte superior do painel Strings Editor.
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 eliminar trabalhos repetitivos sobre conteúdo idêntico.
As alterações de chaves podem ser revertidas a partir da janela de atividades da barra lateral no Strings Editor.
Nota
Ao trabalhar com repositórios (GitHub, GitLab, etc.) e ao excluir chaves, as chaves devem ser excluídas do Phrase e do repositório que devem ser excluídas permanentemente. Isso é para evitar a exclusão acidental de chaves devido a erros ou acidentes no phrase ou no repositório.
Os nomes das chaves precisam ser exclusivos em um projeto.
Existem várias estratégias para dar nomes a chaves:
-
Descritivo
O texto original é identificado por função. Isto pode dificultar a identificação do texto ao ler o código, mas permanecerá constante.
Exemplo:
-
Texto original Strings (não recomendado)
O próprio texto original é utilizado como chave, o que facilita a identificação do usar do texto. Isto é problemático, como se o texto original for alterado, isto romperá a relação com as traduções.
Exemplo:
Se as chaves não forem enviadas, elas poderão 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 da aba , se necessário.
-
Selecione os idiomas excluídos da aba se necessário.
-
Forneça detalhes técnicos na aba se necessário.
-
Clique em Gravar.
A chave está adicionada ao projeto e pode ser visualizada na aba .
A exclusão de uma chave a partir do editor ou da aba excluirá todas as traduções associadas a essa chave e é impossível revertê-la.
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 não sejam gerenciadas.
Chaves normalmente bloqueadas:
-
Strings de formato de data e hora.
-
Chaves incluindo configurações.
-
Chaves que causam problemas quando gerenciadas com o joio 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 de chaves bloqueadas é aberta.
-
Forneça um nome para a chave e clique em Gravar.
A chave está adicionada à lista.
As chaves podem ser posteriormente modificadas clicando na ou excluídas nas
.
Algumas chaves podem precisar ser excluídas de certos idiomas e podem ser marcadas como excluídas. Essas chaves são enviadas e existem dentro de um projeto, mas são ignoradas.
Traduções excluídas são:
-
Excluídas da exportação do idioma relacionado.
-
Excluídas dos relatórios de idiomas relacionados.
Se o conteúdo estiver empty, não será contado como não traduzido traduzido.
-
Odo Visível, mas não editável no editor de tradução.
Opções de exclusão:
-
Exclua uma única tradução 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, execute estas etapas:
-
Na página chave, 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 está excluída na chave especificada.
As chaves também podem ser excluídas do editor selecionando a chave e usando o menu .