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
+19 -19
View File
@@ -29,76 +29,76 @@
{% include "partials/_sidebar_close.html" %}
</header>
<nav class="sidebar__scroll" aria-label="Administration">
<nav class="sidebar__scroll" aria-label="{{ t('Administration') }}">
<div class="nav-group">
<div class="nav-group__label">Administration</div>
<a class="nav-item {{ 'is-active' if section == 'general' }}" href="/admin/general">
{{ icon("gear", "icon--sm") }}
<span class="nav-item__label">General</span>
<span class="nav-item__label">{{ t("General") }}</span>
</a>
<a class="nav-item {{ 'is-active' if section == 'customization' }}"
href="/admin/customization">
{{ icon("sun", "icon--sm") }}
<span class="nav-item__label">Customization</span>
<span class="nav-item__label">{{ t("Customization") }}</span>
</a>
<a class="nav-item {{ 'is-active' if section == 'connections' }}"
href="/admin/connections">
{{ icon("server", "icon--sm") }}
<span class="nav-item__label">Connections</span>
<span class="nav-item__label">{{ t("Connections") }}</span>
</a>
<a class="nav-item {{ 'is-active' if section == 'models' }}" href="/admin/models">
{{ icon("sliders", "icon--sm") }}
<span class="nav-item__label">Models</span>
<span class="nav-item__label">{{ t("Models") }}</span>
</a>
<a class="nav-item {{ 'is-active' if section == 'audio' }}" href="/admin/audio">
{{ icon("speaker", "icon--sm") }}
<span class="nav-item__label">Audio</span>
<span class="nav-item__label">{{ t("Audio") }}</span>
</a>
<a class="nav-item {{ 'is-active' if section == 'search' }}" href="/admin/search">
{{ icon("globe", "icon--sm") }}
<span class="nav-item__label">Web search</span>
<span class="nav-item__label">{{ t("Web search") }}</span>
</a>
<a class="nav-item {{ 'is-active' if section == 'images' }}" href="/admin/images">
{{ icon("image", "icon--sm") }}
<span class="nav-item__label">Image generation</span>
<span class="nav-item__label">{{ t("Image generation") }}</span>
</a>
<a class="nav-item {{ 'is-active' if section == 'extraction' }}"
href="/admin/extraction">
{{ icon("file-text", "icon--sm") }}
<span class="nav-item__label">Extraction</span>
<span class="nav-item__label">{{ t("Extraction") }}</span>
</a>
<a class="nav-item {{ 'is-active' if section == 'tools' }}" href="/admin/tools">
{{ icon("link", "icon--sm") }}
<span class="nav-item__label">Tools</span>
<span class="nav-item__label">{{ t("Tools") }}</span>
</a>
<a class="nav-item {{ 'is-active' if section == 'agents' }}" href="/admin/agents">
{{ icon("sparkle", "icon--sm") }}
<span class="nav-item__label">Agents</span>
<span class="nav-item__label">{{ t("Agents") }}</span>
</a>
<a class="nav-item {{ 'is-active' if section == 'schedules' }}" href="/admin/schedules">
{{ icon("clock", "icon--sm") }}
<span class="nav-item__label">Scheduling</span>
<span class="nav-item__label">{{ t("Scheduling") }}</span>
</a>
<a class="nav-item {{ 'is-active' if section == 'mcp' }}" href="/admin/mcp">
{{ icon("server", "icon--sm") }}
<span class="nav-item__label">MCP servers</span>
<span class="nav-item__label">{{ t("MCP servers") }}</span>
</a>
<a class="nav-item {{ 'is-active' if section == 'prompts' }}" href="/admin/prompts">
{{ icon("sparkle", "icon--sm") }}
<span class="nav-item__label">Prompts</span>
<span class="nav-item__label">{{ t("Prompts") }}</span>
</a>
<a class="nav-item {{ 'is-active' if section == 'suggestions' }}"
href="/admin/suggestions">
{{ icon("star", "icon--sm") }}
<span class="nav-item__label">Suggestions</span>
<span class="nav-item__label">{{ t("Suggestions") }}</span>
</a>
<a class="nav-item {{ 'is-active' if section == 'users' }}" href="/admin/users">
{{ icon("user", "icon--sm") }}
<span class="nav-item__label">Users</span>
<span class="nav-item__label">{{ t("Users") }}</span>
</a>
<a class="nav-item {{ 'is-active' if section == 'updates' }}" href="/admin/updates">
{{ icon("refresh", "icon--sm") }}
<span class="nav-item__label">Updates</span>
<span class="nav-item__label">{{ t("Updates") }}</span>
</a>
<a class="nav-item {{ 'is-active' if section == 'groups' }}" href="/admin/groups">
{{ icon("users", "icon--sm") }}
@@ -111,7 +111,7 @@
<div class="sidebar__footer">
<a class="nav-item" href="/chat">
{{ icon("chat", "icon--sm") }}
<span class="nav-item__label">Back to chats</span>
<span class="nav-item__label">{{ t("Back to chats") }}</span>
</a>
</div>
</aside>
@@ -122,7 +122,7 @@
<header class="topbar">
{% include "partials/_sidebar_toggle.html" %}
<h1 class="topbar__title">{% block heading %}Administration{% endblock %}</h1>
<button class="btn btn--icon" type="button" data-theme-toggle aria-label="Switch theme">
<button class="btn btn--icon" type="button" data-theme-toggle aria-label="{{ t('Switch theme') }}">
<span class="theme-icon theme-icon--dark">{{ icon("moon") }}</span>
<span class="theme-icon theme-icon--light">{{ icon("sun") }}</span>
</button>