Pages Astro traduites, directement depuis votre serveur .
Le SDK Bablic pour Astro traduit vos pages sur le serveur, de sorte que les visiteurs, les moteurs de recherche et les robots d'exploration IA reçoivent des fichiers HTML rendus avec les traductions dès le premier chargement.
Conçu pour Astro .
Les pages statiques sont traduites via une seule voie générique. Les pages rendues à la demande utilisent plutôt un intergiciel. Les sites mixtes fonctionnent aussi.
Le serveur traduit la page. Dans le navigateur, Bablic traduit le contenu que vos îles afficheront ultérieurement, sans refaire le travail du serveur.
Les titres, les balises méta, Open Graph et JSON-LD sont traduits, les balises canoniques pointent vers chaque langue et une étape de compilation ajoute hreflang à vos pages originales.
Quatre étapes pour traduire les pages .
Vos langues et URL traduites proviennent de votre tableau de bord Bablic , vous n'avez donc pas besoin de les lister dans le code. Modifiez-les dans Bablic et le SDK les détectera.
-
Ajouter le forfait
Installez le SDK depuis npm dans votre projet Astro.
npm install @bablic-io/sdk-astro -
Conservez l'écriture Bablic sur chaque page
Ajoutez la balise depuis votre tableau de bord Bablic à votre mise en page de base, avec
is:inlinepour qu'elle atteigne le HTML du serveur.<script is:inline src="https://edge.bablic.com/moxie.min.js" data-oljs="P0000" data-glweb-opacity="1"></script> -
Ajouter une route ou un middleware
Pour les pages pré-rendues, ajoutez une route générique avec la clé de votre projet. Pour les pages rendues à la demande, utilisez plutôt
moxieMiddlewaredanssrc/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; -
Expédier et vérifier
Déploiement comme d'habitude. Une URL traduite répond avec
x-moxie : ÉCHECla première fois, puisRÉPONSEà partir du cache.curl -sI https://example.com/fr-fr/ # x-moxie: MISS, then HIT
- Un projet Bablic sur le plan Pro
- Astro 6 avec un adaptateur Node (
@astrojs/vercel10+ sur Vercel) - Node.js 22
- URL traduites définies comme dossiers de langue (
/fr-fr/) ou sous-domaines
Foire aux questions .
Le SDK est conçu pour Astro 6 avec un adaptateur Node et fonctionne sur Node.js 22. Sur Vercel, utilisez @astrojs/vercel version 10 ou ultérieure.
Oui, puisque le SDK s'exécute après la création des pages originales. Vos pages originales restent pré-rendues, et une route générique sert leurs versions traduites dans vos dossiers de langue. Les pages rendues à la demande sont traduites par le middleware du SDK.
Le serveur traduit tout le contenu HTML de la page. Lorsqu'une île affiche du nouveau texte dans le navigateur, le script Bablic le traduit directement sur place, sans que le serveur ait à refaire le travail.
Non. Le SDK lit vos langues et les URL traduites depuis votre tableau de bord Bablic . Lorsque vous les modifiez, le SDK prend en compte la modification en environ 15 minutes.
Le kit de développement logiciel Bablic est disponible sans frais supplémentaires dans le forfait Pro.
Ce forfait est réservé aux utilisateurs d'Astro. Pour les sites Next.js, installez plutôt @ bablic -io/sdk-vercel depuis npm.
Consultez le guide complet sur npm .
La page npm couvre toutes les options, ainsi que la mise en cache, la suppression du cache, les déploiements en prévisualisation et les règles d'hébergement.