Heronite está en inglés, portugués (Brasil), español y alemán. Las correcciones y los idiomas nuevos son bienvenidos: solo editas archivos JSON.
¿Cómo funcionan los archivos de idioma?
El texto en inglés del código es la clave. Cada idioma tiene una carpeta con archivos JSON, uno por cada parte de la app:
crates/i18n/locales/
├── pt-BR/
│ ├── common.json
│ ├── settings_panel.json
│ └── …
├── es/
└── de/Cada archivo es un objeto plano que va del texto en inglés a la traducción:
{
"Add a game": "Adicionar um jogo",
"verb|Play": "Jogar",
"{n} games": "{n} jogos"
}- Un
context|delante de una clave distingue la misma palabra en inglés usada de formas distintas (como “Play” el verbo). Traduce solo la parte posterior a|. - Los marcadores como
{n}deben quedarse igual en la traducción. - Los plurales tienen una clave distinta para el singular y para el plural.
Corrige una traducción
-
Busca el texto en inglés en los archivos JSON de tu idioma y edita la traducción.
-
Ejecuta la comprobación. Muestra las claves que faltan o sobran y los marcadores que no coinciden:
HERONITE_I18N_MISSING=1 cargo test -p heronite-i18n --test coverage -- --nocapture -
Para verlo en la app, compila Heronite y elige tu idioma en Ajustes → General → Idioma.
-
Abre un pull request.
Añade un idioma nuevo
Copia una de las carpetas a una nueva con el código del idioma (como fr o it) y traduce sus archivos. Un idioma nuevo también necesita unas pocas líneas de código en crates/i18n/src/lib.rs (su nombre y su código). Si no te sientes cómodo con Rust, abre el pull request con la traducción y pide ayuda ahí.