Integração Astro (beta)
Traduza seu site Astro para mais de 110 idiomas
O SDK Astro da Universally traduz seu site de dentro do seu código. Uma árvore de páginas atende a cada idioma em seu próprio URL em seu próprio domínio.
Como a Universally Funciona com Astro
Adicione traduções ao seu projeto Astro em quatro etapas.
1. Instale o pacote
Execute npm install @universally-sdk/astro em seu projeto. pnpm, yarn e bun também funcionam.
2. Adicione sua chave de API
Adicione UNIVERSALLY_API_KEY ao seu arquivo .env. Mantenha-a no servidor e nunca no código do cliente.
3. Adicione a integração
Adicione universally() às integrações em astro.config.mjs e defina seu URL site.
4. Traduza suas páginas
Use t() para strings e href() para links, e adicione <UniversallyHead /> ao seu layout. Cada idioma é servido em /<lang>/.
Recursos Poderosos para Sites Astro Multilíngues
Tudo o que você precisa para lançar seu site Astro em todos os idiomas, a partir da mesma base de código.
Tradução por IA
Tradução Automática por IA
Cada string que você passa para t() é traduzida por IA que leva seu contexto em consideração.
- Tradução de IA com reconhecimento de contexto
- Mais de 110 idiomas
- Edite strings no painel
Otimização de SEO
Um URL Real para Cada Idioma
Cada idioma é servido sob seu próprio prefixo /{lang}/ em seu próprio domínio. <UniversallyHead /> adiciona um link hreflang por idioma mais x-default, para que os motores de busca possam encontrar todas as versões.
- URLs de idioma como /fr/
- Hreflang para cada idioma
- x-default incluído
SDK do Desenvolvedor
Feito para Desenvolvedores Astro
O SDK se integra ao Astro como uma integração. Você envolve strings em t() e links em href(), e o Astro renderiza cada idioma a partir da mesma árvore de páginas.
- Astro 5 e posterior
- Builds SSR e estáticos
- Pacote com licença MIT
Sincronização de Conteúdo
Novas Strings Traduzidas Automaticamente
Quando você adiciona ou altera uma string, o SDK a reporta após o envio da resposta e a traduz Universally. Até que a tradução esteja pronta, a página exibe o texto original.
- Strings ausentes reportadas
- Traduzido automaticamente
- Sem retradução manual
Desempenho
Nenhum Visitante Espera por uma Tradução
t() é uma consulta síncrona na memória, então as páginas renderizam sem esperar por uma solicitação de tradução. Edições no painel chegam a um servidor em execução por polling ou por um push assinado.
- Consultas de string na memória
- Sem espera de tradução
- Edições por polling ou push
Segurança
Sua Chave de API Permanece no Servidor
O SDK lê UNIVERSALLY_API_KEY do seu arquivo .env no servidor, então a chave nunca é enviada para o navegador. Pushes do painel para o seu site são assinados.
- Chave de API no lado do servidor
- Push de revalidação assinado
- Código MIT de código aberto
Últimas dicas e truques
Mantenha-se à frente com insights de tradução, estratégias multilíngues e tutoriais de localização Astro para crescer globalmente.
Pronto para Tornar seu Site Astro Multilíngue?
Traduza seu site Astro, sirva cada idioma em seu próprio URL e alcance públicos globais com a plataforma de tradução rápida e fácil da Universally.
Garantia de Reembolso de 14 Dias
Não é Necessário Cartão de Crédito
Cancele a Qualquer Momento
Perguntas Frequentes
Obtenha respostas para as perguntas mais comuns sobre como usar o Universally para criar sites multilíngues que realmente convertem visitantes internacionais.
Quais versões e modos de saída do Astro são suportados?
O SDK requer Astro 5 ou posterior. Ele funciona com renderização no servidor, que precisa de um adaptador Astro como @astrojs/node, e com builds estáticos.
Em um build estático, a tradução ocorre no momento do build. Quando o build encontra strings sem tradução, ele registra quantas novas strings foram traduzidas e pede para você reconstruir para incluí-las.
Como é a configuração no código?
Você importa universally de @universally-sdk/astro e adiciona universally() à lista de integrações em astro.config.mjs. Você também define a opção site para seu URL de produção e coloca UNIVERSALLY_API_KEY em seu arquivo .env.
Em suas páginas, envolva o texto em t() e links internos em href(), e coloque <UniversallyHead /> no head do seu layout.
A Universally vai deixar meu site Astro lento?
Não. t() é uma consulta síncrona na memória, então nenhum visitante espera por uma solicitação de tradução. Strings sem tradução são reportadas após o envio da resposta, e a primeira renderização exibe o texto original.
Como o SDK lida com SEO multilíngue?
Cada idioma recebe seu próprio prefixo de URL /{lang}/ em seu próprio domínio. <UniversallyHead /> adiciona um <link rel="alternate" hreflang> por idioma mais x-default. Os slugs de URL em si não são traduzidos.
Como as edições do painel chegam ao meu site?
Um servidor em execução faz polling por alterações, a cada 60 segundos por padrão. Você também pode enviar um push assinado para /_universally/revalidate para que as edições apareçam imediatamente.
Uma linguagem recém-adicionada é a exceção: ela precisa de uma reinicialização do servidor ou de uma reconstrução antes de aparecer no seu site.
Posso usar t() dentro de ilhas do lado do cliente?
Ainda não. t() é executado no servidor, então traduza as strings no componente Astro e passe-as para a ilha como props.
Quão precisa é a tradução por IA?
A IA tem consciência contextual, então cada string é traduzida com o texto ao redor em mente. Você pode editar qualquer string no painel, e o Glossário e as Regras de Tradução com tecnologia de IA travam nomes de marcas e termos do setor.
Posso usar o SDK com subdomínios de idioma Universally?
Sim. Defina universally({ mode: 'proxy' }) quando seus idiomas forem servidos em subdomínios de idioma Universally. No modo proxy, o pacote apenas adiciona os links hreflang e o seletor de idioma.