O texto do produto fica pronto para localização quando é centralizado em uma única fonte primeiro: textos espalhados pelos componentes como literais não ficam prontos para localização só de serem reescritos, porque não há uma fonte de referência para traduzir. O trabalho de clareza, os glossários e os guias de estilo importam, mas só compensam depois que as strings vivem em um único catálogo. Esta página traz a sequência, na ordem que funciona.
A maioria dos conselhos sobre o tema começa pelo passo dois. Recomendam escrever em linguagem simples, evitar expressões idiomáticas e dar contexto aos tradutores. Tudo isso é bom conselho, mas nada disso pode ser aplicado enquanto a mesma mensagem aparece em cinco formas ligeiramente diferentes espalhadas pelos seus componentes. O contexto conceitual, e o argumento de por que a base de código deveria ser a fonte da verdade para o texto do produto, estão em texto de produto nativo do código. Esta página apresenta a ordem prática dos passos.
O que significa estar pronto para localização?
Significa que um tradutor, ou uma ferramenta de tradução, recebe o seu texto e consegue produzir uma versão fiel sem precisar adivinhar. Isso exige três condições: cada string existe em exatamente um lugar acordado, cada string diz uma coisa clara e quem a traduz consegue saber onde e como ela é usada.
As três não são igualmente fáceis de corrigir depois. A redação pode ser melhorada string por string. O contexto pode ser adicionado como notas. Mas "exatamente um lugar acordado" é uma questão estrutural. Se isso falta, as outras duas não têm onde se apoiar: você não consegue melhorar uma string cuja gêmea mora em outro arquivo, nem anotar uma mensagem que não tem um endereço único.
Por que a fonte limita a qualidade da tradução?
Porque tradução é trabalho derivado, e trabalho derivado herda todas as falhas daquilo de que deriva. A tradução leva a ambiguidade da fonte para cada idioma de destino, e leva a inconsistência também. Se a fonte diz "Sign in" em uma tela, "Log in" em outra e "Login" em uma terceira, você passa a ter três termos em cada idioma, traduzidos de forma independente, sem como saber qual deles era a intenção.
É também por isso que a correção habitual, polir as traduções, ataca a ponta errada. Cada idioma que você adiciona multiplica o custo de uma fonte não corrigida. Corrigir a fonte uma vez a corrige em todos os lugares, inclusive nos idiomas que você ainda nem adicionou.
Existe um nome para a falha de fundo. Copy drift é o texto visível ao usuário divergindo da sua fonte aprovada entre telas e ao longo do tempo, sem uma única fonte da verdade. O que é copy drift trata das causas. A localização é onde isso fica caro, porque a divergência é copiada para cada idioma.
Por que não dá para deixar o texto espalhado pronto para localização?
Porque não há nada para entregar. Um literal dentro de um componente não é uma unidade que a etapa de tradução consiga pegar. Ele está misturado com marcação e lógica, pode ser montado a partir de fragmentos, e a mesma frase pode existir em vários arquivos com pequenas diferenças que ninguém escolheu.
Reescrever esses literais no lugar não muda isso. Você pode deixar cada um mais claro e ainda assim não ter catálogo, nem uma lista acordada do que o produto diz, nem como saber se encontrou todos. O resultado é um texto mais arrumado nos mesmos lugares espalhados.
Portanto, o primeiro passo não é um trabalho de edição. É um trabalho de coleta: colocar toda string visível ao usuário em um único catálogo, em um único idioma de origem, no repositório, referenciada por chave a partir dos componentes. Faça isso sem alterar a redação. O objetivo desta etapa é descobrir o que o produto diz hoje, inclusive as partes que se contradizem.
Como coletar as strings?
Mova-as primeiro para um catálogo e melhore-as depois. Há dois motivos para essa ordem. Uma etapa mista, em que você reescreve enquanto move, esconde o que mudou dos revisores e de você mesmo. E, quando tudo está em um único arquivo, duplicatas e quase-duplicatas deixam de ser invisíveis: ficam lado a lado, e a limpeza se resume a ler um arquivo.
Na prática:
- Escolha um catálogo por idioma de origem, no repositório. Uma cópia de referência que pessoas e ferramentas consigam ler. Como organizá-lo e nomear as chaves está em como manter o texto da interface consistente em uma base de código; é o mesmo catálogo, então aquela página é a referência de estrutura e esta não a repete.
- Troque os literais por referências a chaves. Toda string que um usuário possa ler, incluindo rótulos de botões, mensagens de erro, estados vazios, tooltips e textos de acessibilidade, que costumam ser os retardatários.
- Mantenha as frases inteiras. Se uma mensagem é montada juntando fragmentos, transforme-a em uma única entrada com variáveis, para que a unidade que o tradutor vê seja a unidade que o usuário lê. A ordem das palavras muda entre idiomas, e uma frase montada no código não consegue acompanhá-la.
- Ainda não reescreva. Resista à tentação. Você vai encontrar os textos estranhos; anote e siga em frente.
Se essa lista parece um mês de trabalho cuidadoso em uma base de código grande, esse é o custo real da etapa e o motivo de ser onde a maioria dos times trava.
O que fazer quando as strings já estão em um único catálogo?
Agora o conselho de sempre finalmente tem onde ser aplicado. Com um único catálogo, cada um destes passos vira uma passada só, em vez de uma caçada:
- Remova duplicatas e quase-duplicatas. Escolha a redação aprovada para cada mensagem e aponte todos os usos para ela.
- Fixe os termos que nunca podem variar. Nomes de funcionalidades, os verbos das ações principais, palavras que você decidiu não usar. Registre tudo uma vez. Esse é o seu glossário, e ele é curto.
- Escreva de forma simples. Voz ativa, sem expressões idiomáticas, sem piadas que dependem do trocadilho de um idioma, com siglas por extenso onde possam ser mal interpretadas. Cada string diz uma coisa.
- Dê contexto aos tradutores. Uma nota sobre onde a string aparece e o que uma variável representa. Strings curtas como "Post" ou "Order" são a armadilha clássica: substantivo ou verbo, e o idioma de destino pode precisar de uma palavra diferente para cada um.
- Preveja espaço para o crescimento do texto. O texto traduzido costuma ser mais longo que o original, então projete layouts que não quebrem quando um rótulo cresce. Trate isso como uma restrição de design, e não como um percentual fixo para contornar no planejamento.
Cada passo é rápido porque o catálogo é o único lugar onde ele acontece. Sem o catálogo, os mesmos cinco passos viram cinco caças ao tesouro pela base de código, e você nunca sabe quando terminou.
O que definir antes de escolher um fornecedor ou uma ferramenta de tradução?
A fonte e o fluxo de revisão. Um fornecedor ou uma ferramenta traduz o que você entrega. Entregue um catálogo limpo e um glossário curto e o trabalho sai bom. Entregue literais espalhados e você vai pagar para traduzir as inconsistências e pagar de novo para corrigi-las em cada idioma.
Decida primeiro três coisas. Qual arquivo é a fonte da verdade. Quem aprova uma mudança de redação. E como uma string nova ou alterada chega à tradução: manualmente, por um script ou por um pull request que já vem com as traduções anexadas. Essa última é a que impede as traduções de ficarem para trás em relação à fonte, o problema descrito em por que os arquivos de tradução ficam dessincronizados.
O que muda quando o texto já vive no repositório?
A localização deixa de ser um projeto separado. Quando o catálogo está no repositório, uma string nova ou alterada aparece como uma linha no diff, as traduções dela podem ser geradas e revisadas no mesmo fluxo de pull request do código, e ninguém precisa exportar uma planilha e torcer para que ela volte em ordem.
É por isso que, em uma base de código, manter o texto consistente e mantê-lo pronto para localização são a mesma operação. As duas dependem de uma única fonte acordada. Faça o trabalho uma vez e você ganha as duas. Times que desenvolvem com ferramentas de codificação com IA sentem isso mais cedo, porque um agente reescreve ou reintroduz um literal sem fazer alarde, a menos que o catálogo e uma regra de lint estejam no caminho; como impedir que agentes de codificação com IA reescrevam o texto da sua interface trata desse caso.
Onde a globalize.now se encaixa
A globalize.now é um sistema de gestão de textos nativo do código, com localização integrada, e a etapa de centralização acima é a parte que ela faz por você. Você conecta um repositório do GitHub ou GitLab no app. Uma varredura identifica o que existe. Se as strings são literais dentro de componentes, uma conversão única as move para um catálogo, referenciadas por chaves, e adiciona a configuração de i18n, caso não haja nenhuma; se você já usa uma biblioteca como next-intl, react-i18next, i18next ou Lingui, ela trabalha com o que você tem. O resultado chega como um pull request em uma branch própria, então o primeiro catálogo passa exatamente pela revisão descrita acima. Depois disso, as novas strings de origem que você adiciona são traduzidas por jobs de push que abrem um pull request com o resultado. O repositório continua sendo a única fonte da verdade, e o guia para quem já tem i18n mostra o que a varredura encontra quando já existe uma configuração.
Estamos construindo para que essa mesma disciplina valha no site institucional, na landing page e no produto a partir de uma única fonte. É para onde estamos indo, não algo para comprar hoje. Os preços estão na página de preços.
A ordem, em resumo
- Reúna toda string visível ao usuário em um único catálogo no repositório. Não reescreva.
- Mantenha as frases inteiras e referencie cada string por chave.
- Remova duplicatas e escolha a redação aprovada uma única vez.
- Escreva o glossário curto dos termos que nunca variam.
- Edite para uma linguagem simples e adicione notas de contexto para os tradutores.
- Decida quem aprova a redação e como as strings alteradas chegam à tradução.
- Só então escolha, ou troque, o fornecedor ou a ferramenta de tradução.
Se o primeiro passo é o que parece um mês de trabalho, conecte um repositório, leia o plano que ele propõe e revise o pull request que ele abre.
O globalize.now transforma textos fixos do app em arquivos de locale prontos para tradução e os mantém atualizados a cada novo lançamento.
Experimente o globalize.now grátis