Übersetzte Astro-Seiten, direkt von Ihrem Server .
Das Bablic SDK für Astro übersetzt Ihre Seiten auf dem Server, sodass Besucher, Suchmaschinen und KI-Crawler bereits beim ersten Laden gerenderte HTML-Dateien mit Übersetzungen erhalten.
Entwickelt für Astro .
Statische Seiten werden über einen einzigen Sammelweg übersetzt. Bei bedarfsgesteuert gerenderten Seiten wird stattdessen Middleware verwendet. Gemischte Standorte funktionieren auch.
Der Server übersetzt die Seite. Im Browser übersetzt Bablic Inhalte, die Ihre Inseln später rendern, ohne die Arbeit des Servers erneut auszuführen.
Titel, Meta-Tags, Open Graph und JSON-LD werden übersetzt, kanonische Links verweisen auf die jeweilige Sprache, und ein Build-Schritt fügt Ihren Originalseiten hreflang hinzu.
Vier Schritte zu übersetzten Seiten .
Ihre Sprachen und übersetzten URLs stammen aus Ihrem Bablic Dashboard, daher müssen Sie diese nicht im Code auflisten. Ändern Sie die Einstellungen in Bablic , und das SDK übernimmt die Änderung.
-
Füge das Paket hinzu
Installieren Sie das SDK von npm in Ihrem Astro-Projekt.
npm install @bablic-io/sdk-astro -
Behalten Sie die Bablic -Schrift auf jeder Seite bei
Fügen Sie das Tag aus Ihrem Bablic -Dashboard in Ihr Basis-Layout ein, mit
is:inline,damit es den serverseitigen HTML-Code erreicht.<script is:inline src="https://edge.bablic.com/moxie.min.js" data-oljs="P0000" data-glweb-opacity="1"></script> -
Fügen Sie eine Route oder Middleware hinzu.
Für vorgerenderte Seiten fügen Sie eine Catch-All-Route mit Ihrem Projektschlüssel hinzu. Für Seiten, die bei Bedarf gerendert werden, verwenden Sie stattdessen
moxieMiddlewareinsrc/middleware.ts.// src/pages/[...path].ts import { moxieRoute } from '@bablic-io/sdk-astro'; export const prerender = false; export const GET = moxieRoute({ project: 'P0000' }); export const HEAD = GET; -
Versand und Prüfung
Wie gewohnt bereitstellen. Eine übersetzte URL antwortet mit
x-moxie: Beim ersten Mal MISS, dannHITaus dem Cache.curl -sI https://example.com/fr-fr/ # x-moxie: MISS, then HIT
- Ein Bablic -Projekt im Pro-Plan
- Astro 6 mit einem Node-Adapter (
@astrojs/vercel10+ auf Vercel) - Node.js 22
- Übersetzte URLs, die als Sprachordner (
/fr-fr/) oder Subdomains festgelegt sind
Häufig gestellte Fragen .
Das SDK wurde für Astro 6 mit einem Node-Adapter entwickelt und läuft auf Node.js 22. Verwenden Sie auf Vercel @astrojs/vercel Version 10 oder höher.
Ja, da das SDK erst ausgeführt wird, nachdem die Originalseiten existieren. Ihre Originalseiten bleiben vorgerendert, und ein Sammelpfad liefert deren übersetzte Versionen unter Ihren Sprachordnern aus. Seiten, die bei Bedarf gerendert werden, werden stattdessen von der Middleware des SDK übersetzt.
Der Server übersetzt den gesamten HTML-Code der Seite. Wenn eine Insel neuen Text im Browser rendert, übersetzt das Bablic -Skript diesen dort, ohne die Arbeit des Servers erneut auszuführen.
Nein. Das SDK liest Ihre Sprachen und übersetzten URLs aus Ihrem Bablic Dashboard. Wenn Sie sie ändern, erkennt das SDK die Änderung innerhalb von etwa 15 Minuten.
Das Bablic SDK ist im Pro-Tarif ohne zusätzliche Kosten enthalten.
Dieses Paket ist nur für Astro. Für Next.js-Websites installieren Sie stattdessen @ bablic -io/sdk-vercel von npm.
Den vollständigen Leitfaden finden Sie auf npm .
Die npm-Seite behandelt alle Optionen sowie Caching, das Leeren des Caches, Vorschau-Deployments und Hosting-Regeln.