The interface speaks Slovak

969 strings, an instance default and a per-person choice, and no half-done corner:
the admin prose is translated too. Design and reasoning: LLeMbas.wiki/Translations.

KEYED BY THE ENGLISH SENTENCE

A missing entry renders the key, which is the English -- so an untranslated string
looks as it always did, an English instance is byte-for-byte 1.6.0, and a
half-finished catalogue is a half-translated page rather than a page of dotted key
names. The cost is that editing an English sentence orphans its translation
silently, which is what tests/test_translations.py asserts in both directions.

No gettext: .po -> .mo is a build step and this project does not have one.

A JINJA GLOBAL, AND THEREFORE A CONTEXTVAR

`t()` is a global for the reason `brand` already documents -- render() is bypassed
by 25 TemplateResponse calls and 8 get_template().render() calls, the latter being
the SSE frames, which have no Request at all. A global is bound once at import and
the language is per person, so the active language is a ContextVar set per request.

🚨 `get_current_user` had to become `async def`. FastAPI runs a sync dependency in a
threadpool, and anyio copies the context in and discards it on the way out -- so
the language was set where nothing could see it and every page rendered in the
instance's language whatever anybody had chosen, with no error anywhere.

NOT TRANSLATED, ON PURPOSE

Everything a model reads: the 60 prompt fragments, and the dates in harness.py,
schedule/runner.py and schedule/compile.py. Only `i18n.stamp` is localised, and
only where a person reads it -- with the *format* translatable as well as the
words, because "26. septembra 2026" is a different pattern rather than the same one
with different words in it. A process locale is not an option: global, not
thread-safe, two people's pages at once.

A second fragment telling models to answer in the reader's language was written
during this work and removed: `core.style` has said it since long before, and
test_an_empty_override_turns_a_fragment_off caught the duplicate.

THE BULK PASS

1213 sites wrapped by a one-off script that only touched patterns it could not
misread. It got three wrong in a way that mattered -- `t('…')` inside `attr="…"`
where the sentence held an apostrophe, closing the Jinja string and 500ing two
pages whose partials no test renders. tests/test_translations.py now compiles all
110 templates. It also wrapped the product's own name, an SSH key header, a
keystroke hint and an example URL, all taken back out: a string is not
translatable just because it is a string.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
2026-09-26 14:46:33 +00:00
co-authored by Claude Opus 5
parent da0797ccad
commit a16510aba8
104 changed files with 3833 additions and 1788 deletions
+11 -13
View File
@@ -20,7 +20,7 @@
<div class="filter-bar">
<form class="filter-form" method="get" action="/admin/users">
<input class="input" type="search" name="q" value="{{ q }}"
placeholder="Search by name or email…" aria-label="Search users">
placeholder="{{ t('Search by name or email…') }}" aria-label="{{ t('Search users') }}">
<button class="btn" type="submit">{{ icon("search", "icon--sm") }} Filter</button>
{% if q %}<a class="btn btn--ghost" href="/admin/users">Clear</a>{% endif %}
</form>
@@ -32,9 +32,9 @@
<div class="model-row__main">
<span class="model-row__name">
{{ person.name }}
{% if person.role == "admin" %}<span class="badge badge--leaf">admin</span>{% endif %}
{% if person.role == "pending" %}<span class="badge">pending</span>{% endif %}
{% if not person.active %}<span class="badge">disabled</span>{% endif %}
{% if person.role == "admin" %}<span class="badge badge--leaf">{{ t("admin") }}</span>{% endif %}
{% if person.role == "pending" %}<span class="badge">{{ t("pending") }}</span>{% endif %}
{% if not person.active %}<span class="badge">{{ t("disabled") }}</span>{% endif %}
</span>
<span class="model-row__id">{{ person.email }}</span>
</div>
@@ -46,7 +46,7 @@
{% endif %}
{% set spent = usage[person.id] %}
{% if spent.tokens %}
<span class="badge" title="Tokens this month">{{ "{:,}".format(spent.tokens) }}</span>
<span class="badge" title="{{ t('Tokens this month') }}">{{ "{:,}".format(spent.tokens) }}</span>
{% endif %}
</div>
</a>
@@ -74,26 +74,24 @@
{% endif %}
<section class="card" style="margin-top: var(--sp-8)">
<h2 class="card__title">Add an account</h2>
<p class="card__lede">
Without going through registration — useful when sign-up is closed.
</p>
<h2 class="card__title">{{ t("Add an account") }}</h2>
<p class="card__lede">{{ t("Without going through registration — useful when sign-up is closed.") }}</p>
<form method="post" action="/admin/users" class="form-grid">
<div class="field-row">
<div class="field">
<label class="field__label" for="new-name">Name</label>
<label class="field__label" for="new-name">{{ t("Name") }}</label>
<input class="input" id="new-name" name="name" required>
</div>
<div class="field">
<label class="field__label" for="new-email">Email</label>
<label class="field__label" for="new-email">{{ t("Email") }}</label>
<input class="input" id="new-email" name="email" type="email" required>
</div>
<div class="field">
<label class="field__label" for="new-password">Password</label>
<label class="field__label" for="new-password">{{ t("Password") }}</label>
<input class="input" id="new-password" name="password" type="password" required>
</div>
<div class="field">
<label class="field__label" for="new-role">Role</label>
<label class="field__label" for="new-role">{{ t("Role") }}</label>
<select class="input" id="new-role" name="role">
{% for role in roles %}<option value="{{ role }}">{{ role }}</option>{% endfor %}
</select>