SDK BABLIC PARA ASTRO

Páginas Astro traduzidas, diretamente do seu servidor .

O SDK Bablic para Astro traduz suas páginas no servidor, para que visitantes, mecanismos de busca e rastreadores de IA recebam HTMLs renderizados com traduções desde o primeiro carregamento.

Ver no npm → Como funciona o SDK

Construído para Astronomia .

Pré-renderizado ou sob demanda

As páginas estáticas são traduzidas por meio de uma rota única e abrangente. As páginas renderizadas sob demanda usam middleware. Sites mistos também funcionam.

Ilhas JavaScript traduzidas

O servidor traduz a página. No navegador, Bablic traduz o conteúdo que suas ilhas renderizam posteriormente, sem refazer o trabalho do servidor.

SEO feito para você

Títulos, meta tags, Open Graph e JSON-LD são traduzidos, os links canônicos apontam para cada idioma e uma etapa de compilação adiciona hreflang às suas páginas originais.

CONFIGURAR

Quatro passos para traduzir páginas .

Seus idiomas e URLs traduzidos vêm do seu painel Bablic , então você não precisa listá-los no código. Altere-os no Bablic e o SDK os detectará.

1. Instalar

Adicione o pacote

Instale o SDK do npm no seu projeto Astro.
```
npm install @bablic-io/sdk-astro
```
2 Etiqueta de script

Mantenha a escrita Bablic em todas as páginas.

Adicione a tag do seu painel de controle Bablic ao seu layout base, com is:inline , para que ela seja exibida no HTML do servidor.
```
<script is:inline
  src="https://edge.bablic.com/moxie.min.js"
  data-oljs="P0000"
  data-glweb-opacity="1"></script>
```
3 Conectar

Adicionar uma rota ou middleware

Para páginas pré-renderizadas, adicione uma rota genérica com a chave do seu projeto. Para páginas renderizadas sob demanda, use moxieMiddleware em src/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;
```
4 Implantação

Enviar e verificar

Implantação normal. Uma URL traduzida responde com x-moxie: MISS na primeira vez e, em seguida, HIT a partir do cache.
```
curl -sI https://example.com/fr-fr/
# x-moxie: MISS, then HIT
```

Antes de começar

Um projeto Bablic no plano Pro
Astro 6 com um adaptador Node ( @astrojs/vercel 10+ no Vercel)
Node.js 22
URLs traduzidas definidas como pastas de idioma ( /fr-fr/ ) ou subdomínios

Guia completo de configuração no npm → Visite a Central de Ajuda

Perguntas frequentes · SDK para Astro

Perguntas frequentes.

Quais versões do Astro o SDK suporta?

O SDK foi desenvolvido para Astro 6 com um adaptador Node e é executado no Node.js 22. No Vercel, use @astrojs/vercel versão 10 ou posterior.

Funciona com páginas pré-renderizadas (estáticas)?

Sim, já que o SDK é executado depois que as páginas originais já existem. Suas páginas originais permanecem pré-renderizadas, e uma rota genérica serve as versões traduzidas em suas pastas de idioma. As páginas renderizadas sob demanda são traduzidas pelo middleware do SDK.

O que acontece com o conteúdo renderizado pelas ilhas?

O servidor traduz tudo o que está no HTML da página. Quando uma ilha renderiza um novo texto no navegador, o script Bablic o traduz diretamente no navegador, sem precisar refazer o trabalho do servidor.

Preciso listar as linguagens que utilizo no código?

Não. O SDK lê seus idiomas e URLs traduzidos do seu painel Bablic . Ao alterá-los, o SDK detecta a mudança em cerca de 15 minutos.

De qual plano Bablic eu preciso?

O SDK Bablic está disponível no plano Pro sem custo adicional.

Meu site foi construído com Next.js. Posso usar este pacote?

Este pacote é exclusivo para Astro. Para sites Next.js, instale o @ bablic -io/sdk-vercel a partir do npm.

PRONTO PARA INSTALAR?

Acesse o guia completo no npm .

A página do npm aborda todas as opções, além de configurações de cache, limpeza de cache, pré-visualização de implantações e regras de hospedagem.

Ver no npm → Voltar ao SDK Bablic

Páginas pré-renderizadas e sob demanda

Idiomas gerenciados no seu painel Bablic

Disponível no plano Pro, sem custo adicional.