Auxiliar de Internacionalização
Ajuda a gerenciar internacionalização (i18n) e localização (l10n) em aplicações multilíngues.
Quando Usar
- O usuário solicita suporte i18n
- Adicionar novos idiomas
- Encontrar strings não traduzidas
- Gerenciar arquivos de tradução
- O usuário menciona "tradução", "i18n", "l10n", "localidade"
Instruções
1. Detectar Framework i18n
JavaScript/React:
- react-i18next
- react-intl (FormatJS)
- i18next
- LinguiJS
Vue:
- vue-i18n
Python:
- gettext
- Django i18n
- Flask-Babel
Ruby/Rails:
- Gem I18n (integrada)
Procure por imports, arquivos de configuração ou diretórios de tradução.
2. Encontrar Strings Fixas
Procure por texto não traduzido:
// Ruim: Fixo
<button>Enviar</button>
<p>Bem-vindo, {user.name}!</p>
// Bom: Traduzido
<button>{t('comum.enviar')}</button>
<p>{t('boasvindas.mensagem', { name: user.name })}</p>
Padrões de busca:
- Strings em tags JSX/template
- Mensagens de alerta/erro
- Rótulos e placeholders de formulários
- Texto de botões
- Mensagens de validação
Excluir: comentários de código, console.log, strings de teste.
3. Extrair para Arquivos de Tradução
Formato React-i18next (JSON):
{
"comum": {
"enviar": "Enviar",
"cancelar": "Cancelar"
},
"boasvindas": {
"mensagem": "Bem-vindo, {{nome}}!"
}
}
Formato Gettext (.po):
msgid "botao_enviar"
msgstr "Enviar"
msgid "mensagem_boasvindas"
msgstr "Bem-vindo, %(nome)s!"
4. Organizar Chaves de Tradução
Melhores práticas:
- Namespace por funcionalidade:
usuarios.perfil.titulo - Agrupar strings comuns:
comum.botoes.salvar - Descrever contexto, não conteúdo:
erros.login.invalidonãoerros.senha_errada - Convenção de nomenclatura consistente
5. Verificar Cobertura de Tradução
Compare arquivos de localidade para encontrar traduções faltantes:
pt-BR.json: 150 chaves
en.json: 150 chaves ✓
es.json: 142 chaves (faltam 8)
Faltando em es.json:
- usuarios.perfil.bio
- configuracoes.privacidade.titulo
[...]
6. Gerenciar Pluralização
Diferentes idiomas têm regras de plural diferentes:
// react-i18next
t('itens', { count: 0 }) // "0 itens"
t('itens', { count: 1 }) // "1 item"
t('itens', { count: 5 }) // "5 itens"
// Arquivo de tradução
{
"itens_zero": "{{count}} itens",
"itens_one": "{{count}} item",
"itens_other": "{{count}} itens"
}
7. Formatação de Data, Hora e Números
Use formatação sensível à localidade:
// Números
const preco = new Intl.NumberFormat('pt-BR', {
style: 'currency',
currency: 'BRL'
}).format(29.99);
// Datas
const data = new Intl.DateTimeFormat('pt-BR').format(new Date());
8. Suporte RTL (Direita para Esquerda)
Para árabe, hebraico:
- CSS:
direction: rtl; - HTML:
<html dir="rtl"> - Propriedades lógicas:
margin-inline-startem vez demargin-left
9. Gerar Template de Tradução
Crie template para nova localidade:
# Copiar chaves do idioma base, valores vazios
cp locais/pt-BR.json locais/de.json
# Marcar para tradução
10. Melhores Práticas
- Mantenha traduções em arquivos separados
- Use chaves, não o texto fonte como chave
- Forneça contexto para tradutores
- Teste com strings longas (alemão costuma ser mais longo)
- Use ICU MessageFormat para strings complexas
- Evite concatenar strings traduzidas
- Extraia todo texto voltado ao usuário
Arquivos de Suporte
templates/i18n-config.js: Exemplos de configuraçãotemplates/arquivo-localidade.json: Template de arquivo de tradução