Gerenciamento de tradução

Teclas (Strings)

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

As chaves são usadas para identificar cadeias de caracteres de texto traduzíveis dentro do código de software. Isso permite que o uso de uma chave (como um nome de código para uma cadeia de caracteres traduzível) seja referenciado apenas uma vez por Frase, em vez de para cada tradução necessária da cadeia de caracteres.

Uma chave pode ter várias traduções associadas a ela, cada uma correspondendo a uma localidade de idioma 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 recursos e são usadas para identificar os idiomas de origem e de destino.

O uso de chaves permite que as plataformas de gerenciamento de localização apresentem texto traduzível aos tradutores sem a necessidade de apresentar código.

Normalmente, as chaves não precisam ser adicionadas a um projeto pois são idealmente criadas quando um arquivo de recurso é carregado pela guia Idiomas de uma página do projeto.

Para evitar que as chaves sejam selecionadas pelo editor, use a funcionalidade de chave de bloqueio. Para exibir chaves no editor, mas impedir que elas sejam traduzidas, use a funcionalidade de teclas de exclusão.

As chaves em um projeto podem ser duplicadas selecionando Mais/Duplicar chave na seção Chaves de uma página do projeto ou na parte superior do painel Editor de cadeias de caracteres.

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. As chaves vinculadas são usadas para garantir a consistência entre projetos e eliminar o trabalho repetitivo em conteúdo idêntico.

As alterações nas teclas podem ser revertidas a partir da janela de atividade da barra lateral no editor de cadeias de caracteres.

Nomenclatura de chaves

Os nomes das chaves devem ser exclusivos dentro de um projeto.

Existem várias estratégias para nomear chaves:

  • Descritivo

    O texto original é identificado por função. Isso pode dificultar a identificação do texto durante a leitura do código, mas permanecerá uma constante.

    Exemplo:

    Chave

    Alemão

    Inglês

    fem_char

    morrer Frau

    mulher

    male_char

    der Mann

    man

  • Cadeias de caracteres de origem (não recomendado)

    O próprio texto original é usado como a chave que facilita a identificação do uso do texto. Isso é problemático, pois se o texto original muda, quebra a relação com as traduções.

    Exemplo:

    Chave

    Alemão

    Francês

    Cão

    Hund

    Chien

    Gato

    Katze

    Chat

Criando chaves

Se as chaves não forem carregadas, elas poderão ser criadas manualmente.

Para criar uma chave, execute estas etapas:

  1. Na guia Chaves , clique em Adicionar chave.

    A janela Adicionar chave é aberta.

  2. Na guia Geral , forneça um Nome, uma Descrição , quaisquer Tags disponíveis e uma tradução Padrão.

  3. Habilite formulários plurais na guia Formulários no plural , se necessário.

  4. Selecione os idiomas excluídos na guia Excluídos , se necessário.

  5. Forneça detalhes técnicos na guia Avançado , se necessário.

  6. Clique em Salvar.

    A chave é adicionada ao projeto e pode ser visualizada na guia Chaves .

A exclusão de uma chave do editor ou da guia Chaves excluirá todas as traduções associadas dessa chave e não poderá ser revertida.

Chaves bloqueadas

O bloqueio impede que chaves inteiras sejam adicionadas a um projeto; Se o nome de uma chave bloqueada aparecer em um arquivo carregado, 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.

Chaves normalmente bloqueadas:

  • Cadeias de caracteres de formato de data e hora.

  • Chaves, incluindo configurações.

  • Chaves que causam problemas quando gerenciadas com a gema Phrase.

Gerencie chaves bloqueadas em um arquivo de idioma separado que não é processado ou mantido.

Chaves problemáticas

Essas chaves podem causar problemas e, se usadas, devem ser bloqueadas quando um projeto é criado.

  • activemodel.errors*

  • number.format*

  • número.moeda*

  • number.percentage*

  • datetime.prompts*

Bloqueando uma chave

Para bloquear uma chave, execute estas etapas:

  1. Em uma página do projeto, selecione a guia Chaves bloqueadas .

  2. Clique em Adicionar chave à lista de chaves bloqueadas.

    A janela Adicionar chave à lista de chaves bloqueadas é aberta.

  3. Forneça um nome para a chave e clique em Salvar.

    A chave é adicionada à lista.

As chaves podem ser modificadas posteriormente clicando em Phrase_Gear.png ou excluindo Phrase_Bin.png.

Exclusões

Algumas chaves podem precisar ser excluídas de determinados idiomas e podem ser marcadas como excluídas. Essas chaves são carregadas e existem dentro de um projeto, mas são ignoradas.

As traduções excluídas são:

  • Excluído da exportação do idioma relacionado.

  • Excluído dos relatórios linguísticos relacionados.

    Se o conteúdo estiver vazio, ele não será 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 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.

Excluindo chaves

Para excluir uma chave, execute estas etapas:

  1. Na página chaves, clique em Phrase_Gear.png para a chave que requer exclusão.

    A janela Editar chave é aberta.

  2. Selecione a guia Excluído .

  3. Selecione os idiomas para exclusão.

  4. Clique em Salvar.

    A seleção é excluída na chave especificada.

As chaves também podem ser excluídas do editor selecionando a chave e usando o menu Status da atualização .

Esse artigo foi útil?

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.