Hallo, Bonjour, Hola: ensinando três novos idiomas ao meu blog com Polylang e um pequeno exército de agentes de IA

Todo post aqui agora existe em inglês, alemão, francês e espanhol: Polylang, um pipeline de tradução com revisão de IA independente e agentes em paralelo.

Ilustração do artigo sobre a tradução do blog para quatro idiomas

🌐 Também em: English · Deutsch · Français · Español · Italiano · Nederlands · Polski

Ilustração: um homem monta um touro diante de monitores, com bandeiras da Alemanha, da França, dos EUA e da Espanha

Por quase dois anos este blog falou exatamente um idioma. O inglês é a língua franca dos sysadmins, então parecia tudo bem. Mas eu sou alemão, boa parte dos meus leitores também não tem o inglês como língua materna, e quando alguém pesquisa “ZFS RAIDZ1 NAS Debian” em alemão, francês ou espanhol, recebe resultados em alemão, francês ou espanhol. Não os meus.

Então, nesta semana, o blog aprendeu três novos idiomas. Todo post publicado agora está disponível em inglês, alemão, francês e espanhol, com um seletor de idioma no menu e uma linhazinha “🌐 Also available in” acima de cada post. Este post é o making-of: o plugin, o pipeline, o bug que deu 404 num idioma inteiro e o que aprendi sobre colocar um pequeno exército de agentes de IA para trabalhar em paralelo. O mesmo fluxo de sempre: eu tomo as decisões, meu co-admin de IA (Claude) fez o trabalho pesado.

Índice

🎯 Para quê? Mais leitores, espero

Sejamos honestos sobre a motivação: espero mais visitantes vindos dos buscadores. Google, Bing e DuckDuckGo associam as buscas a páginas no idioma de quem pesquisa. Um admin alemão procurando uma correção para o fail2ban tem muito mais chance de digitar palavras-chave em alemão, e uma página que existe em alemão tem uma chance real de aparecer ali. Com tags hreflang corretas, o buscador também sabe que as quatro versões andam juntas, então pode mostrar a cada pessoa a versão no idioma dela em vez de tratá-las como conteúdo duplicado.

Vai funcionar? Ainda não faço ideia. Há um tempo contei meus leitores reais, humanos (spoiler: bem menos do que os logs de requisições sugerem), e vou contar de novo daqui a alguns meses. Se as páginas traduzidas trouxerem pessoas que nunca teriam achado o original em inglês, o experimento valeu a pena. Se não, escrevo esse post também.

🧩 O plugin: Polylang, e por quê

Escolhi o Polylang, na versão gratuita. Meus critérios eram simples: gratuito, open source (GPLv3), sem conta, sem serviço na nuvem e sem tradução automática mandando meu conteúdo para algum lugar. O Polylang não traduz nada sozinho. Ele só sabe qual post está em qual idioma e quais posts andam juntos, e faz isso guardando o idioma como uma taxonomia comum do WordPress. Sem tabelas extras, nada exótico no banco de dados.

As configurações que escolhi, e por quê:

  • O inglês continua sendo o padrão, sem /en/ na URL. Todo link, favorito e backlink existente continua funcionando. Os novos idiomas ficam em /de/, /fr/ e /es/.
  • Sem detecção do idioma do navegador. Os crawlers dos buscadores não enviam idioma preferido, e não quero que um visitante que clicou num link em inglês seja jogado para outro lugar. Você recebe o que clicou; o seletor está ali se quiser outro idioma.
  • Mídia não é traduzida. Screenshot é screenshot. Os textos alt e as legendas nos posts são traduzidos, os arquivos de imagem são compartilhados.
  • Categorias e tags existem por idioma (“IT Security” vira “IT-Sicherheit”, “Sécurité informatique” e “Seguridad informática”), então as páginas de arquivo também funcionam em todos os idiomas.

