Files
LLeMbas/src/lembas/web/templates/library/knowledge.html
T
HomerandClaude Opus 5 a16510aba8 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>
2026-09-26 14:46:33 +00:00

66 lines
2.8 KiB
HTML

{% extends "library/_layout.html" %}
{% from "_macros.html" import icon %}
{% set section = "knowledge" %}
{% block title %}Knowledge - {{ brand.name }}{% endblock %}
{% block heading %}Knowledge{% endblock %}
{% block library_content %}
<p class="admin-lede">{{ t("Knowledge bases are collections of documents, images and saved web pages. Keep them separate — one per subject, project or client — and a chat can be pointed at just the ones it should draw on. Sharing happens here too: share a base and everything in it comes with it.") }}</p>
{# Links rather than a form, so a filtered view is a URL you can keep. #}
<div class="filter-tabs" style="margin-bottom: var(--sp-4)">
<a class="filter-tab {{ 'is-active' if not shared }}" href="/library/knowledge">All bases</a>
<a class="filter-tab {{ 'is-active' if shared }}"
href="/library/knowledge?shared=1">Shared with me</a>
</div>
{% if error %}
<div class="alert alert--error">{{ icon("warning", "alert__icon") }} <span>{{ error }}</span></div>
{% endif %}
{% if bases %}
<ul class="model-list">
{% for base in bases %}
<li class="model-list__item">
<div style="min-width: 0">
<a href="/library/knowledge/{{ base.id }}"><strong>{{ base.name }}</strong></a>
<div class="text-xs faint">
{{ counts.get(base.id, 0) }} document{{ '' if counts.get(base.id, 0) == 1 else 's' }}
{%- if base.description %} · {{ base.description }}{% endif %}
</div>
</div>
<div class="btn-row">
{% if base.owner_id != user.id %}<span class="badge">{{ t("shared with you") }}</span>{% endif %}
</div>
</li>
{% endfor %}
</ul>
{% else %}
<div class="empty">
{{ icon("archive", "empty__mark") }}
<h2 class="empty__title">{{ t("No knowledge bases yet") }}</h2>
<p class="empty__text">{{ t("Make one below, then put documents in it. A chat with no base attached searches everything you have; a chat pointed at one searches only that.") }}</p>
</div>
{% endif %}
<section class="card" style="margin-top: var(--sp-6)">
<h2 class="card__title">{{ t("New knowledge base") }}</h2>
<form method="post" action="/api/library/bases">
<div class="grid grid--2">
<div class="field">
<label class="field__label" for="base-name">{{ t("Name") }}</label>
<input class="input" id="base-name" name="name" required maxlength="200"
placeholder="{{ t('Contracts') }}">
</div>
<div class="field">
<label class="field__label" for="base-description">{{ t("Description") }}</label>
<input class="input" id="base-description" name="description" maxlength="2000"
placeholder="{{ t('What belongs in here.') }}">
</div>
</div>
<button class="btn btn--primary" type="submit">{{ icon("plus", "icon--sm") }} Create</button>
</form>
</section>
{% endblock %}