Como escrever textos de origem que se traduzem bem

O que é

Escrever para tradução significa moldar o idioma de origem de modo que um tradutor, ou uma etapa de tradução automática, consiga produzir um texto de destino correto sem consultar o autor e sem que o código atrapalhe. O manual do GNU gettext (citado) lista as regras do lado do código: bom estilo em inglês, frases inteiras, divisão por parágrafos, strings de formato em vez de concatenação de strings, placeholders em vez de URLs embutidas. A página do manual sobre formas de plural (citada) acrescenta que as contagens devem passar pela função de plural, e não por um file%s montado à mão, porque os idiomas têm números diferentes de formas de plural; ela mostra idiomas com duas, três e mais formas, e regras de cabeçalho como nplurals=3. As diretrizes de estilo do Google para um público global (citadas) cobrem o lado da redação: terminologia e estrutura de frases consistentes, e a omissão de coloquialismos, expressões idiomáticas, humor e referências sazonais.

Por que importa

A ordem das palavras, o gênero, as regras de plural e o comprimento das frases variam de um idioma para outro. Uma string construída a partir de fragmentos ("Deleted " + n + " file(s)") não pode ser reordenada nem flexionada pelo tradutor; uma expressão idiomática exclusiva do inglês ou é traduzida literalmente ou é substituída por um palpite; uma frase que depende de um trocadilho em inglês simplesmente não tem texto de destino. Cada um desses casos acaba como uma pergunta ao autor ou como uma tradução errada em produção.

Como aplicar

• Uma string por frase ou rótulo completo; nunca monte uma frase a partir de pedaços em tempo de execução.
• Use placeholders nomeados ({count} files in {folder}) para que o tradutor possa reordená-los; deixe para os tradutores um comentário que explique o que cada placeholder contém.
• Faça passar todas as contagens pela função de plural do framework, inclusive no texto de origem em inglês ("1 file", "2 files"); não escreva "file(s)".
• Mantenha a terminologia fixa: um termo por conceito, retirado do glossário, para que a memória de tradução encontre correspondências.
• Prefira frases declarativas curtas com ordem de palavras padrão; evite sequências de substantivos empilhados e pronomes ambíguos ("it", "this") cujo referente não seja claro.
• Evite expressões idiomáticas, humor, referências culturais e sazonais, e exemplos que pressuponham os formatos de um único país; escreva datas, números e moedas com formatação sensível ao locale, e não dentro da string.
• Deixe margem: uma tradução pode ser mais longa do que o original, por isso layouts e larguras de coluna não devem partir do comprimento do texto de origem.
• Marque no texto de origem, com o mecanismo da ferramenta, o que não deve ser traduzido (nomes de produtos, comandos, código).

Armadilhas

Reutilizar uma mesma string para dois significados ("Open" como verbo e como estado). Frases divididas entre vários elementos da interface. Capturas de tela com texto em inglês embutido. Alterar strings de origem por motivos estéticos, o que invalida todas as traduções existentes dessa string.