Neste tópico, vamos guiá-lo pelas funcionalidades de Localização de Conteúdo e como ativá-las. As funcionalidades são divididas em duas partes: o que está disponível por padrão no Discourse; e o Discourse AI para traduções automáticas.
Para acesso rápido às seções relevantes, use os cabeçalhos da wiki ![]()
Localizando o Conteúdo da Sua Comunidade
O Discourse oferece acesso a várias funcionalidades de localização disponíveis para configuração em:
<url-do-seu-site>/admin/site_settings/category/content_localization
Preparação
Primeiro, é bom obter algumas informações sobre sua comunidade via Data Explorer.
Idioma via preferências do usuário
A seguinte consulta pode dar uma ideia de quantos usuários podem ter definido seu idioma em /my/preferences/interface.
SELECT locale, count(*) as count
FROM users
WHERE (locale IS NOT null AND locale <> '')
GROUP BY locale
ORDER BY count DESC
De onde seus usuários estão vindo
Uma solução melhor, se você tiver Eventos de visualização de página do navegador ativados (configuração do site), é esta consulta que informa de qual país seu usuário é:
SELECT
e.country_code AS country_code,
COUNT(*) AS pageviews
FROM browser_pageview_events e
WHERE e.country_code IS NOT NULL
AND e.country_code <> ''
GROUP BY e.country_code
ORDER BY pageviews DESC
Configuração
Com as informações acima, você está agora mais informado sobre quais idiomas sua comunidade deve suportar.
Em <url-do-seu-site>/admin/site_settings/category/content_localization, comece a configurar isso.
Localização de conteúdo ativada- ativa a funcionalidade que substitui o conteúdo escrito original do usuário por conteúdo localizado. Leia mais sobre os modos de localização automática (IA) e manual (humana).Idiomas suportados pela localização de conteúdo- a lista de idiomas que seu site suportaParâmetro do rastreador de localização de conteúdo- abordado na seção de rastreadores abaixoSeletor de idioma de localização de conteúdo- abordado logo abaixo
Seletor de idioma
Ativar a configuração subsequente Seletor de idioma de localização de conteúdo também permite tornar sua comunidade mais acessível a usuários não conectados, mostrando a lista de idiomas que você escolheu na lista de idiomas suportados:
Visualizando conteúdo localizado
Para os visualizadores de conteúdo localizado (todos os visitantes do site), eles podem passar o cursor sobre o indicador ao lado da data da publicação para ver o idioma original da publicação. Este indicador só aparece se a publicação não estiver no idioma deles. Eles podem simplesmente clicar no indicador para ver a publicação original também.
Para nossos visualizadores conectados multilíngues, eles podem indicar que entendem vários idiomas, então o conteúdo nesses idiomas não será traduzido.
Traduções automáticas com Discourse AI 
O Discourse AI é altamente essencial para a funcionalidade de localização e elimina a necessidade de fazer traduções manuais.
Como administrador, você deve ir para nossa área dedicada no Discourse AI para Traduções. Esta área dedicada abrange:
- progresso da tradução
- configurações de IA
- configurações de idioma do aplicativo
Para abordar algumas configurações e recomendações importantes:
Taxa horária de preenchimento de tradução IA- esta configuração tem como padrão50- seu site traduzirá 50 publicações, 50 tópicos, 50 categorias, 50 tags por hora, para os idiomas que você definiu emIdiomas suportados pela localização de conteúdo. Mantenha isso em um número baixo quando estiver começando.Escopo de categoria de tradução IA- tem como padrãoCategorias públicas. Você pode alterar isso para todas as categorias ou uma seleção específica.Mensagens pessoais de tradução IAeIncluir conteúdo de bot na tradução IAsão autoexplicativas.Data de início do preenchimento de tradução IA- este valor está vazio por padrão. Se você ativar a funcionalidade de tradução IA “hoje”, a data é automaticamente definida para “hoje - 5 dias”Agente tradutor de texto bruto de publicação IA(e outros agentes) - Em comunidades mais formais, os administradores podem optar por criar seu próprio agente. Isso permite definir um prompt mais ajustado ao idioma ou vocabulário que você prefere.
Você pode consultar AI bot - Agents sobre como configurar agentes adequados e ajustar prompts para cada função.
Localização manual
Como a localização é uma funcionalidade central no Discourse, fornecemos a capacidade de preencher e editar localizações manualmente caso as traduções automáticas com Discourse AI não estejam disponíveis.
Por padrão, administradores e moderadores estão configurados para editar localizações.
Atualmente, temos conteúdo de publicação, título do tópico, nome da categoria, descrição da categoria, nome da tag, descrição da tag e localizações da barra lateral. As seções subsequentes abaixo mostrarão como elas funcionam.
Localização de categoria
Categorias localizadas são visíveis nas seguintes áreas, com nome e descrição da categoria localizados:
Locais onde as categorias são localizadas 📸
- Página inicial, barra lateral e menu suspenso de categorias
- Página de categorias
- Uma categoria específica com subcategorias
Como administrador, você deve poder acessar as configurações da categoria como de costume e encontrar o novo item de navegação “Localizações” à esquerda.
Localização de tópico e publicação
A partir das capturas de tela acima em Localização de categoria, você pode ter notificado títulos de tópicos e resumos sendo localizados.
Existem algumas configurações pré-requisito
- Certifique-se de que seu usuário esteja em
grupos permitidos para localização de conteúdo - O botão
addTranslationé adicionado automaticamente aomenu da publicaçãoeitens ocultos do menu da publicaçãoquandoLocalização de conteúdo ativadaestá ligada. Isso permite que o
apareça no menu da publicação para usuários em grupos permitidos para localização de conteúdo. Permitir localização do autor na localização de conteúdoestá ativado por padrão e permite que os autores das publicações localizem seu próprio conteúdo usando o mesmo menu da publicação acima.
Editando uma publicação localizada
Caso o usuário esteja visualizando uma publicação localizada e queira editar a publicação, uma caixa de diálogo aparecerá perguntando qual versão eles preferem editar:
O compositor apropriado aparecerá após a decisão.
Localização personalizada da barra lateral
Seções da barra lateral que são “visíveis para todos” também mostram controles adicionais de tradução:
Rastreadores
Você pode permitir que rastreadores vejam seu site nos vários idiomas que você configurou em Idiomas suportados pela localização de conteúdo. A configuração do site reside na seção “Localização de conteúdo” como Parâmetro do rastreador de localização de conteúdo:
O resultado será que os rastreadores podem ver o seguinte, onde cada idioma suportado tem um hreflang correspondente no cabeçalho de cada tópico:
Para prova/verificação extra
Testamos esta funcionalidade extensivamente e podemos confirmar que estamos sendo indexados corretamente após introduzir X números de idiomas suportados
FAQ
Configurei as coisas, mas a tradução automática ainda não está funcionando para mim
Confirme se você configurou isso
Idiomas suportados pela localização de conteúdotem pelo menos um idiomaLocalização de conteúdo ativadaestá
Permitir idioma do usuárioestá
(ativado por padrão)Definir idioma a partir do cookieestá
Tradução IA ativadaestá
- Você deve ter um LLM funcionando definido para cada agente de tradução
Se nada mais funcionar, você pode ativar SiteSetting.ai_translation_verbose_logs.
As traduções automáticas são salvas ou são enviadas ao LLM cada vez que alguém visualiza um tópico?
As traduções são salvas, cada publicação é enviada apenas uma vez por idioma e as traduções são reutilizadas.
Se meu fórum suporta inglês e japonês (via Idiomas suportados pela localização de conteúdo), e alguém escreve em espanhol, sua publicação será traduzida?
Sim. Todos os tópicos e publicações serão traduzidos para inglês e japonês, independentemente do idioma escrito.
Se a publicação original for editada, ela será re-traduzida?
Sim – com um máximo de 2 vezes por dia. Quando uma publicação é editada, ela é enviada para re-tradução após um atraso maior de 5 minutos ou do SiteSetting.editing_grace_period para levar em conta edições ninja. Usuários autorizados em grupos permitidos para localização de conteúdo têm a opção de enviar uma publicação para re-tradução imediatamente.
As traduções serão excluídas se eu mudar o Agente ou LLM?
Não, as traduções normalmente persistirão através de mudanças de configurações, a menos que sejam explicitamente excluídas usando o item do menu da publicação ou o compositor de tradução.


























