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
+24 -29
View File
@@ -22,93 +22,88 @@
<div class="card__header">
<h2 class="card__title">
{{ suggestion.name }}
{% if not suggestion.enabled %}<span class="badge">hidden</span>{% endif %}
{% if not suggestion.enabled %}<span class="badge">{{ t("hidden") }}</span>{% endif %}
{% if loop.index > max_shown and suggestion.enabled %}
<span class="badge badge--warning" title="Only the first {{ max_shown }} are shown">
below the cut
</span>
<span class="badge badge--warning" title="Only the first {{ max_shown }} are shown">{{ t("below the cut") }}</span>
{% endif %}
</h2>
<button class="btn btn--sm btn--danger" type="submit"
formaction="/admin/suggestions/{{ suggestion.id }}/delete"
data-confirm-button="Delete the suggestion “{{ suggestion.name }}”?"
data-confirm-title="Delete suggestion"
aria-label="Delete suggestion" title="Delete suggestion">
data-confirm-title="{{ t('Delete suggestion') }}"
aria-label="{{ t('Delete suggestion') }}" title="{{ t('Delete suggestion') }}">
{{ icon("trash", "icon--sm") }}
</button>
</div>
<div class="grid grid--2">
<div class="field">
<label class="field__label" for="name-{{ suggestion.id }}">Name</label>
<label class="field__label" for="name-{{ suggestion.id }}">{{ t("Name") }}</label>
<input class="input" id="name-{{ suggestion.id }}" name="name"
value="{{ suggestion.name }}" maxlength="120">
<p class="field__hint">The heading on the card.</p>
<p class="field__hint">{{ t("The heading on the card.") }}</p>
</div>
<div class="field">
<label class="field__label" for="position-{{ suggestion.id }}">Position</label>
<label class="field__label" for="position-{{ suggestion.id }}">{{ t("Position") }}</label>
<input class="input" id="position-{{ suggestion.id }}" name="position" type="number"
min="1" value="{{ suggestion.position + 1 }}">
<p class="field__hint">Order on the screen, lowest first.</p>
<p class="field__hint">{{ t("Order on the screen, lowest first.") }}</p>
</div>
</div>
<div class="field">
<label class="field__label" for="description-{{ suggestion.id }}">Description</label>
<label class="field__label" for="description-{{ suggestion.id }}">{{ t("Description") }}</label>
<input class="input" id="description-{{ suggestion.id }}" name="description"
value="{{ suggestion.description }}" maxlength="300">
<p class="field__hint">One line under the name, saying what it is for.</p>
<p class="field__hint">{{ t("One line under the name, saying what it is for.") }}</p>
</div>
<div class="field">
<label class="field__label" for="prompt-{{ suggestion.id }}">Prompt</label>
<label class="field__label" for="prompt-{{ suggestion.id }}">{{ t("Prompt") }}</label>
<textarea class="textarea" id="prompt-{{ suggestion.id }}" name="prompt"
rows="4">{{ suggestion.prompt }}</textarea>
<p class="field__hint">
Sent as the first message. Nothing is added to it, so a prompt that needs
material should ask for it.
</p>
<p class="field__hint">{{ t("Sent as the first message. Nothing is added to it, so a prompt that needs material should ask for it.") }}</p>
</div>
<div class="field">
<label class="checkbox">
<input type="checkbox" name="enabled" value="true" {{ 'checked' if suggestion.enabled }}>
<span>Show this one</span>
<span>{{ t("Show this one") }}</span>
</label>
</div>
<div class="card__footer">
<button class="btn btn--primary btn--sm" type="submit">Save</button>
<button class="btn btn--primary btn--sm" type="submit">{{ t("Save") }}</button>
</div>
</form>
{% else %}
<div class="empty">
{{ icon("sparkle", "empty__mark") }}
<h2 class="empty__title">No suggestions</h2>
<p class="empty__text">The new-chat screen shows its empty state instead.</p>
<h2 class="empty__title">{{ t("No suggestions") }}</h2>
<p class="empty__text">{{ t("The new-chat screen shows its empty state instead.") }}</p>
</div>
{% endfor %}
{% if not at_limit %}
<form class="card" method="post" action="/admin/suggestions">
<h2 class="card__title">Add a suggestion</h2>
<h2 class="card__title">{{ t("Add a suggestion") }}</h2>
<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" maxlength="120"
placeholder="Summarise a document" required>
placeholder="{{ t('Summarise a document') }}" required>
</div>
<div class="field">
<label class="field__label" for="new-description">Description</label>
<label class="field__label" for="new-description">{{ t("Description") }}</label>
<input class="input" id="new-description" name="description" maxlength="300"
placeholder="What it is for, in one line.">
placeholder="{{ t('What it is for, in one line.') }}">
</div>
<div class="field">
<label class="field__label" for="new-prompt">Prompt</label>
<label class="field__label" for="new-prompt">{{ t("Prompt") }}</label>
<textarea class="textarea" id="new-prompt" name="prompt" rows="4"
placeholder="Sent as the first message when the card is clicked."></textarea>
placeholder="{{ t('Sent as the first message when the card is clicked.') }}"></textarea>
</div>
<div class="card__footer">
<button class="btn btn--primary" type="submit">Add</button>
<button class="btn btn--primary" type="submit">{{ t("Add") }}</button>
</div>
</form>
{% else %}