Eine Astro-Website übersetzen: i18n-Routing und SEO

Crawlbare Sprach-URLs in Astro umsetzen – mit i18n-Routing, Content Collections, lokalisierten SEO-Tags, Sitemaps mit hreflang-Unterstützung und redaktionellen MDX-Workflows.

Grant DaviesAktualisiert

Eine Astro-Website übersetzen: Astro-Island-Komponenten schweben in einem statischen Seitenrahmen mit Sprachordner-Badges auf einem

Astros Static-first-Architektur eignet sich hervorragend für mehrsprachige Marketing-Websites – wenn Teams i18n-Routing, Content Collections und SEO-Auszeichnungen als vollwertige Entwicklungsaufgaben behandeln. Astro-Entwickler setzen oft sauber strukturierte Sprachordner um und stellen dann fest, dass hreflang fehlt, übergreifende Layout-Elemente auf Englisch bleiben oder hybride Islands unübersetzte Texte clientseitig rendern.

Dieser Leitfaden erklärt, wie Sie eine Astro-Website übersetzen: mit crawlbarem HTML je Sprachversion, strukturierten Content Collections, lokalisierten Layouts und SEO-Tags, Sitemaps mit hreflang-Unterstützung, Hinweisen zum hybriden Rendering und redaktionellen Workflows für Markdown und MDX. Alles basiert auf Googles Anforderungen an mehrsprachige Websites. Ohne erfundene Rankingfaktoren.

Fragen, die dieser Leitfaden beantwortet

  • Wie unterstützt Astros i18n-Routing crawlbare Sprachversionen?
  • Wie sollten Content Collections pro Sprache organisiert werden?
  • Wie lokalisiert man übergreifende Layout-Elemente und SEO-Tags in Astro?
  • Wie sollte hreflang für die statische Ausgabe von Astro generiert werden?
  • Wann ist hybrides Rendering für mehrsprachige Astro-Websites nötig?
  • Wie sollte der Übersetzungsworkflow in die Arbeit mit Markdown-/MDX-Inhalten integriert werden?
  • Welche Fehler treten bei mehrsprachigen Astro-Websites häufig auf?
  • Wann sollten Astro-Teams eine Übersetzungsplattform einsetzen?

Kurzantwort: Statisches HTML je Sprachversion ist Astros SEO-Vorteil

Kurzantwort: Nutzen Sie Astros i18n-Routing, um separate Sprach-URLs mit vollständig lokalisiertem HTML vorzurendern – einschließlich Navigation, Metadaten und Hauptinhalt. Ergänzen Sie anschließend wechselseitige hreflang-Verweise zwischen den Sprachversionen.

Vorgerendertes HTML pro Sprach-URL passt gut zu Googles Präferenz für crawlbare Sprachversionen mit separaten URLs. Astro kann beim Build statische Dateien pro Sprache erzeugen. So erhalten Crawler dasselbe sprachspezifische Dokument wie die Nutzer, ohne auf clientseitige Sprachumschalter angewiesen zu sein.

Google empfiehlt separate, crawlbare URLs für jede Sprachversion, statt sich allein auf Cookies oder die Browsersprache zu verlassen. Astros astro:i18n-Routing (oder vergleichbare Muster mit Sprachpräfixen) unterstützt dieses Modell, wenn Sie pro Sprache einen Ausgabepfad generieren.

Astro-i18n-Routing und URL-Struktur

Konfigurieren Sie Astro mit explizit festgelegten Sprachen und einer Standardsprache. Gängige URL-Muster sind:

  • Standardsprache mit Präfix (/en/about, /fr/about) – eindeutig und leicht auszuzeichnen.
  • Standardsprache ohne Präfix (/about für Englisch, /fr/about für Französisch) – übersichtlichere URLs für den Hauptmarkt; dokumentieren Sie die Zuordnung mit hreflang.

Legen Sie in astro.config.mjs die Werte für i18n.locales, i18n.defaultLocale und i18n.routing passend zu Ihrer Sprachmatrix fest. Jede Routendatei sollte die aktive Sprache über Astros APIs erhalten, damit die Templates die richtige Sprache ausgeben.

