Skip to content

Translations

S.O.K is translated into English, French, German, Spanish, Italian, Portuguese, Russian and Polish. Every text shown to the user goes through tr(), or t() in the web interface of S.O.K Server, which reads the same files.

from sok.ui.i18n import tr
label = tr("drive_monitors", "Drive Monitors")

The first argument is the key, the second the English text used when the key is missing from the current language file. Always give it, so the interface never shows a raw key.

The language also sets the words used in folder names (Season, Saison, Staffel…), so check the organize preview after adding such a key.

In the web interface (web/src), the function is t(), with the same arguments and the values of the {placeholders}:

import { t } from "../lib/i18n.svelte";
t(
"web_error_too_many_attempts",
"Too many attempts. Try again in {seconds} s.",
{
seconds: 30,
},
);

Its new keys start with web_.

The translations are JSON files in src/sok/resources/i18n/, one per language (en.json, fr.json, de.json, es.json, it.json, pt.json, ru.json, pl.json). Add the new key to every file:

src/sok/resources/i18n/fr.json
{
"drive_monitors": "Moniteurs de disques"
}

Then run the check:

Terminal window
uv run python tools/verify_i18n.py

It finds every tr("key", …) call in src/, and every t("key", …) call and page key of web/src, and reports, for each language, the keys missing from the file and the keys no longer used. It fails when a key is missing, and the CI runs it on every pull request.

Built with Kiln