Traduce SysWatch

Cuando se acepta una traducción, cada app de SysWatch la recibe por sí sola en un día, o al momento desde Ajustes, Idioma, Comprobar. No hace falta actualizar la app.

Añade tu idioma

1. Haz un fork del repositorio de SysWatch en GitHub (el botón Fork arriba a la derecha de la página de GitHub).

2. En la carpeta translations, copia en.xml y ponle a la copia el código de tu idioma: hi.xml para hindi, pt-BR.xml para portugués de Brasil, ja.xml para japonés. La lista de códigos de idioma los tiene en su primera columna.

3. Traduce el texto que hay entre las etiquetas. No toques nada de lo que hay dentro de los signos < >.

   <!-- English -->
   <string name="pair_scan">Scan the code on your PC</string>
   
   <!-- Your file -->
   <string name="pair_scan">अपने पीसी पर कोड स्कैन करें</string>

4. Abre una pull request. Se lanza una comprobación automática que te dice, con palabras claras, si hay algo que corregir. Cuando sale en verde, la traducción se revisa y se acepta.

No tienes que terminarlo de una vez. Los textos que dejes sin traducir salen en inglés, y la app indica cuánto está completo cada idioma. Pero no dejes ningún texto vacío: en ese caso, borra la línea entera.

Corrige una traducción existente

Edita el archivo de ese idioma (de.xml, fr.xml, es.xml, ru.xml), cambia el texto y abre una pull request. Explica en una frase por qué la nueva redacción es mejor.

Las reglas, las cinco

1. Conserva los marcadores

Cosas como %1$s y %2$d son huecos que rellena la app (un nombre, un número). Todos los del inglés tienen que estar en tu texto. Puedes moverlos adonde lo pida tu gramática: por eso van numerados.

<string name="settings_paired_with">Paired with code %1$s</string>
<string name="settings_paired_with">Gekoppelt mit Code %1$s</string>

Un signo de porcentaje real junto a los marcadores se escribe dos veces: %1$d%% se ve como 47%.

2. Pon una barra invertida delante del apóstrofo

l\'application, no l'application. Escribe & para & y < para <.

3. No traduzcas nombres ni unidades

SysWatch, DevLune, CPU, GPU, RAM, Wi-Fi, Tailscale, Google Play, Windows, Android y unidades como MB, GB, GHz, °C se quedan como están. Las esferas de reposo artísticas (Horizon, Blocks, Bauhaus, Ink, Weave, Bloom, Type, Pixel) también conservan su nombre.

4. Los plurales siguen a tu idioma

El inglés tiene dos formas, one y other. Si tu idioma tiene más (ruso, polaco, árabe…), añade las formas que necesite:

<plurals name="settings_import_done">
    <item quantity="one">Импортировано %1$d правило.</item>
    <item quantity="few">Импортировано %1$d правила.</item>
    <item quantity="many">Импортировано %1$d правил.</item>
    <item quantity="other">Импортировано %1$d правила.</item>
</plurals>

5. Breve y sencillo

Este texto va en botones y tarjetas pequeñas, en un móvil. Usa la palabra que la gente dice de verdad, no la más formal. Sin rayas largas: usa una coma, dos puntos o un punto.

Las líneas que empiezan por <!-- en en.xml son notas para ti: qué contiene un hueco o dónde aparece el texto. No hace falta que las conserves en tu archivo.

Hay un texto especial: language_name es el nombre de tu idioma, escrito en tu idioma (Deutsch, Español, Русский, हिन्दी). Es lo que la gente ve en la lista de idiomas de la app.

Comprueba tu archivo antes de enviarlo

Este paso es opcional. Si tienes Python, ejecuta esto desde la carpeta del repositorio:

python scripts/translations.py check translations

Muestra ok o exactamente los textos que hay que corregir. La misma comprobación se ejecuta en tu pull request.

Qué pasa cuando se acepta

• languages.json, en la carpeta translations, se actualiza automáticamente. Es la lista que lee la app.
• Las apps la consultan una vez al día. Un móvil que usa tu idioma descarga el archivo nuevo, vuelve a comprobar cada texto en el propio dispositivo (un texto roto se omite y se muestra en inglés, así que un error nunca puede romper la app), lo guarda y lo muestra.
• Los idiomas que no vienen incluidos en la app aparecen en la lista de idiomas con una marca de descarga. Los más usados se incluyen en la siguiente versión de la app.

Preguntas

Abre una incidencia en GitHub o pregunta en Discord. Gracias por ayudar a que la gente use SysWatch en su propio idioma.