Il Generatore Hreflang di Screpy crea tag HTML, frammenti di sitemap XML o dichiarazioni HTTP Link per un gruppo di pagine equivalenti in lingue diverse. Inserisci da 2 a 50 codici supportati con i relativi URL, scegli un formato e copia o scarica l’output di ogni pagina. Il generatore prepara le annotazioni dai tuoi valori; non visita gli URL, installa il codice o conferma i rimandi reciproci delle pagine pubblicate.
Prepara un gruppo di pagine equivalenti
Usa ogni generazione per le versioni della stessa pagina: lo stesso prodotto, articolo o servizio in lingue o mercati diversi. Una homepage francese e una pagina prodotto inglese non sono equivalenti solo perché condividono il dominio. Ripeti il processo per il contenuto successivo invece di inserire tutti gli URL tradotti del sito in un unico gruppo.
Per un prodotto illustrativo con versioni inglese e turca, prepara questi valori:
| Campo | Valore | Scopo |
|---|---|---|
| Lingua e URL | en — https://example.com/en/blue-shirt/ |
Pagina prodotto inglese |
| Lingua e URL | tr — https://example.com/tr/mavi-gomlek/ |
Pagina prodotto turca equivalente |
| URL x-default facoltativo | https://example.com/choose-language/ |
Destinazione adatta alla scelta della lingua |
I percorsi tradotti possono essere diversi. Copia ogni URL pubblico previsto invece di costruirlo cambiando la cartella della lingua. Includi l’indirizzo HTTP o HTTPS completo e mantieni host, percorso e barra finale coerenti con la destinazione da pubblicare. Gli URL con credenziali non sono accettati. Il modulo rimuove frammenti come #details: usa indirizzi di pagine, non collegamenti a sezioni.
Scegli codici di lingua supportati
Questo generatore accetta una lingua di due lettere, come en, tr o de, eventualmente seguita da una regione supportata di due lettere, come en-GB o pt-BR. Usa en quando la pagina si rivolge ai lettori anglofoni in generale; usa un codice regionale quando mantieni davvero quella versione regionale. Un paese da solo, come GB, non indica una lingua.
Ogni riga normale deve avere un codice diverso. en-US ed en-us sono la stessa voce: cambiare le maiuscole non crea un’altra versione. I codici generati usano minuscole per la lingua e maiuscole per la regione. Controlla i valori prima di copiarli, soprattutto la differenza tra la lingua uk e la regione GB per il Regno Unito.
Il modulo supporta solo codici lingua e lingua-regione. Non accetta combinazioni di scrittura come zh-Hant, anche se Google supporta annotazioni di scrittura nei casi appropriati. Se la tua implementazione le richiede, preparale fuori da questo generatore. Un codice accettato non conferma neppure che il testo della pagina corrisponda a quella lingua.
Decidi se aggiungere x-default
Un URL x-default identifica una destinazione per utenti la cui lingua o regione non è coperta dalle altre opzioni. Può essere un selettore di lingua o una pagina esistente scelta come predefinita. La spiegazione di Google su x-default descrive entrambe le possibilità. Scegli una destinazione utile per questo gruppo; non inviare i visitatori di ogni prodotto a una pagina non pertinente solo per compilare il campo.
Il campo è facoltativo. Lasciandolo vuoto non aggiungi un’annotazione predefinita. Inserendo un URL aggiungi hreflang="x-default" a ogni insieme generato, senza creare un reindirizzamento del browser o un’interfaccia di selezione della lingua.
Con le due righe dell’esempio, aggiungere il selettore produce due blocchi di output con tre alternative ciascuno: en, tr e x-default. Non viene creato un terzo blocco per il selettore. Se la destinazione predefinita è una pagina separata, configura tu le sue annotazioni corrispondenti. Se è già uno degli URL delle righe normali, quella pagina ha già un blocco generato. Verifica questa distinzione prima di presumere che ogni destinazione abbia il proprio codice da installare.
Scegli l’output HTML o HTTP Link
Scegli il formato che puoi mantenere dove vengono servite le pagine del gruppo. Non occorre generarli tutti e tre solo perché disponibili.
| Formato | Dove installarlo | Output ricevuto |
|---|---|---|
| HTML | Il <head> di ogni pagina |
Un insieme di elementi <link> |
| HTTP Link | La risposta HTTP di ogni pagina | Una dichiarazione di header Link: |
| XML | Una sitemap con alternative linguistiche | Un frammento <url> per ogni pagina normale |
Per HTML, il gruppo illustrativo produce questo insieme da inserire nel head di entrambe le pagine prodotto:
<link rel="alternate" hreflang="en" href="https://example.com/en/blue-shirt/" />
<link rel="alternate" hreflang="tr" href="https://example.com/tr/mavi-gomlek/" />
<link rel="alternate" hreflang="x-default" href="https://example.com/choose-language/" />
La pagina inglese include sé stessa e quella turca; la pagina turca riceve lo stesso insieme. In un CMS, usa il modello o il campo che controlla il head. Incollare i tag nel corpo visibile di un articolo non è l’installazione prevista.
L’output HTTP Link va negli header di risposta, configurati nel sistema di pubblicazione o sul server. È utile per documenti come PDF senza head HTML. Copia l’intera dichiarazione, non solo un URL, e controlla la risposta reale dopo l’installazione. Scaricare un file di testo non cambia una risposta da solo. Conserva le dichiarazioni di header esistenti non collegate a queste alternative.
Trasforma i frammenti XML in una sitemap
Il download XML è un frammento di pagina, non una sitemap completa pronta da inviare. Ogni blocco fornisce un <loc> per la pagina della relativa riga normale e ripete le alternative come elementi <xhtml:link>. Aggiungi i blocchi a una sitemap con i namespace sitemap e XHTML.
Per l’esempio sullo stesso host, un file completo di due pagine avrebbe questa forma:
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
xmlns:xhtml="http://www.w3.org/1999/xhtml">
<url>
<loc>https://example.com/en/blue-shirt/</loc>
<xhtml:link rel="alternate" hreflang="en" href="https://example.com/en/blue-shirt/" />
<xhtml:link rel="alternate" hreflang="tr" href="https://example.com/tr/mavi-gomlek/" />
<xhtml:link rel="alternate" hreflang="x-default" href="https://example.com/choose-language/" />
</url>
<url>
<loc>https://example.com/tr/mavi-gomlek/</loc>
<xhtml:link rel="alternate" hreflang="en" href="https://example.com/en/blue-shirt/" />
<xhtml:link rel="alternate" hreflang="tr" href="https://example.com/tr/mavi-gomlek/" />
<xhtml:link rel="alternate" hreflang="x-default" href="https://example.com/choose-language/" />
</url>
</urlset>
I due valori <loc> sono diversi; gli insiemi di alternative coincidono. Quando aggiungi frammenti a un file esistente, mantieni un unico <urlset> esterno invece di annidare documenti completi. Sostituisci gli URL di esempio e conserva gli escape XML come & nelle stringhe di query. Pubblica il file in una posizione che copra le pagine elencate; questo esempio è adatto a una sitemap nella radice di example.com.
Consulta le istruzioni di Google per hreflang nelle sitemap per i requisiti di namespace e hosting. I download separati del generatore non assemblano, ospitano o inviano la sitemap per te.
Verifica le annotazioni installate
Il risultato generato mostra ciò che producono i tuoi valori, non ciò che ricevono visitatori o crawler. Dopo l’installazione, confronta le pagine pubblicate con il gruppo previsto:
- Controlla che ogni indirizzo alternativo apra la pagina nella lingua desiderata, non un errore, un vecchio URL o una destinazione non pertinente.
- Per HTML o header, esamina le annotazioni reali di ogni pagina normale, inclusi l’autoreferenza e i rimandi alle altre versioni.
- Per XML, esamina la sitemap pubblicata: la struttura esterna, ogni
<loc>e il suo insieme completo di alternative. - Controlla i tag canonical insieme alle alternative. Le indicazioni di Google sui canonical raccomandano una pagina canonica nella stessa lingua quando disponibile. Non indirizzare automaticamente il canonical di ogni traduzione alla pagina inglese.
Usa Hreflang Tags Tester per esaminare le dichiarazioni HTML e HTTP pubblicate. Non valida le annotazioni nelle sitemap o i tag renderizzati con JavaScript. Se gli URL preferiti non corrispondono al gruppo, esaminali con Canonical Tag Checker.
Quando una traduzione cambia indirizzo o scompare, aggiorna il gruppo ovunque lo hai installato. Generare un insieme nuovo senza sostituire le annotazioni pubblicate lascia invariata la vecchia relazione. Hreflang aiuta a descrivere versioni equivalenti; non traduce contenuti né garantisce indicizzazione, posizionamento o che Google mostri sempre un URL specifico.