5.1 – hreflang und x-default

Ohne Hinweis sieht eine Suchmaschine zwei unabhängige Seiten mit ähnlichem Inhalt. Mit hreflang sieht sie zwei Fassungen derselben Seite und zeigt jedem Suchenden die in seiner Sprache.

<link rel="alternate" hreflang="de-DE" href="https://example.org/de/notizen/kaffee" />
<link rel="alternate" hreflang="en-US" href="https://example.org/en/notes/coffee" />
<link rel="alternate" hreflang="x-default" href="https://example.org/en/notes/coffee" />

options:
  seo:
    hreflang: true      # Standard
    xDefault: default

Ohne baseUrl gibt es kein hreflang

Die Angabe verlangt absolute Adressen. Steht in der Quartz-Konfiguration keine baseUrl, lässt das Plugin die Zeilen weg — es hat nichts, woraus es sie bilden könnte. Das ist der häufigste Grund, warum sie fehlen.

x-default

Sagt, welche Fassung gelten soll, wenn keine Sprache passt.

Wert	Bedeutung
default	die Standardsprache der Site (Vorgabe)
none	keine Angabe
ein Sprachcode	genau diese Sprache

Für eine Site, deren englische Fassung die vollständigere ist, ist xDefault: en sinnvoll, auch wenn die Standardsprache Deutsch ist.

Was verlinkt wird

Nur Seiten, die eine Verknüpfung haben (Kapitel 3) und die im Bau geblieben sind. Bei Ordner- und Suffix-Konvention kann das Plugin die Partner notfalls aus den Slugs ableiten, auch wenn die Gruppierung nichts gefunden hat.

Eine Seite ohne Übersetzungen bekommt keine hreflang-Zeilen — es gibt nichts zu verlinken.