Google bestimmt die Seitensprache hauptsächlich anhand des sichtbaren Inhalts. Inhalte und Navigation einer Sprachversion sollten daher überwiegend in derselben Sprache gehalten sein. Binden Sie Navigationskomponenten an sprachabhängige Übersetzungswörterbücher an, damit Kopf- und Fußzeile zur Sprache des Seiteninhalts passen.

Vermeiden Sie automatische Weiterleitungen auf Basis einer vermuteten Sprache oder eines vermuteten Standorts. Google rät von automatischen Weiterleitungen ab und empfiehlt eine für Nutzer sichtbare Sprachauswahl, die auf die alternativen URLs verweist.

Strategische Hintergründe zur Ausrichtung auf Sprachen oder Länder finden Sie im Beitrag Internationale SEO im Vergleich zu mehrsprachiger SEO.

Content Collections pro Sprache

Astro Content Collections bilden die Grundlage für Blogs, Dokumentationen und Landingpage-Texte. Strukturieren Sie mehrsprachige Inhalte gezielt:

  • Separate Collection-Verzeichnisse pro Sprache (src/content/blog/en/, src/content/blog/fr/) mit gemeinsamen Schemas.
  • Sprachfeld im Frontmatter, um bei geringem Inhaltsumfang eine einzige Collection zu filtern.
  • Per Symlink verknüpfte oder generierte Indizes, die nur die in der jeweiligen Sprache verfügbaren Einträge auflisten – veröffentlichen Sie keine leeren Platzhalter für Sprachversionen.

Jedes lokalisierte Dokument sollte auf zur Sprache passende Assets und interne Links verweisen. Ein französischer Beitrag, der auf eine nur auf Englisch verfügbare Dokumentation verlinkt, beeinträchtigt das Vertrauen der Nutzer und die sprachliche Konsistenz.

Wenn gleichwertige Inhalte in einer Sprache fehlen, weisen Sie keine vermeintlichen Alternativen per hreflang aus. Übersetzen Sie entweder die entsprechende Seite oder lassen Sie die Verknüpfung weg, bis die Übersetzung fertig ist.

Layouts, SEO und Open Graph lokalisieren

Bündeln Sie übergreifende Layout-Elemente in sprachabhängigen Komponenten:

  • BaseLayout.astro liest Astro.currentLocale (oder Ihre i18n-Hilfsfunktion) aus und wählt Texte aus JSON- oder TS-Wörterbüchern aus.
  • <title> und Meta-Beschreibung stammen aus dem Frontmatter oder den CMS-Feldern der jeweiligen Seite – nicht aus fest im Code hinterlegten englischen Texten.
  • Open-Graph- und Twitter-Tags übernehmen den lokalisierten Titel und die lokalisierte Beschreibung.
  • Das html lang-Attribut entspricht der aktiven Sprache (für Barrierefreiheit und Klarheit; Google verwendet zur Spracherkennung weiterhin den sichtbaren Inhalt).

Lokalisierte SEO-Titel und Meta-Beschreibungen sollten für jede Sprach-URL individuell sein. Eine oberflächliche Lokalisierung, die nur wiederkehrende Elemente übersetzt – etwa die Navigation, während Artikeltexte auf Englisch bleiben –, führt zu mangelhaften Sprachversionen.

Hreflang und Sitemap-Generierung

Auch Astro-Websites sollten wechselseitige hreflang-Verweise zwischen Sprach-URLs ausgeben (im HTML, in HTTP-Headern oder in Sitemaps), sofern alternative Versionen vorhanden sind. Generieren Sie beim Build eine Sprachmatrix aus Ihrem Inhaltsgraphen:

  1. Listen Sie für jede inhaltlich eigenständige Seite alle veröffentlichten Sprach-URLs auf.
  2. Geben Sie in jeder statischen HTML-Datei <link rel="alternate" hreflang="..." href="..." /> in <head> aus, oder
  3. Generieren Sie eine XML-Sitemap mit xhtml:link-Alternativen für jeden URL-Eintrag.

XML-Sitemaps erleichtern das Auffinden von Sprachversionen und können bei dieser Implementierungsmethode xhtml:link-hreflang-Annotationen enthalten.

