Die Astro-Integration ist ein Paket, @universally-sdk/astro, das Ihre Astro-Website in jeder Sprache Ihres Universally-Projekts aus einem einzigen Seitenbaum bedient. Ihre Quellsprache bleibt unter /about, und jede Zielsprache wird auf demselben Host unter ihrem eigenen Präfix bedient, z. B. /fr/about, ohne zusätzliche Routen. Die Integration ist im Beta-Stadium und benötigt Astro 5 oder neuer.
Wie übersetzte Seiten bedient werden
Wenn Sie ein Astro-Projekt erstellen, fragt der Bildschirm Einrichtungsanweisungen Wie sollen übersetzte Seiten bedient werden? und bietet drei Karten an. Nichts ist vorausgewählt, und Weiter bleibt deaktiviert, bis Sie eine auswählen.
| Karte | URL-Beispiel | Was passiert |
|---|---|---|
| SDK (Empfohlen) | website.com/fr/ |
Ihr Astro-Server rendert übersetzte Seiten. Sie installieren ein Paket. |
| JavaScript | website.com |
Ein Skript-Tag übersetzt die Seite im Browser. Keine DNS-Änderung, aber keine Sichtbarkeit für Suchmaschinen und nur öffentliche Seiten. |
| Subdomain | fr.website.com |
Universally bedient jede Sprache auf ihrer eigenen Subdomain, indem es Ihre Seite abruft und übersetzt. Ihre Astro-App rendert nur die Quellsprache. |
Ihre Website läuft wie bisher weiter, bis Sie die Einrichtung abgeschlossen haben. Der Rest dieses Abschnitts behandelt die Modi SDK und Subdomain.
Wie der SDK-Modus funktioniert
- Sprachen werden einmal gelesen, wenn Ihre Astro-Konfiguration ausgeführt wird. Die Integration fragt Universally nach den Sprachen des Projekts, überspringt alle, deren Schalter Live ausgeschaltet ist, und verwendet das URL-Präfix jeder Sprache als Pfadsegment.
- Übersetzungen leben im Speicher Ihres Servers. Der gesamte Katalog wird geladen, wenn der Entwicklungs-Server oder ein Build startet, sodass
t()eine synchrone Suche ohne Netzwerkaufruf ist, während eine Seite gerendert wird. - Neue Zeichenketten werden nach der Antwort gemeldet. Eine Zeichenkette ohne Übersetzung wird in Ihrem Quelltext gerendert und an Universally gesendet, sobald der Besucher die Seite bereits hat. Ein späteres Rendern zeigt sie übersetzt an, normalerweise ein oder zwei Sekunden später.
- Dashboard-Bearbeitungen erreichen Ihren Server durch einen Push auf Ihre Website oder durch eine Prüfung, die standardmäßig höchstens alle 60 Sekunden pro Sprache läuft.
- Die Quellsprache kostet nichts. Auf Quellseiten gibt
t()sein Argument zurück und macht keine Suche, Meldung oder API-Aufrufe.
Glossarregeln gelten für jede Zeichenkette, und Bearbeitungen, die Sie auf dem Bildschirm Übersetzungen vornehmen, erreichen Ihren Server. Übersetzungsregeln sind für SDK-Projekte ausgeblendet, da Ihr Code entscheidet, was über t() geht.
Grenzen
- Kein Client-seitiges
t(). Es existiert nur auf dem Server, inAstro.locals. Islands erhalten übersetzten Text als Props. - Statische Seiten werden zur Build-Zeit übersetzt. Neue Zeichenketten und Dashboard-Bearbeitungen erfordern einen Rebuild.
- Wörter stammen aus dem Prepaid-Guthaben Ihres Projekts. Sobald dieses aufgebraucht ist, werden bereits übersetzte Zeichenfolgen weiterhin bereitgestellt und neue bleiben in der Quellsprache. Siehe Nutzungsbeschränkungen.
- Zum Erstellen eines Projekts sind die Rolle „Besitzer“ oder „Administrator“ erforderlich. Siehe Rollen und Berechtigungen.