Encontrar uma chave de tradução com localização detalhada

[Discourse]

Esta documentação explica como usar a localização detalhada (verbose localization) para encontrar chaves de tradução para texto personalizado no Discourse.

Nível de usuário necessário: Administrador

Encontrando uma chave de tradução usando localização detalhada

A localização detalhada (verbose localization) é uma ferramenta poderosa no Discourse que ajuda administradores a encontrar chaves de tradução para texto personalizado de forma mais eficaz. Isso é particularmente útil quando você precisa traduzir texto que aparece em vários lugares na interface do usuário do Discourse.

Resumo

Este guia abrange:

• Ativar a localização detalhada.
• Usar a localização detalhada para identificar chaves de tradução.
• Aplicações práticas e casos de uso comuns.

Ativando a localização detalhada

Existem várias maneiras de ativar a localização detalhada, dependendo da sua configuração.

Usando a Barra de Ferramentas do Desenvolvedor (recomendado)

A Barra de Ferramentas do Desenvolvedor do Discourse inclui uma opção integrada para a localização detalhada. Este é o método mais fácil e funciona em sites auto-hospedados e hospedados.

1. Abra o console do desenvolvedor do seu navegador no seu site Discourse.
2. Execute:

   enableDevTools()
   

3. A página será recarregada e uma barra de ferramentas do desenvolvedor aparecerá no lado esquerdo da tela.
4. Clique no ícone (rolagem) na barra de ferramentas para ativar a localização detalhada.
5. A página será recarregada com a localização detalhada ativada.

O estado da barra de ferramentas do desenvolvedor é armazenado no armazenamento local do seu navegador, e o estado da localização detalhada é armazenado no armazenamento de sessão. Outros usuários não serão afetados.

Usando o console do navegador diretamente

1. Abra o inspetor da web do seu navegador no seu site Discourse.
2. Vá para a aba do console.
3. Digite o seguinte comando JavaScript no prompt:

   I18n.enableVerboseLocalizationSession()
   

4. Você deverá ver uma resposta semelhante a:
   
   

Esta abordagem específica da sessão garante que outros usuários não verão marcadores de tradução ao visitar o site.

Usando o console rails (apenas auto-hospedado)

A configuração de site verbose_localization existe, mas é uma configuração de site oculta. Ela não pode ser encontrada na UI de administração em “Todas as Configurações do Site”. Para ativá-la globalmente para todos os usuários em uma instância auto-hospedada:

1. Acesse o console rails.
2. Execute:

   SiteSetting.verbose_localization = true
   

Isso ativa a localização detalhada para todos os usuários do site. Prefira os métodos baseados em sessão acima para evitar sobrecarregar a interface do usuário para outros usuários.

Usando a localização detalhada para encontrar uma chave de tradução

Quando a localização detalhada está ativada, você verá números exibidos após todo o texto personalizável no seu site.

Passos para identificar uma chave de tradução

1. Navegue até a área que contém o texto que você deseja atualizar. Por exemplo, se você estiver procurando alterar a palavra “Name” (Nome):
   
   
2. Procure o número de tradução associado no console do seu navegador:
   
   
3. Anote a chave de tradução identificada, como user.name.title.
4. Vá para a barra lateral de Administração e digite site texts na barra de Pesquisa
5. Digite a chave de tradução na caixa de pesquisa:
   
   
6. Clique no botão Editar do texto e atualize o texto conforme necessário.

Melhores práticas

• Use a localização detalhada específica da sessão para evitar sobrecarregar a interface do usuário para outros usuários durante tarefas de tradução.
• Documente as chaves de tradução usadas com frequência para referência futura.
• Verifique regularmente as atualizações na documentação do Discourse para se manter informado sobre novos recursos de localização.

Problemas comuns e soluções

Problema: Marcadores de tradução visíveis para todos os usuários

Solução: Certifique-se de ativar a localização detalhada exclusivamente para sua sessão se outros usuários não deveriam vê-la. Use a Barra de Ferramentas do Desenvolvedor ou o método de console I18n.enableVerboseLocalizationSession() em vez da configuração global do site.

Problema: Dificuldade em encontrar a chave de tradução correta

Solução: Use o console e os marcadores de localização detalhada com precisão e verifique a página Personalizar Textos do Site.

FAQs

P: A localização detalhada pode ser restrita a administradores ou equipe?
R: Os números de localização detalhada podem ser ocultados de usuários não técnicos, ativando-a em sessões individuais por meio da Barra de Ferramentas do Desenvolvedor ou do console do navegador.

P: Como as traduções de strings podem ser verificadas?
R: Após identificar e atualizar a chave de tradução, revise as alterações na interface do usuário em uma nova sessão ou aba do navegador.

Recursos adicionais

• Customize text in Discourse
• How to translate customized text content?
• Introducing Discourse developer toolbar

[Moin]

@Discourse

Habilitando a configuração para todos os usuários

1. Navegue até a página de configurações do seu site
   a. Vá para a barra lateral de administração
   b. Selecione Todas as Configurações do Site
   b. Digite verbose no campo de filtro da página de configurações
2. Habilite a configuração do site verbose localization.

A configuração agora é uma configuração de site oculta, então você não a encontrará mais em “todas as configurações do site”

config/site_settings.yml

Portanto, agora você precisa de acesso ao console rails.

[benjamincfarmer (Ben Farmer)]

Como os sistemas hospedados devem acessar esta propriedade agora?

[Lilly]

@benjamincfarmer

Como os sistemas hospedados devem acessar essa propriedade agora?

assim

@Discourse

Habilitando a configuração para uma sessão individual

ou você pode usar as ferramentas de desenvolvedor

@david

Localização detalhada

\nAlterna o recurso de localização detalhada