A parte de SEO veio de graça: o Polylang adiciona as alternativas hreflang a cada página, e o sitemap XML do Yoast pega as traduções automaticamente. O menu ganhou quatro bandeirinhas como seletor de idioma, e um pequeno must-use plugin (implantado pelo meu role do Ansible, como todo o resto neste servidor) imprime a linha “Also available in”, mas só para os idiomas em que o post realmente existe.

O código Ansible de tudo isso, incluindo esse must-use plugin, está no meu repositório público no GitHub: aptupgrademe/www_k3s → roles/blog_wordpress.

Cabeçalho do apt-upgrade.me com o menu principal; as quatro bandeiras de idioma para inglês, alemão, francês e espanhol ao lado dos itens do menu estão destacadas com uma moldura vermelha
Quatro bandeiras no menu: um clique e você está lendo o mesmo post em outro idioma.

🤖 Sendo transparente sobre a parte da IA

Todas as traduções são feitas com IA. Digo isso na página Aviso sobre o uso de IA, que agora tem uma seção “Traduções”: o inglês é o original, os outros idiomas são traduções de IA verificadas por uma segunda passada de IA independente. Se algo soar estranho em alemão, francês ou espanhol, a versão em inglês é a referência, e fico feliz em saber.

🧪 O piloto, e o 404 que engoliu um idioma inteiro

Antes de mexer em cem posts, traduzi exatamente um: meu post sobre a página inicial em celulares. Ainda bem, porque o primeiro resultado foi espetacular do jeito errado: toda página em alemão retornava 404. Os posts existiam, o Polylang sabia deles, o seletor apontava para eles, e o WordPress dizia “nunca ouvi falar”.

O culpado: as regras de rewrite. Eu tinha configurado o Polylang via wp-cli e feito o flush das regras de rewrite pela linha de comando. No CLI, o filtro de prefixo de idioma do Polylang não está totalmente carregado, então o WordPress gerou todo feliz um conjunto novo de regras que não sabia nada de /de/. A correção foi quase constrangedora: apagar as regras em cache e deixar a próxima requisição normal do front-end reconstruí-las, desta vez com o Polylang totalmente carregado.

wp eval "delete_option('rewrite_rules');"
# then just load any page once – WordPress rebuilds the rules with the language prefixes

Lição anotada: tudo o que depende do contexto da requisição (idiomas, temas, alguns plugins de cache) deve regenerar seu estado numa requisição de verdade, não numa sessão de CLI.

🏭 O pipeline: 111 posts × 3 idiomas

111 posts publicados vezes três idiomas dá 333 traduções. Fazer isso à mão no editor nunca foi opção, então virou um pipeline. Cada post passa por cinco etapas:

  1. Exportar. Um script wp-cli despeja cada post como HTML do Gutenberg. Os blocos de código são recortados e substituídos por placeholders como <!--PLLCODE 3-->; o código original vai para um arquivo JSON separado. Um tradutor não consegue “melhorar” um comando de shell que nunca vê.
  2. Traduzir. Um agente de IA traduz o HTML para alemão, francês e espanhol, seguindo um guia de estilo (mais sobre isso abaixo), além de título, resumo e meta description por idioma.
  3. Verificar, mecanicamente. Um pequeno script Python compara cada tradução com o original: mesma sequência de comentários de bloco do Gutenberg, mesmos placeholders, o mesmo conjunto de destinos de links e de fontes de imagens, o mesmo número de linhas de tabela e itens de lista. Qualquer divergência e a tradução volta.
  4. Revisar, de forma independente. Um segundo agente, que nunca viu a tradução sendo escrita, compara original e traduções frase por frase e escreve suas correções como pares exatos de localizar e substituir, com um motivo para cada um. Toda string “antiga” precisa ocorrer exatamente uma vez, senão a mudança é rejeitada.
  5. Importar. Primeiro um dump do banco, depois um script rodando como www-data recoloca os blocos de código, publica as traduções com a data original, atribui as categorias e tags por idioma, reaproveita a imagem destacada, define a meta description do Yoast e liga as quatro versões no Polylang.

