Pular para o conteúdo principal

Strings da interface e i18n

As strings da interface são separadas das traduções de conteúdo do produto. O conteúdo do produto é escrito por pessoas operadoras para tours, tiles e eventos. Os textos da aplicação, incluindo botões, navegação e erros, são mantidos como textos da interface do produto.

Como os textos da interface funcionam​

O Scoutello organiza os textos da interface por área, como navegação compartilhada, rótulos do dashboard, rótulos do aplicativo para visitantes e páginas de marketing. Isso mantém cada experiência focada nos textos de que precisa.

Quando uma string da interface está ausente, o problema deve aparecer durante a revisão para que o texto possa ser corrigido antes de chegar a visitantes ou pessoas operadoras.

Grupos de textos​

Os grupos de textos mantêm o trabalho de localização focado:

  • Elementos fundamentais compartilhados e reutilizados em toda a aplicação.
  • Textos específicos do dashboard.
  • Textos específicos do aplicativo para visitantes.
  • Pacotes específicos de marketing ou landing pages, quando dividir o empacotamento melhora o desempenho.

Adicionar ou alterar textos​

Novos textos da interface devem usar chaves de tradução estáveis e linguagem neutra. Os detalhes técnicos para adicionar chaves estão no onboarding interno; a documentação pública deve descrever o resultado esperado para o texto.

Diretrizes seguidas internamente pelas equipes:

  • Evitar construir chaves dinamicamente — a análise estática precisa identificar chaves literais.
  • Preferir placeholders de interpolação em vez de concatenar fragmentos traduzidos.
  • Manter uma linguagem neutra em termos de gênero.
  • Nos textos em alemão, evitar o tratamento informal direto para manter um tom neutro entre os públicos.

A automação do workspace mantém os pacotes de localização alinhados após alterações nos textos.

Texto da interface versus conteúdo do produto​

  • Valores escritos por pessoas operadoras que visitantes leem em uma página publicada → fluxo de tradução de produto.
  • Rótulos pertencentes à própria aplicação → fluxo de strings da interface.
  • Frases mistas devem manter a gramática fixa nas traduções da interface e passar nomes ou números definidos por pessoas autoras como variáveis.

Conceitos relacionados: Como funcionam as traduções, Tradução automática, Idiomas e localização.