Jede Sprach-URL sollte eine eindeutige Canonical-URL in derselben Sprache haben. Googles Empfehlungen zu Canonicals gelten für statische Websites genauso wie für dynamische.

Integrieren Sie die Sitemap-Generierung in die CI-Pipeline – @astrojs/sitemap in Kombination mit eigenen Serialisierungs-Hooks eignet sich dafür gut. So bleibt hreflang bei Inhaltsänderungen synchron.

Unter Grundlagen der mehrsprachigen SEO erfahren Sie, wie Redaktionsteams Annotationen in Abstimmung mit der technischen Umsetzung verwalten.

Hybride Islands und Besonderheiten dynamischer Inhalte

Mit Astros Islands-Architektur lassen sich React-, Vue- oder Svelte-Komponenten gezielt hydrieren. Bei mehrsprachigen Websites ist Folgendes zu beachten:

  • Rein clientseitige Widgets zeigen möglicherweise englische Inhalte an, bis JavaScript geladen ist – schlecht für die Spracherkennung und die Nutzererfahrung.
  • Rendern Sie das initiale HTML der Islands serverseitig nach Möglichkeit in der richtigen Sprach- und Ländervariante.
  • Bei dynamischen Routen (output: 'server' oder hybrid) muss die Locale über die Middleware weitergereicht werden, damit das SSR-HTML zum URL-Präfix passt.

Wann ist hybrides Rendering nötig? Nutzen Sie hybrides oder serverseitiges Rendering, wenn Inhalte personalisiert, nur nach Anmeldung zugänglich oder erst bei einer Anfrage abgerufen werden. Erzeugen Sie für Marketingseiten, die in den Suchergebnissen ranken sollen, dennoch crawlbare statische Grundgerüste je Sprach- und Ländervariante. Für Marketingseiten sollte die statische Generierung der Standard sein; reservieren Sie dynamisches Rendering für App-Bereiche, die eine Anmeldung erfordern.

Redaktioneller Workflow für MDX- und CMS-Inhalte

Markdown und MDX bleiben für viele Teams die am einfachsten zu pflegende Inhaltsebene in Astro:

  1. Ausgangstexte in Übersetzungsdateien (src/i18n/fr.json) für die Bedienelemente der Benutzeroberfläche.
  2. Frontmatter pro Locale-Datei für längere Inhalte.
  3. Pull Requests pro Locale-Paket mit Glossarprüfungen.
  4. CAT- oder TMS-Export für umfangreiche Dokumentationsbestände – anschließend wieder in src/content importieren.

Googles Empfehlungen zu hilfreichen Inhalten stellen Seiten in den Vordergrund, die für Menschen erstellt wurden. Ungeprüfte, rein maschinelle Übersetzungen führen zu wenig hilfreichen lokalisierten Angeboten.

Definieren Sie Freigabekriterien für die Veröffentlichung: kein Merge, wenn erforderliche Locale-Felder fehlen, interne Links aus der jeweiligen Sprachversion herausführen oder stichprobenartig geprüfte hreflang-Paare keine gegenseitigen Verweise aufweisen.

Checkliste für die Implementierung

Häufige Fehler

  1. Rein englisches Layout-Grundgerüst auf lokalisierten Routen.
  2. Fehlende hreflang-Verweise, weil statische Pfade manuell gepflegt wurden.
  3. Standard-Locale ausgeblendet, ohne Alternativen zu dokumentieren – dadurch fehlen gegenseitige Verweise.
  4. Clientseitig gerenderte Sprachauswahl ohne separate URLs.
  5. Mehrere Sprachen innerhalb einer MDX-Datei durch das Zusammenführen unvollständiger Übersetzungen.
  6. Veröffentlichung unfertiger Sprach- und Ländervarianten mit Lorem-ipsum-Texten oder englischen Platzhaltern.
  7. Fehlende Sitemap bei großen statischen Websites – dadurch werden Inhalte langsamer entdeckt.
  8. Unbedacht auf eine andere Sprachversion verweisende Canonical-URL.

