Documentação
Idiomas
O site pode ter um idioma só ou quantos você quiser. Cada idioma tem o seu endereço, e o conteúdo é traduzido campo a campo no painel.
Como funciona
- Você declara a lista de idiomas (
pt-BR,en,es,fr…) e escolhe qual é o principal. - O idioma principal fica sem prefixo na URL; os outros ficam em
/<código>:/sobre(principal),/en/sobre,/es/sobre. O código do prefixo é a primeira parte do idioma (pt-PTvira/pt). Dois idiomas com o mesmo prefixo, comopt-BRept-PTjuntos, não são aceitos. - Qualquer idioma pode ser o principal. Um site em inglês tem
/em inglês e/ptem português. - Com um idioma só, não há prefixo nem seletor de idioma.
- Cada página tem
hreflange canonical em todos os idiomas em que existe, o que o Google pede.
Conteúdo sem tradução
O Rubrica só gera o que está traduzido:
- Um post ou uma página sem tradução num idioma não existe nesse idioma: não entra nas listas, no sitemap, no RSS nem no
hreflang. - O seletor de idioma, numa página que não existe no outro idioma, leva para a home daquele idioma.
- Os textos de interface (menu, botões, formulários, 404) sem tradução caem no idioma principal, para nada aparecer em branco.
- O painel mostra o que falta traduzir em cada item.
Assim, você pode lançar o site em português e ir traduzindo aos poucos, sem páginas vazias nem erros 404 dentro do próprio site.
Escolher na criação
npx create-rubrica@latest meu-site --idiomas pt-BR,en --idioma-principal pt-BR
Sem --idioma-principal, vale o primeiro da lista. Sem --idiomas, o site nasce em pt-BR.
Mudar depois
npx create-rubrica config --idiomas pt-BR,en,es
npx create-rubrica config --idioma-principal en
Antes de gravar, o comando avisa duas coisas:
- Idioma novo: o conteúdo só aparece nele depois de traduzido.
- Idioma principal novo: as URLs mudam (o principal fica sem prefixo), então considere redirecionamentos.
A lista de idiomas é configuração técnica: só o papel root mexe nela no painel.
Traduzir
Cada campo de texto traduzível no painel tem uma aba por idioma. Dá para traduzir de três jeitos:
- À mão, no painel.
- Com o agente: o MCP tem o prompt
traduzir-conteudo, que completa um idioma e mostra a prévia antes de gravar. Veja Agentes. - Com IA no painel: ligue o plugin Tradução com IA (usa o OpenRouter, com a chave
OPENROUTER_API_KEY). Ele preenche o botão "traduzir" de cada campo. Veja Integrações. É um plugin comum: dá para desligar ou trocar.
Migrando da v1
O site da v1 tinha português e inglês. Na migração, o idioma principal é pt-BR e as URLs /en ficam exatamente iguais. Veja Migrar da v1.