3.2 – Wenn es nicht klappt

Nie zwei Seiten derselben Sprache

Eine Gruppe von Übersetzungen enthält je Sprache höchstens eine Seite. Tragen zwei deutsche Seiten denselben translationKey, ist das ein Widerspruch: Das Plugin überspringt die Verknüpfung und warnt beim Bauen.

Das passiert häufiger als man denkt — etwa, wenn ein Schlüssel beim Kopieren einer Seite mitwandert.

Gefilterte Seiten sind nicht da

Die Verknüpfung läuft, nachdem die Filter des Baus gelaufen sind. Eine Seite mit draft: true, eine ungelistete oder eine, die publishLanguages entfernt hat, ist für den Umschalter nicht vorhanden — er zeigt sie nicht an.

Das ist richtig so, sieht aber nach einem Fehler aus

Wer eine Übersetzung schreibt, sie als Entwurf markiert und sich dann wundert, warum der Umschalter sie nicht kennt, sucht den Fehler an der falschen Stelle.

Für hreflang gilt es nur bei der Vorgabe-Reihenfolge

Der Umschalter liest die Liste nach allen Filtern, dort fehlt ein Entwurf immer. hreflang schöpft dagegen aus einer Liste, die der Filter dieses Plugins selbst füllt — und ein Filter, der nach ihm läuft, entfernt Seiten, die schon eingetragen sind. Mit den Vorgaben stimmt die Reihenfolge; wer order unter 50 setzt, bekommt Entwürfe im hreflang (1.3).

Nachsehen, was gefunden wurde

Jede Seite trägt das Ergebnis bei sich:

fileData.multilanguage = {
  lang: "de",
  baseSlug: "notizen/kaffee",
  source: "folder",
  translationKey: "kaffee",
  translations: { en: "en/notes/coffee" }
}

Im gebauten HTML steht dasselbe am Umschalter als data-translations — der schnellste Weg nachzusehen, ohne etwas zu ändern: Seite im Browser öffnen, Element untersuchen.

Zeigt source einen anderen Weg als erwartet, liegt der Fehler bei der Erkennung (2.2), nicht bei der Verknüpfung.

Die häufigsten Ursachen

Beobachtung	Ursache
Umschalter führt auf die Startseite	Keine Verknüpfung gefunden — bei switcher.missing: home der Normalfall
Umschalter zeigt die Sprache gar nicht	switcher.missing: hide
Zwei Seiten verknüpfen sich fälschlich	Gleiche Basispfade, wo keine Übersetzung gemeint war — linking einschränken oder Namen ändern
Verknüpfung wirkt nur in eine Richtung	Sie ist immer beidseitig; wirkt sie einseitig, sind es zwei verschiedene Gruppen