Topics

Ein mehrsprachiges Blog mit EmDash – wie man auch mit SSR die Kosten der Übersetzungs-API niedrig hält

  • column

Unser Blog Yururoguu hat vor Kurzem still und leise eine englische Version bekommen. In diesem Beitrag erzähle ich, was dahintersteckt, und vor allem, wie wir das Problem gelöst haben: Lässt sich eine SSR-Website mehrsprachig machen, ohne dass die API-Kosten explodieren?

Voraussetzung: Wir nutzen EmDash als CMS

Dieser Blog läuft auf EmDash, einem auf Astro basierenden CMS. Artikel schreibt man im Admin-Bereich, und das Frontend wird mit Astro per Server-Side Rendering (SSR) ausgeliefert.

Die Bedienung fühlt sich ähnlich an wie bei WordPress, und es heißt sogar, EmDash sei der "geistige Nachfolger von WordPress".

EmDash bietet von Haus aus eine Funktion für "mehrsprachige Inhalte": Artikel, Seiten, Menüs und Taxonomien (Kategorien und Tags) lassen sich pro Locale als eigene Datensätze speichern. Über das Feld translationOf legt man einfach fest, dass dieser englische Artikel eine Übersetzung jenes japanischen Artikels ist, und schon wird er als sprachliche Version desselben Beitrags behandelt.

Wir sind von microCMS zu EmDash + Cloudflare umgezogen

Bei Mehrsprachigkeit ist SSG eigentlich einfach

Wenn man Mehrsprachigkeit mit automatisierter API-Übersetzung umsetzen will, ist das mit SSG (Static Site Generation) grundsätzlich unkompliziert.

  • Die Übersetzungs-API wird nur einmal zur Build-Zeit aufgerufen
  • Das Ergebnis wird als statische Datei zwischengespeichert
  • Danach muss nur noch dieses HTML ausgeliefert werden

Deshalb entstehen API-Kosten nur noch "pro Build", egal wie viele Artikel hinzukommen. Die Häufigkeit lässt sich zudem gut steuern, und das Caching ist unkompliziert.

Aber Yurulog nutzt SSR. Heißt das, bei jeder Anfrage die API aufrufen?

Hier liegt das Problem. Die CMS-Seiten von EmDash werden laut Spezifikation vollständig per SSR gerendert (output: "server"). Statt Seiten beim Build vorzubereiten, werden bei jeder Anfrage die aktuellen Inhalte über die API bzw. Datenbank des CMS abgerufen und gerendert.

Was passiert, wenn man die naive Umsetzung wählt, bei der englische Seiten beim Aufruf direkt von Gemini übersetzt werden?

  • Bei jeder Anfrage fallen Übersetzungs-API-Kosten an
  • Die Latenz steigt (die Antwort des LLM muss abgewartet werden)
  • Derselbe Artikel könnte bei jedem Aufruf leicht unterschiedlich übersetzt werden (keine Reproduzierbarkeit)

Das ist völlig inakzeptabel. Nur weil es sich um SSR handelt, ist es keine gute Idee, bei jeder Anfrage erneut die API aufzurufen. Das würde sowohl die Kosten als auch die UX ruinieren.

Lösung: Die Übersetzung wird vom Zeitpunkt der Anfrage in den Zeitpunkt der Inhaltserstellung verlagert

Die Antwort ist einfach: Die Übersetzung wird nicht zum Zeitpunkt der Anfrage durchgeführt.

Konkret haben wir eine Pipeline wie folgt aufgebaut:

  1. Japanische Artikel im EmDash-Admin-Bereich schreiben und veröffentlichen
  2. Das Übersetzungsskript (scripts/translate.mjs) wird einmalig ausgeführt
    • Abruf des Portable Text (strukturierter Rich-Text) der japanischen Artikel über die EmDash-API
    • Nur die zu übersetzenden Textteile werden extrahiert und an die Gemini API (gemini-3.6-flash) übergeben
    • Bilder und Amazon-Produktkarten sowie ähnliche Blöcke werden nicht übersetzt, sondern unverändert durchgereicht
  3. Das Übersetzungsergebnis wird als neuer englischer Artikel in der EmDash-Datenbank gespeichert
    • Gib mit translationOf die ID des originalen japanischen Artikels an, um ihn als englische Version derselben Artikelgruppe zu verknüpfen
    • Der Beitrag wird als Entwurf gespeichert, sodass er vor der Veröffentlichung geprüft werden kann

