dTranslate – Handbuch
Von der Installation bis zur ersten übersetzten Seite
Dieses Handbuch beschreibt die TYPO3-Erweiterung dTranslate. Die Einrichtung ist in einer Viertelstunde erledigt – danach übersetzen Sie Seiten mit drei Klicks.
1. Installieren
dTranslate wird über Composer installiert. Danach die Erweiterung aktivieren und den Datenbankvergleich ausführen – es entstehen fünf eigene Tabellen, eine zusätzliche Datenbank ist nicht nötig.
2. Sprachmodell hinterlegen
Beide Einstellungsdatensätze liegen auf der Wurzelebene, also unter Web → Liste auf der obersten Ebene des Seitenbaums (Seiten-ID 0).
Legen Sie zuerst eine LLM-Konfiguration an: Anbieter, Modell und API-Schlüssel. Die Adresse der Schnittstelle füllt sich beim Wechsel des Anbieters von selbst.
Für die Übersetzung empfehlen wir ein starkes Chat-Modell – die Qualität des Ergebnisses hängt hier deutlich mehr am Modell als bei einer Suche. Ein Embedding-Modell brauchen Sie nicht.
3. Übersetzungsprofil anlegen
Das Übersetzungsprofil bündelt alles, was für eine Site gelten soll. Es hat fünf Reiter:
- Allgemein. Titel, die Site, für die das Profil gilt, und die LLM-Konfiguration. Lassen Sie die Site leer, wird das Profil zum Standard für jede Site ohne eigenes.
- Sprache. Ausgangssprache, Anrede (förmlich oder locker) und ein freier Stilhinweis – etwa „technisch-sachlich, keine Werbesprache" oder „‚Dreistein' nie übersetzen".
- Glossar. Begriffspaare, an die sich das Modell halten muss.
- Umfang. Welche Tabellen übersetzt werden dürfen, und einzelne Zusatzfelder in der Schreibweise
Tabelle.Spalte– etwa für ein FlexForm-Feld, das sonst nicht erfasst würde. - Zugriff. Das Profil vorübergehend deaktivieren.
4. Eine Seite übersetzen
Öffnen Sie Web → Übersetzung und wählen Sie im Seitenbaum die Seite. Dann:
- Profil wählen. Aus der Site vorbelegt.
- Zielsprachen ankreuzen. Angeboten werden nur die Sprachen der Site, zu der die Seite gehört.
- Datensätze ankreuzen. Die Seite selbst – Titel, Slug und SEO-Felder – gehört immer dazu und lässt sich nicht abwählen. Bei den Inhalten entscheiden Sie einzeln.
- Optionen setzen. „Übersetzte Seite gleich veröffentlichen" (sonst bleibt sie verborgen, bis Sie sie prüfen), „Bereits Übersetztes überspringen" und „Im Hintergrund verarbeiten".
- Ausgewählte übersetzen.
Ohne Hintergrundverarbeitung sehen Sie dem Lauf zu; mit ihr übernimmt der Worker, und Sie können das Fenster schließen.
5. Große Läufe im Hintergrund
Ein Lauf wird in Einheiten zerlegt – eine je Datensatz und Zielsprache – und in eine Warteschlange gelegt. Abgearbeitet wird sie per Cron …
… oder über den TYPO3-Scheduler mit der Aufgabe dTRANSLATE: Übersetzungs-Warteschlange verarbeiten, ebenfalls im Minutentakt. Eines von beiden genügt – richten Sie nicht beides gleichzeitig ein.
Unter Letzte Läufe sehen Sie Zustand, Fortschritt und Verbrauch jedes Laufs; solange er offen ist, können Sie ihn abbrechen.
Einzelne Seiten lassen sich auch direkt von der Kommandozeile übersetzen:
6. Glossar pflegen
Im Reiter Glossar des Profils legen Sie Begriffspaare an: Quellbegriff, Zielbegriff, optional eine Notiz und die Zielsprache. Bleibt die Sprache leer, gilt der Eintrag für alle.
Das Glossar geht bei jeder Anfrage mit – als stabiler Vorspann, den das Modell zwischenspeichern kann. Zwei Dutzend Einträge kosten deshalb kaum etwas.
Gute Kandidaten sind Produkt- und Markennamen, die unverändert bleiben sollen, feststehende Fachbegriffe und alles, wofür Ihr Haus eine bestimmte Übersetzung vorgibt.
7. Erneut übersetzen
Hat sich das Original geändert, wählen Sie die betroffenen Datensätze erneut aus und starten den Lauf noch einmal. Bereits vorhandene Übersetzungen werden dabei aus der Quelle aufgefrischt – ein Lauf löscht niemals etwas.
Soll Vorhandenes unangetastet bleiben, setzen Sie das Häkchen bei Bereits Übersetztes überspringen: Dann entstehen nur die noch fehlenden Übersetzungen.
Wenn etwas klemmt
- „Anthropic hat keinen API-Schlüssel"
Der Lauf hat kein Profil gefunden und ist auf die Erweiterungs-Einstellungen zurückgefallen. Das passiert bei Datensätzen, die außerhalb der Seitenstruktur einer Site liegen – etwa News in einem Systemordner. Wählen Sie beim Start ausdrücklich ein Profil aus.
- Der Seiten-Datensatz wird übersetzt, die Inhalte nicht
Ein Lauf sammelt die Inhalte der gewählten Seite. Unterseiten sind nicht dabei – die übersetzen Sie, indem Sie sie im Seitenbaum einzeln auswählen.
- Ein Feld bleibt in der Ausgangssprache
Automatisch übersetzt werden Fließtextfelder. Einzeilige Eingabefelder bleiben bewusst unangetastet, weil dort meist Namen, Adressen oder Daten stehen, die ein Modell nur verschlimmbessern würde. Brauchen Sie ein bestimmtes Feld doch, tragen Sie es im Profil unter Umfang als
Tabelle.Spaltenach.- Der Scheduler-Task taucht nicht auf
Nach der Installation muss der Cache einmal geleert werden, damit TYPO3 die Registrierung sieht. Ein Neuladen des Backend-Fensters genügt dafür nicht.
- Eine Übersetzung ist unbrauchbar geworden
Führen Sie den Lauf für diesen Datensatz erneut aus, ohne „Bereits Übersetztes überspringen" – die Übersetzung wird dann aus der Quelle neu erzeugt und überschrieben.
Unterstützung bei der Einrichtung
Profil, Glossar und Stilhinweis auf ein bestehendes Projekt abzustimmen, macht am Ergebnis den größten Unterschied. Wenn Sie dabei jemanden an Ihrer Seite haben möchten – oder gleich die ganze Mehrsprachigkeit abgeben wollen: sprechen Sie uns an.