Deutsch
Über dieses Handbuch

Dieses Handbuch gehört zum Quartz-Plugin quartz-multilanguage. Und es ist mit ihm gebaut: Der Umschalter oben rechts kommt von dort.

Auch diese Box steht zweimal in der Konfiguration — einmal je Sprache.

4.1 – Form und Beschriftung

options:
  switcher:
    style: dropdown
    label: native
    showCurrent: true
    separator: "|"

Drei Darstellungen

styleWas es istWofür
linksTextlinks nebeneinander, durch separator getrenntzwei, höchstens drei Sprachen
dropdownein details-Element zum Aufklappenviele Sprachen, oder wenig Platz
flagsdas Feld flag je Sprache, Eigenname als Tooltipwenn Platz knapp und die Sprachen bekannt sind

dropdown funktioniert ohne JavaScript — es ist ein details. Das Skript des Plugins schließt es zusätzlich bei einem Klick daneben und mit der Escape-Taste; fehlt es, bleibt das Aufklappen trotzdem bedienbar.

Der Umschalter oben rechts auf dieser Website ist ein dropdown mit label: native.

Flaggen sind Länder, nicht Sprachen

Ein Land kann mehrere Sprachen haben, eine Sprache mehrere Länder. Welche Flagge steht für Englisch? Wer flags nimmt, sollte wissen, dass die Wahl immer jemanden übergeht. Die Vorgabe leitet die Flagge aus der Region des Locale ab (de-DE → 🇩🇪); mit dem Feld flag lässt sich jede davon überschreiben, auch durch Text.

Vier Beschriftungen

labelZeigtBeispiel
codeden Sprachcodede
labelden AnzeigenamenGerman
nativeden Namen in der Sprache selbstDeutsch
translatedTitleden Titel der ZielseiteCoffee

native ist meist die freundlichste Wahl: Wer Deutsch sucht, sucht „Deutsch“, nicht „German“.

translatedTitle ist die interessanteste — sie zeigt, wohin der Klick führt, nicht nur in welche Sprache. Sie braucht eine Verknüpfung, die den Titel kennt; ohne Übersetzung fällt sie auf den Eigennamen zurück.

Die aktuelle Sprache

showCurrent: true zeigt sie als hervorgehobenen Eintrag ohne Link, mit aria-current="page". Mit false erscheinen nur die anderen — kürzer, aber der Besucher sieht nicht mehr, wo er ist.

Wohin er gehört

layout:
  position: header
  group: toolbar

Neben Suche und Farbschema-Schalter, wo Besucher solche Schalter suchen. Jede andere Stelle geht auch — die Werte sind dieselben wie bei jeder Quartz-Komponente.

Auf einer einsprachigen Site und auf Seiten ohne weitere Einträge rendert er nichts. Es braucht also keine Bedingung darum herum.