O Heronite está em inglês, português (Brasil), espanhol e alemão. Correções e novos idiomas são bem-vindos: você só edita arquivos JSON.
Como funcionam os arquivos de idioma?
O texto em inglês no código é a chave. Cada idioma tem uma pasta com arquivos JSON, um para cada parte do app:
crates/i18n/locales/
├── pt-BR/
│ ├── common.json
│ ├── settings_panel.json
│ └── …
├── es/
└── de/Cada arquivo é um objeto simples que liga o texto em inglês à tradução:
{
"Add a game": "Adicionar um jogo",
"verb|Play": "Jogar",
"{n} games": "{n} jogos"
}- Um
context|na frente de uma chave diferencia a mesma palavra em inglês usada de maneiras diferentes (como “Play”, o verbo). Traduza só a parte depois do|. - Marcadores como
{n}precisam ficar iguais na tradução. - Os plurais têm uma chave separada para o singular e para o plural.
Corrigir uma tradução
-
Encontre o texto em inglês nos arquivos JSON do seu idioma e edite a tradução.
-
Rode a verificação. Ela lista as chaves que faltam ou sobram e os marcadores que não batem:
HERONITE_I18N_MISSING=1 cargo test -p heronite-i18n --test coverage -- --nocapture -
Para ver no app, compile o Heronite e escolha seu idioma em Configurações → Geral → Idioma.
-
Abra um pull request.
Adicionar um novo idioma
Copie uma das pastas para uma nova, com o nome do código do idioma (como fr ou it), e traduza os arquivos dela. Um novo idioma também precisa de algumas linhas de código em crates/i18n/src/lib.rs (o nome e o código dele). Se você não se sente à vontade com Rust, abra o pull request com a tradução e peça ajuda por lá.