SEO

`seo/hreflang-valid`

hreflang values are ISO 639-1 language codes with an optional script and ISO 3166-1 region (or x-default), linking absolute URLs.

umiarkowanastatycznefe-seo-metadata

Dlaczego

Search engines use hreflang to show each person the version in their language. Locale codes from code (en_US), made-up regions (en-UK) and relative links make the annotation invalid, so the wrong language version ranks or versions compete with each other.

Poprawka

Write the language first, then an optional region, joined with a hyphen: en, en-GB, pt-BR, zh-Hant. Use absolute URLs, list every version on every version including itself, and add x-default for the language picker or auto-redirect page. Generate the set from the i18n configuration so it stays reciprocal.

Przykłady

<!-- bad -->
<link rel="alternate" hreflang="en_UK" href="/en/">
<!-- good -->
<link rel="alternate" hreflang="en-GB" href="https://example.com/en-gb/">
<link rel="alternate" hreflang="x-default" href="https://example.com/">

Źródła

Fakty

Identyfikator: seo/hreflang-valid
Waga: umiarkowana
Sprawdzanie: statyczne sprawdzane w kodzie źródłowym przez audit
Dotyczy plików: html vue svelte astro jsx
Ten sam problem w: Lighthouse hreflang
Uczy jej skill: fe-seo-metadata SEO and metadata
Od wersji: 0.1.0

Plik reguły na GitHubie

Przeczytaj w terminalu

npx github:dawidolko/frontend-skills explain seo/hreflang-valid