O coração da verificação mecânica são uma dúzia de linhas. Ela não entende uma única palavra de nenhum idioma, e é justamente essa a ideia:

def feats(h):
    return {
        'blocks': re.findall(r'<!-- (/?wp:[a-z0-9/-]+)', h),
        'code': sorted(re.findall(r'<!--PLLCODE \d+-->', h)),
        'href': sorted(re.findall(r'href="([^"]*)"', h)),
        'src': sorted(re.findall(r'src="([^"]*)"', h)),
        'tr': h.count('<tr'), 'li': h.count('<li'), 'img': h.count('<img'),
        'inline_code': len(re.findall(r'<code>', h)),
    }
# original and translation must produce identical features

📏 Um guia de estilo, como numa agência de tradução de verdade

Consistência em 333 textos não acontece por acaso. O guia de estilo fixa o tom (du em alemão, vous em francês, tú em espanhol), um glossário (“hardening” é sempre “Härtung”, “durcissement”, “bastionado”), formatos de número (2,6 s em vez de 2.6 s), a tipografia francesa com espaços não separáveis antes de : ; ? !, e uma lista de coisas que nunca são tocadas: comandos, caminhos, hostnames, números de versão, mensagens de erro, nomes de produtos. Links para posts relacionados mantêm seus títulos em inglês, com uma pequena nota “(em inglês)”, até que esses posts também sejam traduzidos.

🔍 A revisão valeu a pena?

Com certeza. A maioria das traduções estava boa, mas “boa” não é “certa”. Nos primeiros 26 posts, o revisor encontrou umas cem coisas para corrigir, distribuídas mais ou menos igualmente entre os três idiomas; só dois posts voltaram sem nada. A maioria era polimento de estilo, mas algumas eram erros de sentido de verdade, que um texto fluente esconde perfeitamente:

  • “a longer memory” (no sentido de: retenção de logs mais longa) tinha virado “mais RAM” em espanhol.
  • “customer-facing service” tinha virado “atendimento ao cliente” em francês.
  • Uma coluna de tabela “Focus” tinha virado “Prioridade”. Plausível, errado.

Balanço final depois dos 111 posts: 110 passadas de revisão (o post piloto foi verificado à mão) com 290 correções – 92 em alemão, 86 em francês, 95 em espanhol e 17 em títulos e meta descriptions. 26 posts voltaram sem uma única mudança. Além disso, eu mesmo descartei um punhado de sugestões do revisor, por exemplo uma que “corrigia” o trocadilho proposital “bei git push” (uma referência ao alemão “bei Gott”) e outra que teria mudado o sentido de uma frase em francês. No total, 333 traduções de posts mais as páginas estáticas entraram no ar em três dias.

🐝 Subagentes: um despachante, muitos trabalhadores

Aqui ficou interessante. Traduzir um post custa a uma IA muita leitura e escrita: o guia de estilo, o original, três traduções. Fazer 111 disso numa única conversa enterraria a conversa em texto muito antes do fim. Então a sessão principal virou um despachante e quase não traduziu nada:

  • Ela inicia um agente tradutor por post. Cada um é uma instância nova com contexto limpo: lê o guia de estilo e exatamente um post, escreve os arquivos, roda a verificação e reporta de volta com três linhas.
  • Quando um tradutor reporta, o despachante inicia um agente revisor para aquele post, rodando num modelo menor e mais barato (Sonnet), e imediatamente o próximo tradutor.
  • Quando uma revisão volta, o despachante aplica as correções, roda a verificação de novo e faz o upload.

Três a quatro tradutores e alguns revisores rodavam ao mesmo tempo. O contexto do próprio despachante continuou pequeno, porque tudo o que ele via eram relatórios curtos. Separar quem escreve de quem revisa tem um segundo benefício além do paralelismo: o revisor não tem apego à tradução. Não foi ele quem escreveu, não “lembra” por que uma frase foi formulada daquele jeito, ele só compara.