Auch die Bing Webmaster Guidelines betonen, wie wichtig crawlbare, nützliche Inhalte und eine klare Websitestruktur für die Indexierung in verschiedenen Märkten sind.

Grundlagen für klassische Suche und Antwortmaschinen

Die gemeinsamen Grundlagen für statisches, lokalisiertes HTML und Content Collections in Astro sind für Google, Bing und Antwortmaschinen gleichermaßen wichtig: crawlbare Sprachversionen, klar definierte Entitäten, belegte Aussagen, strukturierte Daten, die den tatsächlichen Inhalt korrekt wiedergeben, und echte Lokalisierung statt rein englischer Grundgerüste. Betrachten Sie die folgenden Leitfäden als plattformspezifische Perspektiven auf dieselben Anforderungen an die Bereitstellung mehrsprachiger Inhalte.

Damit die Google-Suche Inhalte finden kann, braucht sie crawlbare URLs für die jeweiligen Sprach- und Marktversionen mit sprachlich passendem HTML, korrekten Seitentiteln und Überschriften sowie gegenseitigen Hreflang-Verweisen, sofern alternative Versionen existieren. Zu den technischen Grundlagen gehören indexierbare Inhalte statt rein Cookie-basierter Sprachumschalter, lokalisierte Metadaten, Sitemaps und ein konsequenter Einsatz von Canonical-Tags. Inhaltliche Qualität bedeutet, in jeder Sprache Hauptinhalte bereitzustellen, die den Menschen in den Mittelpunkt stellen. Autorität entsteht durch eine klar erkennbare Organisationsidentität und bestätigende Quellen – nicht durch Marketing für Übersetzungstools. Für mehrsprachige Websites heißt das: Jede markt- oder sprachspezifische URL muss für sich bestehen können. Zur Erfolgskontrolle dienen die Indexabdeckung in der Search Console und die URL-Prüfung je Sprach- oder Marktversion. Gesichert und ungewiss: Google dokumentiert den Umgang mit Mehrsprachigkeit und Hreflang, garantiert aber keine Rankings durch ein bestimmtes CMS oder einen MTPE-Workflow.

Plattform-Leitfaden: Bing

Bing findet und indexiert crawlbare mehrsprachige Seiten mit klarer Struktur. Die Anforderungen an eindeutige URLs und verständliche Inhalte ähneln denen von Google. Zu den technischen Grundlagen gehören abrufbare URLs für die jeweiligen Sprach- und Regionalversionen, nützliche Inhalte und die Überwachung mit Bing Webmaster Tools. Lokalisieren Sie Überschriften, Aussagen und FAQs, statt nur die Benutzeroberfläche zu übersetzen. Autoritätssignale hängen auch hier von vertrauenswürdigen Quellen und konsistent dargestellten Entitäten ab. Für mehrsprachige Websites heißt das: Verbergen Sie Sprachversionen nicht hinter einer rein clientseitigen Umschaltung. Messen Sie die Indexierung und Crawl-Statistiken in Bing Webmaster Tools. Gesichert und ungewiss: Die Bing-Richtlinien betonen crawlbare, nützliche Inhalte. Erfinden Sie keine Bing-spezifischen Rankingfaktoren für Übersetzungstools.

Plattform-Leitfaden: ChatGPT

ChatGPT kann öffentlich zugängliche Seiten zitieren oder zusammenfassen, wenn die Sprachversionen eindeutig sind und die Inhalte sich unmittelbar für Antworten eignen. Die Auffindbarkeit folgt keinem herkömmlichen, crawlbasierten Ranking; Sichtbarkeit zeigt sich darin, dass eine Seite als Quelle ausgewählt oder in Antworten referenziert wird. Die technische Grundlage bilden weiterhin zugängliche HTML-URLs – keine Widget-Overlays, die Texte verbergen. Hilfreich sind direkte Antworten, FAQs und eine durch Glossare vereinheitlichte Terminologie. Autorität entsteht durch Belege und konsistente Entitäten über alle Sprach- und Marktversionen hinweg. Für mehrsprachige Websites heißt das: Jede lokalisierte Seite sollte für sich verständlich sein. Die Messbarkeit ist begrenzt – Prüfungen auf Quellenverweise sollten als Hypothesentests betrachtet werden. Gesichert und ungewiss: Es gibt keine dokumentierte Garantie dafür, dass MTPE oder eine bestimmte CMS-Integration zu Quellenverweisen in ChatGPT führt.

