Mit der Supertext-Extension übersetzt TYPO3 Seiten in dem Schritt, den Sie bereits kennen: im Localize-Assistenten. Diese Anleitung führt Sie von der Installation bis zur übersetzten Seite auf Schweizer Hochdeutsch.

Sie brauchen: TYPO3 13.4 oder 14.3 LTS, mit Composer installiert, ein Supertext-Konto und etwa zehn Minuten.

Schweizer Hochdeutsch oder Mundart?

Websites in der Deutschschweiz werden auf Schweizer Hochdeutsch geschrieben: Standarddeutsch mit „ss“ statt „ß“ sowie mit Schweizer Wörtern und Schreibweisen. In Supertext ist das de-CH, und das verwendet diese Anleitung. Für einen bewusst lokalen Ton schreibt Supertext auch Schweizerdeutsch (Mundart), Zürich- oder Berndeutsch (gsw-u-sd-chzh, gsw-u-sd-chbe) – etwas, das die meisten maschinellen Übersetzungen nicht können.

1. API-Schlüssel holen

Melden Sie sich bei Supertext an oder erstellen Sie ein Konto und generieren Sie dann unter Integrations → API einen Schlüssel. Dafür brauchen Sie in Ihrem Supertext-Konto die Rolle Admin; andernfalls wenden Sie sich an den Admin Ihres Kontos.

2. Extension installieren

Die Extension ist noch nicht auf Packagist verfügbar. Fügen Sie deshalb ihr GitHub-Repository hinzu und installieren Sie sie:

composer config repositories.supertext-typo3 vcs https://github.com/Supertext/Typo3-Supertext-Translation
composer require supertext/typo3-translation:dev-main
vendor/bin/typo3 extension:setup -e supertext_translation
vendor/bin/typo3 cache:flush

3. Schlüssel eingeben

Öffnen Sie im Backend System → Settings → Extension Configuration → supertext_translation (TYPO3 13: Admin Tools → Settings) und fügen Sie den Schlüssel unter Supertext API key ein. Auf einem Server können Sie stattdessen die Umgebungsvariable SUPERTEXT_API_KEY setzen; so bleibt der Schlüssel ausserhalb der Datenbank. Der Block Status oben bestätigt, dass die Verbindung funktioniert.

4. Schweizer Hochdeutsch als Website-Sprache hinzufügen

Öffnen Sie Sites → Setup, bearbeiten Sie Ihre Site und fügen Sie im Tab Languages eine Sprache mit dem Locale de_CH.UTF-8 hinzu (zum Beispiel Deutsch (Schweiz)). In deren Palette Supertext:

  • Supertext language: Default (de-CH) ist für dieses Locale vorausgewählt. Behalten Sie das bei.
  • Supertext tone: Formal für „Sie“ oder informell für „du“.

Speichern Sie. Die Standardsprache der Site ist die Ausgangssprache.

5. Seite übersetzen

  1. Öffnen Sie Content → Layout und wählen Sie die Seite im Seitenbaum aus.
  2. Wählen Sie im Sprachmenü oben rechts unter Create new translation den Eintrag Deutsch (Schweiz).
  3. Lassen Sie im Localize-Assistenten alle Inhaltselemente ausgewählt, wählen Sie Translate (verbundener Modus) und klicken Sie auf Localize.

Nach wenigen Sekunden bestätigt eine grüne Meldung, was Supertext übersetzt hat, zum Beispiel "Supertext translated 30 field(s) in 14 record(s) into Deutsch (Schweiz) (de-CH)." Seitentitel, SEO-Texte, Überschriften, Rich Text, Bildunterschriften, Alt-Texte und Tabellen werden übersetzt; die URL wird aus dem übersetzten Titel neu erstellt, zum Beispiel wird /about-us zu /de/ueber-uns.

6. Prüfen und veröffentlichen

Neue Übersetzungen sind, wie in TYPO3 üblich, verborgen. Lesen Sie die Seite durch, passen Sie an, was Sie anders formulieren würden, und blenden Sie die Seitenübersetzung und ihre Inhaltselemente ein. Fertig.

Nächste Schritte

  • Später hinzugefügte Inhalte: Übersetzen Sie sie unter Display mode → Language Comparison mit der Schaltfläche Translate in der deutschen Spalte.
  • Viele Seiten auf einmal oder eigene Übersetzerinnen und Übersetzer: Siehe die TYPO3-Integrationsseite mit ihrem XLIFF- und HTML-Export.
  • Französisch und Italienisch für die Schweiz funktionieren genauso, mit fr-CH und it-CH.