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
+8 -13
View File
@@ -7,7 +7,7 @@
{% block admin_content %}
<p class="admin-lede">
Permissions are a <strong>union</strong>: everyone starts with the baseline
Permissions are a <strong>{{ t("union") }}</strong>: everyone starts with the baseline
below, and each group they belong to can add more. A group never takes
something away, so being in a second group can only widen what someone can do —
which is what keeps “why can this person not do X?” answerable without
@@ -19,11 +19,8 @@
{% endif %}
<section class="card">
<h2 class="card__title">Baseline permissions</h2>
<p class="card__lede">
What every signed-in user can do before any group is considered. Turn
something off here and grant it through a group to make it opt-in.
</p>
<h2 class="card__title">{{ t("Baseline permissions") }}</h2>
<p class="card__lede">{{ t("What every signed-in user can do before any group is considered. Turn something off here and grant it through a group to make it opt-in.") }}</p>
<form method="post" action="/admin/permissions/defaults">
{% for section_name, defs in permission_groups.items() %}
@@ -41,7 +38,7 @@
{% endfor %}
</div>
{% endfor %}
<div class="btn-row"><button class="btn btn--primary" type="submit">Save baseline</button></div>
<div class="btn-row"><button class="btn btn--primary" type="submit">{{ t("Save baseline") }}</button></div>
</form>
</section>
@@ -69,22 +66,20 @@
{% if granted[group.id] %}
<span class="badge badge--leaf">+{{ granted[group.id] }} permission{{ '' if granted[group.id] == 1 else 's' }}</span>
{% endif %}
{% if group.limits_json %}<span class="badge">quotas</span>{% endif %}
{% if group.limits_json %}<span class="badge">{{ t("quotas") }}</span>{% endif %}
</div>
</a>
{% else %}
<div class="empty" style="padding: var(--sp-8) 0">
<p class="empty__text">
No groups yet. Everybody gets the baseline above and nothing more.
</p>
<p class="empty__text">{{ t("No groups yet. Everybody gets the baseline above and nothing more.") }}</p>
</div>
{% endfor %}
</div>
<section class="card" style="margin-top: var(--sp-6)">
<form method="post" action="/admin/groups" class="btn-row">
<input class="input" name="name" placeholder="New group name" required
aria-label="New group name">
<input class="input" name="name" placeholder="{{ t('New group name') }}" required
aria-label="{{ t('New group name') }}">
<button class="btn btn--primary" type="submit">
{{ icon("plus", "icon--sm") }} Create group
</button>