Astro-Integration (Beta)
Übersetzen Sie Ihre Astro-Website in über 110 Sprachen
Das Universally Astro SDK übersetzt Ihre Website aus Ihrem Code heraus. Ein Seitenbaum bedient jede Sprache unter ihrer eigenen URL auf Ihrer eigenen Domain.
Wie Universally mit Astro funktioniert
Fügen Sie Ihrer Astro-Projekt in vier Schritten Übersetzungen hinzu.
1. Paket installieren
Führen Sie npm install @universally-sdk/astro in Ihrem Projekt aus. pnpm, yarn und bun funktionieren auch.
2. API-Schlüssel hinzufügen
Fügen Sie UNIVERSALLY_API_KEY zu Ihrer .env-Datei hinzu. Behalten Sie ihn auf dem Server und niemals im Client-Code.
3. Integration hinzufügen
Fügen Sie universally() zu den Integrationen in astro.config.mjs hinzu und legen Sie Ihre site-URL fest.
4. Seiten übersetzen
Verwenden Sie t() für Zeichenfolgen und href() für Links, und fügen Sie <UniversallyHead /> zu Ihrem Layout hinzu. Jede Sprache wird unter /<lang>/ bereitgestellt.
Leistungsstarke Funktionen für mehrsprachige Astro-Websites
Alles, was Sie brauchen, um Ihre Astro-Website in jeder Sprache aus demselben Code zu veröffentlichen.
KI-Übersetzung
Automatische KI-Übersetzung
Jede Zeichenfolge, die Sie an t() übergeben, wird von KI übersetzt, die ihren Kontext berücksichtigt.
- Kontextbezogene KI-Übersetzung
- Über 110 Sprachen
- Zeichenfolgen im Dashboard bearbeiten
SEO-Optimierung
Eine echte URL für jede Sprache
Jede Sprache wird unter ihrem eigenen /{lang}/-Präfix auf Ihrer eigenen Domain bereitgestellt. <UniversallyHead /> fügt einen hreflang-Link pro Sprache plus x-default hinzu, damit Suchmaschinen jede Version finden können.
- Sprach-URLs wie /fr/
- Hreflang für jede Sprache
- x-default enthalten
Entwickler-SDK
Entwickelt für Astro-Entwickler
Das SDK wird als Integration in Astro integriert. Sie umschließen Zeichenfolgen in t() und Links in href(), und Astro rendert jede Sprache aus demselben Seitenbaum.
- Astro 5 und neuer
- SSR und statische Builds
- MIT-lizenziertes Paket
Inhaltssynchronisierung
Neue Zeichenketten werden automatisch übersetzt
Wenn Sie eine Zeichenkette hinzufügen oder ändern, meldet das SDK dies nach dem Senden der Antwort und übersetzt sie Universally. Bis die Übersetzung fertig ist, zeigt die Seite den Quelltext an.
- Fehlende Zeichenketten gemeldet
- Automatisch übersetzt
- Keine manuelle Neuübersetzung
Leistung
Kein Besucher wartet auf eine Übersetzung
t() ist eine synchrone In-Memory-Suche, sodass Seiten ohne Wartezeit auf eine Übersetzungsanfrage gerendert werden. Dashboard-Bearbeitungen erreichen einen laufenden Server durch Abfragen oder durch einen signierten Push.
- In-Memory-Zeichenketten-Lookups
- Keine Übersetzungs-Wartezeit
- Bearbeitungen per Abfrage oder Push
Sicherheit
Ihr API-Schlüssel bleibt auf dem Server
Das SDK liest UNIVERSALLY_API_KEY aus Ihrer .env-Datei auf dem Server, sodass der Schlüssel niemals in den Browser gelangt. Pushes vom Dashboard auf Ihre Website sind signiert.
- Serverseitiger API-Schlüssel
- Signierter Revalidierungs-Push
- Open-Source MIT-Code
Neueste Tipps und Tricks
Bleiben Sie mit Übersetzungseinblicken, mehrsprachigen Strategien und Astro-Lokalisierungs-Tutorials der Zeit voraus, um global zu wachsen.
Bereit, Ihre Astro-Website mehrsprachig zu machen?
Übersetzen Sie Ihre Astro-Website, servieren Sie jede Sprache unter ihrer eigenen URL und erreichen Sie globale Zielgruppen mit der schnellen und einfachen Übersetzungsplattform von Universally.
14 Tage Geld-zurück-Garantie
Keine Kreditkarte erforderlich
Jederzeit kündbar
Häufig gestellte Fragen
Erhalten Sie Antworten auf die häufigsten Fragen zur Verwendung von Universally zur Erstellung von mehrsprachigen Websites, die internationale Besucher tatsächlich konvertieren.
Welche Astro-Versionen und Ausgabe-Modi werden unterstützt?
Das SDK benötigt Astro 5 oder neuer. Es funktioniert mit Server-Rendering, das einen Astro-Adapter wie @astrojs/node benötigt, und mit statischen Builds.
Bei einem statischen Build erfolgt die Übersetzung zur Build-Zeit. Wenn der Build Zeichenketten ohne Übersetzung findet, protokolliert er, wie viele neue Zeichenketten übersetzt wurden, und fordert Sie auf, neu zu bauen, um sie einzuschließen.
Wie sieht die Einrichtung im Code aus?
Sie importieren universally aus @universally-sdk/astro und fügen universally() zur Integrationsliste in astro.config.mjs hinzu. Sie setzen auch die Option site auf Ihre Produktions-URL und legen UNIVERSALLY_API_KEY in Ihre .env-Datei.
In Ihren Seiten umschließen Sie Text mit t() und interne Links mit href() und platzieren <UniversallyHead /> im Kopfbereich Ihres Layouts.
Wird Universally meine Astro-Website verlangsamen?
Nein. t() ist eine synchrone In-Memory-Suche, sodass kein Besucher auf eine Übersetzungsanfrage warten muss. Zeichenketten ohne Übersetzung werden nach dem Senden der Antwort gemeldet, und das erste Rendern zeigt den Quelltext an.
Wie geht das SDK mit mehrsprachigem SEO um?
Jede Sprache erhält ihr eigenes /{lang}/ URL-Präfix auf Ihrer eigenen Domain. <UniversallyHead /> fügt einen <link rel="alternate" hreflang> pro Sprache plus x-default hinzu. URL-Slugs selbst werden nicht übersetzt.
Wie erreichen Bearbeitungen aus dem Dashboard meine Website?
Ein laufender Server fragt standardmäßig alle 60 Sekunden nach Änderungen. Sie können auch einen signierten Push an /_universally/revalidate senden, damit Bearbeitungen sofort angezeigt werden.
Eine neu hinzugefügte Sprache ist die Ausnahme: Sie benötigt einen Serverneustart oder einen Rebuild, bevor sie auf Ihrer Website erscheint.
Kann ich t() in clientseitigen Inseln verwenden?
Noch nicht. t() läuft auf dem Server. Übersetzen Sie daher die Zeichenfolgen in der Astro-Komponente und übergeben Sie sie als Props an die Insel.
Wie genau ist die KI-Übersetzung?
Die KI ist kontextbezogen, sodass jede Zeichenfolge mit Bedacht auf den umgebenden Text übersetzt wird. Sie können jede Zeichenfolge im Dashboard bearbeiten, und das KI-gestützte Glossar und die Übersetzungsregeln sperren Markennamen und Branchenbegriffe.
Kann ich das SDK mit Universally-Sprach-Subdomains verwenden?
Ja. Stellen Sie universally({ mode: 'proxy' }) ein, wenn Ihre Sprachen auf Universally-Sprach-Subdomains bereitgestellt werden. Im Proxy-Modus fügt das Paket nur die hreflang-Links und den Sprachumschalter hinzu.