Plattform-Leitfaden: Gemini

Für Gemini und verwandte KI-Angebote von Google sind konsistent dargestellte Entitäten, sachlich korrekte strukturierte Daten und indexierbare lokalisierte Seiten hilfreich. Bei Sichtbarkeit geht es darum, als Quelle herangezogen oder erkannt zu werden – nicht darum, Rankingfaktoren für Gemini zu erfinden. Die technischen Grundlagen überschneiden sich mit denen der Google Suche: Crawlbarkeit und hochwertige Metadaten. Inhalte sollten in jeder Sprache klare Aussagen und Definitionen liefern. Autorität hängt von einer konsistenten Darstellung der Organisation und bestätigenden Quellen ab. Für mehrsprachige Websites heißt das: Durch Glossare vereinheitlichte Produktnamen reduzieren Verwechslungen zwischen Sprach- und Regionalversionen. Nutzen Sie für die klassische Messung die Search Console und prüfen Sie ergänzend Stichproben von KI-Antworten qualitativ. Gesichert und ungewiss: Das Verhalten von Gemini ersetzt nicht die dokumentierten Empfehlungen der Google Suche zu hreflang und Sprachversionen.

Plattform-Leitfaden: Google AI Overviews

Google AI Overviews können auf Seiten verlinken, die ihre Aussagen stützen. Die Grundlage für eine mögliche Berücksichtigung bilden weiterhin indexierbare Inhalte, die Menschen in den Mittelpunkt stellen. Sie sind keine Sprachumschaltung und ersetzen hreflang nicht. Zu den technischen Grundlagen gehören weiterhin crawlbare HTML-Seiten für jede Sprach- und Regionalversion sowie wahrheitsgemäße strukturierte Daten. Wichtige inhaltliche Merkmale sind prägnante Antworten und klare Überschriften in jeder Sprache. Die Autoritätssignale entsprechen den Erwartungen an hilfreiche Inhalte. Für mehrsprachige Websites heißt das: Für keine übersetzte Seite ist die Aufnahme in AI Overviews garantiert. Nutzen Sie, sofern verfügbar, Berichte zu generativen Suchfunktionen in der Search Console und erfassen Sie klassische Indexierungskennzahlen separat. Gesichert und ungewiss: Kein Übersetzungsworkflow kann eine Platzierung in AI Overviews versprechen.

Wie GlotEO unterstützt

Wann sollten Astro-Teams eine Übersetzungsplattform einführen? Sobald sich Glossarvorgaben, Prüfwarteschlangen je Locale und hreflang-Matrizen nicht mehr praktikabel über manuelle JSON- und MDX-Pull-Requests verwalten lassen.

Das Entwicklungsteam kann ein perfektes i18n-Routing in Astro bereitstellen – für die Lokalisierung braucht es dennoch Glossare, Prüfwarteschlangen und konsequente Veröffentlichungsprozesse. Entdecken Sie die Website-Lokalisierung mit GlotEO, um Briefings, Übersetzungsworkflows und Qualitätssicherungsstufen mit den Content-Pipelines statischer Websites zu verknüpfen. So bleiben MDX- und Wörterbuchaktualisierungen auf die hreflang-Verweise und SEO-Metadaten abgestimmt, die Ihr Astro-Build erzeugt.

Vergleichen Sie Preise und Tarife von GlotEO, wenn das Übersetzungsvolumen für manuelle JSON-Anpassungen zu groß wird. Nutzen Sie außerdem Tools für mehrsprachige SEO-Workflows, damit sowohl Entwicklungs- als auch Content-Teams Locale-Matrizen und redaktionelle Anforderungen im Blick behalten.

Ergänzen Sie dieses Astro-Tutorial durch den Leitfaden Internationale SEO versus mehrsprachige SEO, wenn die Sprach- und Länderstrategie vor der Implementierung festgelegt werden muss.

Quellen