✅ Quando agentes em paralelo compensam

  • Tarefas independentes. O post 1370 não está nem aí para o post 1373. Sem estado compartilhado, sem problemas de ordem.
  • Entrada clara, saída clara. “Leia estes arquivos, escreva aqueles, rode esta verificação.” Um agente com um contrato nítido não precisa de idas e vindas.
  • Um portão mecânico. Como a verificação em Python pega estrutura quebrada, não preciso confiar em cada agente; confio no portão.
  • Contexto novo economiza orçamento. Um trabalhador que só lê o que precisa é mais barato do que uma conversa longa que arrasta todos os posts anteriores junto.

❌ Quando não compensam

  • Etapas entrelaçadas. Configurar o Polylang, caçar o 404, construir o script de importação: cada etapa dependia do resultado da anterior. Isso foi uma conversa, um cérebro, sem fan-out.
  • Coisas pequenas. Cada agente começa a frio e precisa ler o guia de estilo primeiro. Para uma correção de uma linha, a inicialização custa mais do que o trabalho.
  • Instruções confusas. Um revisor ganhou uma tarefa extra por cima (“troque também este título em espanhol de vosotros para tú”). Ele fez isso, e relatou honestamente que só tinha passado os olhos pelo alemão e pelo francês. Uma segunda revisão completa do mesmo post encontrou nove erros reais. Lição: mantenha a tarefa de cada agente limpa, e leia os relatórios, não só os números.

🧱 O limite real: a cota

Paralelismo não deixa os tokens mais baratos; só faz você bater na parede mais rápido. Por volta do almoço do primeiro dia, depois de uns dez posts prontos com quatro tradutores e três revisores em andamento, minha assinatura atingiu o limite da sessão. Os sete agentes morreram no mesmo segundo, deixando arquivos escritos pela metade. Nada quebrado online, porque nada é enviado antes de passar pela verificação e pela revisão. Depois do reset, os tradutores reiniciados foram instruídos a reaproveitar um arquivo que sobrou só depois de provar que ele estava completo em relação ao original, e a reescrevê-lo caso contrário. Desde então, menos agentes em paralelo e um ritmo mais constante. Com um limite de uso por sessão e por semana, é esse orçamento que decide a velocidade, não o número de agentes.

🚫 O que eu deliberadamente não fiz

  • Nada de chinês (nem japonês, nem …). Tentador pelo alcance, mas eu estaria publicando texto que nem consigo conferir por amostragem. Três idiomas que consigo ao menos acompanhar mais ou menos pareceram o limite honesto.
  • Nada de piloto automático totalmente sem supervisão. Em certo momento a ideia era um timer do systemd que iniciasse uma sessão de IA headless a cada poucas horas e continuasse traduzindo enquanto ninguém olhava. As verificações de segurança da minha ferramenta de IA se recusaram a configurar isso, e em retrospecto, com razão: uma IA sem supervisão com acesso de escrita via SSH a um servidor de produção é algo que um humano deve ligar deliberadamente, não algo que entra de mansinho como conveniência. Então o pipeline roda enquanto estou por perto.

📝 Ainda na lista

  • Terminar os posts restantes. Feito: todos os 111 posts estão online nos quatro idiomas (em 11 de outubro de 2026).
  • Apontar os links internos e as listas de “Posts relacionados” para as versões traduzidas e remover as notas “(em inglês)”. Feito (11 de outubro de 2026).
  • Páginas estáticas: Sobre e o Aviso sobre o uso de IA estão traduzidos e cada idioma tem seu próprio menu. Impressum e Política de Privacidade vêm assim que eu mesmo tiver lido as traduções.
  • Olhar as estatísticas de busca daqui a alguns meses e ver se alguém realmente veio.

Se você está lendo isto em alemão, francês ou espanhol: willkommen, bienvenue, bienvenido. E se uma frase soar como se tivesse sido escrita por um robô, é porque foi. Me avise, e um humano conserta.


📚 Posts relacionados

Alguns textos e imagens deste site foram criados com a ajuda de IA ou gerados por IA. Detalhes