Generator Hreflang Screpy tworzy znaczniki HTML, fragmenty mapy witryny XML lub deklaracje HTTP Link dla grupy równoważnych stron językowych. Podaj 2–50 obsługiwanych kodów języka wraz z adresami URL, wybierz format, a następnie skopiuj lub pobierz wynik dla każdej strony. Generator przygotowuje adnotacje z Twoich danych; nie odwiedza adresów, nie instaluje kodu ani nie potwierdza odnośników zwrotnych między opublikowanymi stronami.
Przygotuj grupę równoważnych stron
W jednym przebiegu użyj wersji tej samej strony: tego samego produktu, artykułu lub usługi w różnych językach albo na różnych rynkach. Francuska strona główna i angielska strona produktu nie są równoważne tylko dlatego, że należą do jednej domeny. Powtórz proces dla kolejnej treści, zamiast umieszczać wszystkie przetłumaczone adresy witryny w jednej grupie.
Dla przykładowego produktu z wersjami angielską i turecką przygotuj następujące wartości:
| Pole | Wartość | Przeznaczenie |
|---|---|---|
| Język i URL | en — https://example.com/en/blue-shirt/ |
Angielska strona produktu |
| Język i URL | tr — https://example.com/tr/mavi-gomlek/ |
Równoważna turecka strona produktu |
| Opcjonalny URL x-default | https://example.com/choose-language/ |
Odpowiednia strona wyboru języka |
Przetłumaczone ścieżki mogą się różnić. Skopiuj każdy docelowy publiczny adres, zamiast budować go przez zmianę katalogu języka. Podaj pełny adres HTTP lub HTTPS i zachowaj host, ścieżkę oraz końcowy ukośnik zgodne z planowanym miejscem publikacji. Adresy zawierające dane logowania nie są akceptowane. Formularz usuwa fragmenty takie jak #details; używaj adresów stron, nie odnośników do sekcji.
Wybierz obsługiwane kody języka
Ten generator przyjmuje dwuliterowy język, np. en, tr lub de, opcjonalnie z obsługiwanym dwuliterowym regionem, np. en-GB lub pt-BR. Użyj en, gdy strona jest przeznaczona ogólnie dla anglojęzycznych odbiorców. Kod regionalny wybierz, jeśli rzeczywiście utrzymujesz osobną wersję regionalną. Sam kraj, np. GB, nie oznacza języka.
Każdy zwykły wiersz musi mieć inny kod. en-US i en-us są traktowane jako ta sama wartość; zmiana wielkości liter nie tworzy kolejnej wersji. Wynik używa małych liter dla języka i wielkich dla regionu. Przed skopiowaniem sprawdź wartości, zwłaszcza różnicę między językiem uk a regionem GB oznaczającym Wielką Brytanię.
Formularz obsługuje tylko kody języka i języka-regionu. Nie przyjmuje kombinacji określających pismo, takich jak zh-Hant, choć Google obsługuje takie adnotacje w odpowiednich przypadkach. Jeśli Twoje wdrożenie ich wymaga, przygotuj je poza generatorem. Akceptacja kodu nie potwierdza też, że tekst strony rzeczywiście jest w tym języku.
Zdecyduj, czy dodać x-default
Adres x-default wskazuje miejsce dla użytkowników, których języka lub regionu nie obejmują pozostałe opcje. Może to być strona wyboru języka albo istniejąca strona wybrana jako domyślna. Wyjaśnienie Google dotyczące x-default opisuje obie możliwości. Wybierz cel użyteczny dla tej grupy; nie kieruj odwiedzających każdy produkt na niepowiązaną stronę tylko po to, by wypełnić pole.
Pole jest opcjonalne. Pozostawienie go pustego nie dodaje adnotacji domyślnej. Podany URL dodaje hreflang="x-default" do każdego wygenerowanego zestawu, ale nie tworzy przekierowania przeglądarki ani interfejsu wyboru języka.
Dodanie strony wyboru do dwóch wierszy z przykładu daje dwa bloki wyniku z trzema alternatywami w każdym: en, tr i x-default. Nie powstaje trzeci blok dla strony wyboru. Jeśli domyślny cel jest osobną stroną, samodzielnie skonfiguruj jej odpowiednie adnotacje. Jeśli już znajduje się w zwykłych wierszach, ta strona ma już wygenerowany blok. Sprawdź tę różnicę, zanim założysz, że dla każdego celu istnieje kod do instalacji.
Wybierz wynik HTML lub HTTP Link
Wybierz format, który możesz utrzymywać tam, gdzie udostępniane są strony tej grupy. Nie musisz generować wszystkich trzech tylko dlatego, że są dostępne.
| Format | Miejsce instalacji | Otrzymany wynik |
|---|---|---|
| HTML | <head> każdej strony |
Zestaw elementów <link> |
| HTTP Link | Odpowiedź HTTP każdej strony | Deklaracja nagłówka Link: |
| XML | Mapa witryny z alternatywami językowymi | Fragment <url> dla każdej zwykłej strony |
Dla HTML przykładowa grupa daje ten zestaw, który należy umieścić w head obu stron produktu:
<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/" />
Angielska strona wskazuje siebie i stronę turecką; strona turecka otrzymuje ten sam zestaw. W CMS użyj szablonu lub pola sterującego head. Wklejenie znaczników do widocznej treści artykułu nie jest właściwą instalacją.
Wynik HTTP Link należy umieścić w nagłówkach odpowiedzi, konfigurowanych przez system publikacji lub serwer. Przydaje się dla dokumentów takich jak PDF bez head HTML. Skopiuj całą deklarację, nie tylko adres, i sprawdź rzeczywistą odpowiedź po instalacji. Pobranie pliku tekstowego samo nie zmienia odpowiedzi. Dodając alternatywy, zachowaj istniejące, niepowiązane deklaracje nagłówków.
Połącz fragmenty XML w mapę witryny
Pobrany XML jest fragmentem strony, nie kompletną mapą witryny gotową do przesłania. Każdy blok zawiera <loc> dla strony ze zwykłego wiersza i powtarza alternatywy jako elementy <xhtml:link>. Dodaj bloki do mapy witryny z przestrzeniami nazw sitemap i XHTML.
Dla przykładu na tym samym hoście pełny plik z dwiema stronami wyglądałby tak:
<?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>
Dwie wartości <loc> różnią się; zestawy alternatyw są jednakowe. Dodając fragmenty do istniejącego pliku, zachowaj jeden otaczający <urlset>, zamiast zagnieżdżać pełne dokumenty. Zastąp przykładowe adresy własnymi i zachowaj encje XML takie jak & w parametrach zapytania. Opublikuj plik w miejscu obejmującym wymienione strony; ten przykład pasuje do mapy witryny w katalogu głównym example.com.
Sprawdź instrukcje Google dotyczące hreflang w mapach witryny, aby poznać wymagania przestrzeni nazw i hostingu. Osobne pliki generatora nie łączą, nie hostują ani nie przesyłają mapy witryny za Ciebie.
Zweryfikuj zainstalowane adnotacje
Wygenerowany wynik pokazuje, co dają podane wartości, nie to, co otrzymują użytkownicy lub roboty. Po instalacji porównaj opublikowane strony z planowaną grupą:
- Sprawdź, czy każdy alternatywny adres otwiera właściwą stronę językową, a nie błąd, stary adres lub niepowiązany cel.
- Dla HTML lub nagłówków sprawdź rzeczywiste adnotacje każdej zwykłej strony, w tym wskazanie samej siebie i odnośniki zwrotne do innych wersji.
- Dla XML sprawdź samą opublikowaną mapę witryny: strukturę zewnętrzną, każdy
<loc>i pełny zestaw alternatyw. - Przejrzyj znaczniki canonical razem z alternatywami. Wskazówki Google dotyczące canonical zalecają stronę kanoniczną w tym samym języku, jeśli istnieje. Nie kieruj automatycznie canonical każdej wersji językowej do strony angielskiej.
Użyj Hreflang Tags Tester do sprawdzenia opublikowanych deklaracji HTML i HTTP. Nie weryfikuje on adnotacji w mapach witryny ani znaczników renderowanych przez JavaScript. Jeśli preferowane adresy nie pasują do grupy, sprawdź je za pomocą Canonical Tag Checker.
Gdy tłumaczenie zmieni adres lub zniknie, zaktualizuj grupę wszędzie, gdzie ją wdrożono. Wygenerowanie nowego zestawu bez zastąpienia opublikowanych adnotacji pozostawia starą relację. Hreflang pomaga opisywać równoważne wersje; nie tłumaczy treści i nie gwarantuje indeksacji, pozycji ani stałego wyświetlania określonego adresu przez Google.