Benutzerhandbuch¶

Sprachwähler¶

nt-lingua fügt dem Frontend einen Sprachwähler hinzu. Je nach Sitepackage-Konfiguration erscheint er:

In der Navbar — ein Dropdown mit nativen Sprachen, DOM-Sprachen und Optionen für Einfache/Leichte Sprache
Als schwebender Widget — ein Globus-Button (rechts unten), der ein Panel öffnet

Echtzeit-Übersetzung (DOM)¶

Auf eine Sprache im Sprachwähler klicken. Die Extension:

Sammelt alle übersetzbaren Textknoten der aktuellen Seite
Sendet sie in einer einzigen Batch-Anfrage an den Server
Ersetzt den Text direkt im DOM, ohne die Seite neu zu laden

Während der Übersetzung erscheint ein Overlay-Spinner. Nach Abschluss wird ein Disclaimer-Banner ("Automatisch übersetzt — ohne Gewähr") unterhalb des Inhaltsbereichs eingeblendet.

Wiederkehrende Besuche: Die gewählte Sprache wird im localStorage gespeichert und beim nächsten Seitenaufruf automatisch wiederhergestellt.

Zurücksetzen: Auf die Ausgangssprache klicken (z. B. "Deutsch"), um alle Änderungen rückgängig zu machen.

Was übersetzt wird¶

Alle sichtbaren Textknoten
title-, alt-, placeholder- und aria-label-Attribute

Was ausgeschlossen wird¶

Elemente mit translate="no", data-nt-notranslate oder class="notranslate"
Tags: <script>, <style>, <code>, <pre>, <noscript>
Der Sprachwähler selbst (data-nt-notranslate)
Als ignore konfigurierte Glossar-Begriffe

Einfache / Leichte Sprache¶

Im Sprachwähler auf "Einfache Sprache" oder "Leichte Sprache" klicken. Die KI formuliert den Seiteninhalt um, wobei alle Fakten, Zahlen und Namen unverändert bleiben.

Disclaimer für Leichte Sprache

Die Ausgabe in Leichter Sprache ist ein KI-Entwurf und wurde nicht von einem menschlichen Experten geprüft oder nach DIN SPEC 33429 zertifiziert. Beim Anbieten von Leichter Sprache muss der Disclaimer immer angezeigt werden.

Server-seitiger Fallback: ?ntlingua=einfache an die URL anhängen, um Einfache Sprache server-seitig zu aktivieren (setzt ein Cookie). Funktioniert ohne JavaScript und ermöglicht Suchmaschinen und Hilfstechnologien den Zugriff auf die vereinfachte Version.

Native Sprachen (SEO)¶

Bestimmte Sprachen erscheinen im Sprachwähler als reguläre Links (z. B. /en/). Diese öffnen eine vollständig server-gerenderte TYPO3-Übersetzung — indexierbar, mit korrekten hreflang-Attributen.

Cache¶

Alle Übersetzungen werden in tx_ntlingua_text_cache gespeichert. Wiederholte Anfragen für identische Inhalte kosten keine weiteren Token oder API-Aufrufe. Der Cache wird automatisch invalidiert, wenn der Quellinhalt (header, bodytext) im Backend gespeichert wird.