Integrazione Astro (beta)
Traduci il tuo sito Astro in oltre 110 lingue
L'SDK Astro Universally traduce il tuo sito dall'interno del tuo codice. Un albero di pagine serve ogni lingua sotto il proprio URL sul tuo dominio.
Come funziona Universally con Astro
Aggiungi traduzioni al tuo progetto Astro in quattro passaggi.
1. Installa il pacchetto
Esegui npm install @universally-sdk/astro nel tuo progetto. Funzionano anche pnpm, yarn e bun.
2. Aggiungi la tua chiave API
Aggiungi UNIVERSALLY_API_KEY al tuo file .env. Tienila sul server e mai nel codice client.
3. Aggiungi l'integrazione
Aggiungi universally() alle integrazioni in astro.config.mjs e imposta il tuo URL site.
4. Traduci le tue pagine
Usa t() per le stringhe e href() per i link, e aggiungi <UniversallyHead /> al tuo layout. Ogni lingua viene servita in /<lang>/.
Potenti funzionalità per siti Astro multilingue
Tutto ciò che ti serve per pubblicare il tuo sito Astro in ogni lingua, dalla stessa codebase.
Traduzione AI
Traduzione automatica AI
Ogni stringa che passi a t() viene tradotta dall'IA che tiene conto del suo contesto.
- Traduzione IA consapevole del contesto
- Oltre 110 lingue
- Modifica le stringhe nella dashboard
Ottimizzazione SEO
Un URL reale per ogni lingua
Ogni lingua viene servita sotto il proprio prefisso /{lang}/ sul tuo dominio. <UniversallyHead /> aggiunge un link hreflang per lingua più x-default, così i motori di ricerca possono trovare ogni versione.
- URL delle lingue come /fr/
- Hreflang per ogni lingua
- x-default incluso
SDK per sviluppatori
Costruito per sviluppatori Astro
L'SDK si integra in Astro come un'integrazione. Racchiudi le stringhe in t() e i link in href(), e Astro renderizza ogni lingua dallo stesso albero di pagine.
- Astro 5 e versioni successive
- SSR e build statiche
- Pacchetto con licenza MIT
Sincronizzazione dei Contenuti
Le nuove stringhe vengono tradotte automaticamente
Quando aggiungi o modifichi una stringa, l'SDK la segnala dopo l'invio della risposta e la traduce Universally. Finché la traduzione non è pronta, la pagina mostra il testo di origine.
- Stringhe mancanti segnalate
- Tradotto automaticamente
- Nessuna ritraduzione manuale
Prestazioni
Nessun visitatore attende una traduzione
t() è una ricerca sincrona in memoria, quindi le pagine vengono renderizzate senza attendere una richiesta di traduzione. Le modifiche nella dashboard raggiungono un server in esecuzione tramite polling o tramite push firmato.
- Ricerche di stringhe in memoria
- Nessuna attesa di traduzione
- Modifiche tramite polling o push
Sicurezza
La tua chiave API rimane sul server
L'SDK legge UNIVERSALLY_API_KEY dal tuo file .env sul server, quindi la chiave non viene mai inviata al browser. I push dalla dashboard al tuo sito sono firmati.
- Chiave API lato server
- Push di riesaminazione firmato
- Codice open-source MIT
Ultimi suggerimenti e trucchi
Rimani all'avanguardia con approfondimenti sulla traduzione, strategie multilingue e tutorial sulla localizzazione di Astro per crescere a livello globale.
Pronto a rendere multilingue il tuo sito Astro?
Traduci il tuo sito Astro, servi ogni lingua sul proprio URL e raggiungi un pubblico globale con la piattaforma di traduzione rapida e semplice di Universally.
14 giorni di garanzia soddisfatti o rimborsati
Non è richiesta la carta di credito
Annulla in qualsiasi momento
Domande frequenti
Ottieni risposte alle domande più comuni sull'utilizzo di Universally per creare siti web multilingue che convertono effettivamente i visitatori internazionali.
Quali versioni di Astro e modalità di output sono supportate?
L'SDK richiede Astro 5 o versioni successive. Funziona con il rendering lato server, che richiede un adattatore Astro come @astrojs/node, e con build statiche.
In una build statica, la traduzione avviene al momento della build. Quando la build trova stringhe senza traduzione, registra quante nuove stringhe sono state tradotte e ti chiede di ricostruire per includerle.
Come si presenta la configurazione nel codice?
Importi universally da @universally-sdk/astro e aggiungi universally() all'elenco delle integrazioni in astro.config.mjs. Imposti anche l'opzione site al tuo URL di produzione e inserisci UNIVERSALLY_API_KEY nel tuo file .env.
Nelle tue pagine, racchiudi il testo in t() e i link interni in href(), e posiziona <UniversallyHead /> nell'head del tuo layout.
Universally rallenterà il mio sito Astro?
No. t() è una ricerca sincrona in memoria, quindi nessun visitatore attende una richiesta di traduzione. Le stringhe senza traduzione vengono segnalate dopo l'invio della risposta e il primo rendering mostra il testo di origine.
Come gestisce l'SDK la SEO multilingue?
Ogni lingua ottiene il proprio prefisso URL /{lang}/ sul tuo dominio. <UniversallyHead /> aggiunge un <link rel="alternate" hreflang> per lingua più x-default. Gli slug URL stessi non vengono tradotti.
Come fanno le modifiche dalla dashboard a raggiungere il mio sito?
Un server in esecuzione esegue il polling delle modifiche, ogni 60 secondi per impostazione predefinita. Puoi anche inviare una push firmata a /_universally/revalidate in modo che le modifiche vengano visualizzate immediatamente.
Una lingua appena aggiunta fa eccezione: necessita di un riavvio del server o di una ricostruzione prima di apparire sul tuo sito.
Posso usare t() all'interno di isole lato client?
Non ancora. t() viene eseguito sul server, quindi traduci le stringhe nel componente Astro e passale all'isola come props.
Quanto è accurata la traduzione AI?
L'AI è consapevole del contesto, quindi ogni stringa viene tradotta tenendo conto del testo circostante. Puoi modificare qualsiasi stringa nella dashboard e il Glossario e le Regole di Traduzione basati sull'AI bloccano nomi di marchi e termini di settore.
Posso usare l'SDK con i sottodomini linguistici di Universally?
Sì. Imposta universally({ mode: 'proxy' }) quando le tue lingue sono servite sui sottodomini linguistici di Universally. In modalità proxy, il pacchetto aggiunge solo i link hreflang e il selettore di lingua.