Traduzindo o Snipp

O Snipp é traduzido por sua comunidade, e adoraríamos sua ajuda. Se você é fluente em outro idioma, pode aprimorar traduções existentes ou ajudar a levar o Snipp a um novo idioma. Este guia cobre tudo o que você precisa.

Recompensas

  • Contribuições significativas concedem a você a exclusiva insígnia Tradutor no seu perfil do Snipp.

  • Você também receberá o cargo de Tradutor no nosso servidor do Discord.

  • Os principais colaboradores podem receber o Snipp PLUS como agradecimento.

Primeiros Passos

O melhor lugar para começar é o nosso servidor do Discord onde os tradutores se coordenam, reivindicam idiomas e recebem ajuda. Avise-nos em qual idioma você gostaria de trabalhar para que os esforços não sejam duplicados.

Duas Formas de Traduzir

Há duas formas de contribuir com traduções. Escolha a que melhor combina com você, não é preciso usar as duas.

Crowdin

A opção mais fácil. Traduza diretamente no seu navegador, sem precisar de conhecimento de JSON ou Git. O Crowdin mostra cada texto em seu contexto e cuida da formatação para você. Recomendado para a maioria dos tradutores.

Abrir o Crowdin

GitHub

Para desenvolvedores familiarizados com o Git. Edite os arquivos JSON de idioma diretamente e abra um pull request. Ideal se você quer controle total ou está adicionando um novo idioma.

Abrir o repositório

Como os Arquivos Funcionam

Cada idioma é um arquivo JSON simples. A chave é um ID estável e nunca muda. O valor é o texto exibido aos usuários, e é a única coisa que você traduz:

{
  "SETTINGS_PREFS_AUTO_COMPRESSION_LABEL": "Automatic Compression",
  "SETTINGS_PREFS_PARTY_MODE_LABEL": "Party Mode"
}

O arquivo em inglês é a fonte da verdade. Todos os outros idiomas têm exatamente o mesmo conjunto de chaves, então você só altera os valores.

Regras

  • Nunca adicione, remova ou renomeie chaves. Novas chaves vêm do código-fonte do Snipp. Se uma chave estiver faltando no seu idioma, o site recorre ao inglês.

  • Mantenha os marcadores idênticos. Textos como {count} ou {username} são substituídos em tempo de execução. Mantenha exatamente os mesmos marcadores, embora você possa movê-los para se adequar à ordem das palavras do seu idioma.

  • Siga a convenção de maiúsculas. Rótulos curtos de interface usam Maiúsculas Iniciais em todos os idiomas. Frases completas usam capitalização normal de frase do seu idioma.

  • Não traduza marcas ou termos técnicos. Deixe Snipp, Discord, ShareX, URL, API, PLUS e extensões de arquivo como estão.

  • Mantenha o JSON válido. Use aspas duplas, uma vírgula após cada entrada exceto a última e sem vírgulas finais.

  • Preserve os espaços no início e no fim se um valor os tiver. Eles são intencionais e usados para unir frases.

Enviando pelo GitHub

Se você escolheu o caminho do GitHub, aqui está o fluxo. Os tradutores do Crowdin podem pular esta seção, suas alterações são enviadas de dentro do próprio Crowdin.

As traduções são enviadas pelo repositório i18n no GitHub usando o fluxo padrão de fork e pull request:

  • Faça um fork do repositório, depois clone o seu fork e crie uma nova branch para a sua alteração.

  • Edite o arquivo de idioma da sua língua e traduza os valores que deseja aprimorar.

  • Execute o script de validação a partir da raiz do repositório e corrija o que ele apontar antes de enviar.

  • Faça o commit, envie para o seu fork e abra um pull request para a branch principal. Um mantenedor revisa e faz o merge.

Prefere não usar a linha de comando? O editor web do GitHub também funciona. Abra o arquivo de idioma, clique no ícone de lápis, edite e proponha suas alterações.

Adicionando um Novo Idioma

O Snipp ainda não oferece suporte ao seu idioma? Abra uma issue no GitHub propondo o idioma e o seu código de localidade, copie o arquivo-fonte em inglês como ponto de partida, traduza todos os valores e abra um pull request. Um mantenedor registra o novo idioma no site.

Pronto para Ajudar?

Entre no nosso servidor do Discord para reivindicar um idioma, conhecer outros tradutores e começar.

Mais artigos