Die Übersetzung wird also nicht bei jeder Anfrage neu erzeugt, sondern als eigenständiger Inhalt in einer zweiten Sprache im CMS gespeichert.

Dadurch bleibt die SSR-Anfragenverarbeitung selbst unverändert gegenüber der normalen Artikelanzeige. Über die übliche locale-fähige EmDash-Abfrage (getEmDashEntry(..., { locale: "en" })) wird lediglich der bereits in der Datenbank gespeicherte englische Inhalt geladen. Die Kommunikation mit der Gemini API erfolgt nur einmal, nämlich beim Übersetzen des Artikels, und findet bei der Anzeige niemals statt.

Das ergibt folgende Struktur:

Zeitpunkt der Übersetzung

API-Kosten pro Anfrage

SSG + Übersetzung bei jeder Anfrage

Zur Build-Zeit

Null (statische Dateiauslieferung)

SSR + Übersetzung bei jeder Anfrage (Negativbeispiel)

Bei jeder Anfrage

Artikel × Zugriffszahl – das entsteht jedes Mal 😱

SSR + vorab übersetzte Inhalte in der Datenbank speichern (diese Methode)

Bei der Inhaltserstellung (einmalig)

Null

Die Erkenntnis war: Wenn man die Idee aus SSG, also „beim Build gebündelt zwischenspeichern“, in die SSR-Welt überträgt, ist die Alternative, die Übersetzungen als fertige Inhalte dauerhaft in der Datenbank abzulegen. Auch bei SSR werden die Inhalte selbst nicht fortlaufend dynamisch neu erzeugt. Wenn nur die aufwendige Übersetzung im Voraus erledigt wird, ist die Auslieferung so leichtgewichtig wie bei einer gewöhnlichen CMS-Seite.

Lokal und Produktion haben unterschiedliche Datenbanken – und ich habe mehrfach gedacht: „Wo ist das denn hin?!“

Bei dieser Implementierung war genau das am Ende der mühsamste Teil. EmDash verwendet für die lokale Entwicklungsumgebung und die Produktion jeweils eine eigene Datenbank. Das ist zwar selbstverständlich, doch genau deshalb habe ich mehrfach erlebt, dass eine Funktion, die eben noch funktioniert hat, plötzlich verschwunden war.

Die Symptome sahen meist so aus:

  • Die Navigation im Header ist plötzlich leer
  • Die Kategorienliste im Footer verschwindet
  • Die Sidebar-Widgets auf der Artikelseite verschwinden
  • Die lokal angelegten Menüpunkte und Widgets sind wieder auf dem alten Stand

Da all das genau in dem Moment passierte, in dem alles noch funktioniert hatte, habe ich zunächst vermutet, selbst etwas kaputt gemacht zu haben, und musste mich erst auf die Suche nach der Ursache machen.

Ursache 1: Das Einspielen der Produktionsdatenbank in die lokale Umgebung (pull.sh)

Während der Entwicklung habe ich mehrfach ein Skript ausgeführt, das die Produktionsdatenbank komplett in die lokale Umgebung übernimmt, weil ich die aktuellen Live-Daten auch lokal sehen wollte. Dabei wird die lokale Datenbank vollständig mit dem Stand der Produktion überschrieben (also etwa mit englischen Artikeln, die noch als Entwurf vorlagen, oder einer Menüstruktur vor dem Livegang).

Wollte ich also Funktionen prüfen, die auf der Produktion noch nicht veröffentlicht waren, konnte es passieren, dass meine lokal vorab durchgeführten Änderungen nach dem Pull vorübergehend verschwunden waren, weil die Datenbank wieder dem Produktionsstand entsprach.

Ursache 2: Das Seeding, das bei jeder erneuten Anmeldung im lokalen Admin läuft

Die zweite Ursache lag im Entwicklungs-Bypass-Login für das lokale Admin-Panel: Er lud bei jeder Anmeldung nebenbei die Initialdaten aus seed.json (der Definitionsdatei für Startdaten) erneut ein.

Das ist knifflig, denn

  • Menüpunkte und Widgets werden exakt an den Inhalt der Seed-Datei angepasst und überschrieben (d. h. manuell lokal hinzugefügte Einträge verschwinden)
  • Taxonomien wie Kategorien und Tags werden übersprungen, sofern sie bereits existieren, und bleiben daher erhalten

. Das Verhalten unterscheidet sich also je nach Element. Deshalb verschwanden Menüs und Widgets bei jedem Durchlauf, während Kategorien erhalten blieben, was zunächst unerklärlich wirkte.

Die Lösung

Diese doppelte Überschreibung (durch Pull und durch Seed) lässt sich nur schwer grundsätzlich beseitigen. Als praktikable Lösung

  • wurden die Demo-Dummy-Inhalte (Menüpunkte, Widgets, Kategorien usw.) in seed.json vollständig geleert
  • und die benötigten Menüs und Widgets werden bei jedem erneuten Einrichten der lokalen Umgebung über die API neu angelegt

. Das ist eine Entschärfung statt einer Ursachenbehebung, verhindert aber zumindest, dass unbeabsichtigte Demodaten die Inhalte überschreiben.

Fazit

  • EmDash ist von Haus aus ein mehrsprachiges CMS, das Inhalte für jede Locale separat verwalten kann
  • Bei SSG genügt es, Inhalte zur Build-Zeit zu übersetzen und zwischenzuspeichern. Bei SSR dagegen würde eine Übersetzung bei jedem Aufruf die Kosten explodieren lassen.
  • Die Lösung besteht darin, die Übersetzung nur einmal bei der Erstellung der Inhalte durchzuführen, nicht bei jeder Anfrage, und das Ergebnis als reguläre CMS-Inhalte in der Datenbank zu speichern.
  • Als Übersetzungs-Engine kam die Gemini API zum Einsatz (gemini-3.6-flash).
  • Wer ein CMS mehrsprachig betreibt, sollte jedoch nicht nur den Übersetzungsablauf optimieren. Die Tatsache, dass lokale und Produktivumgebung getrennte Datenbanken haben, schafft selbst neue Fallstricke.
  • Besonders bei Entwicklungen, die vorab Zustände lokal umsetzen, die auf dem Produktivsystem noch nicht existieren, geraten Arbeitsabläufe leicht durch Nebenwirkungen der Synchronisationsmechanismen (Pull, Seeds, Caches usw.) aus dem Takt.

Die wichtigste Erkenntnis aus diesem Projekt: Wenn man vorab klärt, wann die Übersetzung erfolgt und wann Umgebungssynchronisierungen was überschreiben, lässt sich auch mit SSR eine mehrsprachige Website betreiben, ohne von Betriebskosten und Störungen überrascht zu werden.

Wie sieht es bei Ihrer Website mit Mehrsprachigkeit aus?

Über den Autor

Ich entwickle Frontend-Lösungen mit Schwerpunkt auf Markup sowie mit JavaScript, React und Next.js. Es freut mich besonders, wenn Websites, an denen ich mitgearbeitet habe, erfolgreich online gehen! In meiner Freizeit spiele ich gern Gitarre. Katzen und Süßkartoffeln mag ich sehr 🐱🍠

Hirattchi

Frontend-Entwickler / Eintritt 2022

Artikel dieses Teammitglieds ansehen

Verlässliches Team und schnelle Reaktionsfähigkeit sind unsere Stärken

Bei Liberogic werden wir von unseren Kunden hoch geschätzt, da unsere erfahrenen Mitarbeiter Projekte proaktiv vorantreiben.
Wir achten darauf, Projektmanager und Direktoren gezielt einzusetzen, damit das gesamte Projekt reibungslos verläuft. Um unnötige Kostensteigerungen durch Vollzeitbindung zu vermeiden, verteilen wir Ressourcen passgenau. Zudem sind wir für unsere Geschwindigkeit bekannt, vom Verständnis der Anforderungen bis zur Erstellung und Einreichung von Angeboten.

Hinweis: Wir bieten keine SES-typischen Vor-Ort-Einsätze an. Wir bitten um Ihr Verständnis.

Sie können nahezu alle gängigen Tools für Projektmanagement und Chat nutzen, darunter Slack, Teams, Redmine, Backlog, Asana, Jira, Notion, Google Workspace, Zoom, Webex und viele weitere.

Sprechen Sie uns gerne auf Ihre Herausforderungen im Web an.

Fallstudien