Deutsch
Über dieses Handbuch

Dieses Handbuch gehört zur Vorlage Example für QuartzControl. Es erklärt die Vorlage und führt zugleich alles vor, was sie kann.

Der Text hier kommt aus einer Markdown-Datei, nicht aus der Konfiguration.

6.7 – Zwei Sprachen

Quartz kennt ein locale je Website. Diese Vorlage veröffentlicht trotzdem zwei Sprachen aus einem Vault, mit dem Plugin quartz-multilanguage.

Der Aufbau

DeutschEnglisch
Wo die Dateien liegenim Wurzelverzeichnis des Vaultsunter en/
Wie die Sprache erkannt wirddefaultLanguage — nichts passt, also deutschOrdner-Strategie: der erste Pfadteil ist en
Adressen/formatierung/text/betonung/en/formatting/text/emphasis
Dateinamendeutschenglisch
Tagsformatierung, gestaltung, …formatting, design, …

Die deutschen Notizen mussten dafür nicht umziehen. Das ist der Grund für diesen Zuschnitt: Die Ordner-Strategie hätte auch de/ verlangen können, aber dann hätte jede der 133 deutschen Notizen einen neuen Pfad bekommen und jeder Wikilink darauf eine Korrektur. Eine Seite, auf die keine Strategie passt, fällt in die Standardsprache — das genügt.

Die Teile

TeilWo
Spracherkennung und VerknüpfungWie die Sprachen sich finden
Der Umschalter im KopfbereichDer Sprachumschalter
Was einsprachig bleibtWo die zwei Sprachen aufhören

Was das Plugin sonst noch tut

  • <html lang> je Seite. Das Plugin trägt in jede Seite ohne eigenes lang das Locale ihrer Sprache ein. Ein Screenreader wechselt damit die Aussprache, und die Stylesheets dieser Vorlage hängen ihre Explorer-Regel daran.
  • hreflang und og:locale. Jede Seite mit Übersetzung bekommt <link rel="alternate"> auf ihre Geschwister und ein x-default. Dafür braucht die Konfiguration baseUrl.
  • Hinweise über der Seite. Wer mit englischer Browsersprache auf einer deutschen Seite landet, bekommt oben einen Kasten: „Diese Seite gibt es auch auf Englisch.“ Der Text wird erst im Browser eingesetzt und steht deshalb weder im Suchindex noch in der Beschreibung.
  • Daten in der Seitensprache. localizeDates: true formatiert jedes <time>-Element im Browser nach — das Einzige an der Quartz-Oberfläche, was ohne zweiten Build zweisprachig wird.

Ein Build oder zwei

Diese Website ist ein Build. Das hält die Suche, den Graphen und die Adressen zusammen, kostet aber die Oberfläche: Alles, was Quartz selbst beschriftet, folgt configuration.locale und bleibt deutsch. Das Plugin kennt dafür publishLanguages — ein Build je Sprache, jeder mit eigenem locale und eigener baseUrl. Was das jeweils bedeutet, steht unter Wo die zwei Sprachen aufhören.

Die Seiten

Weiterlesen

Diese Seite gehört zu Example — der Beispielvorlage für QuartzControl. Ein Überblick über alle Bereiche steht auf der Startseite.

Auf einem schmalen Bildschirm ist die Navigation oben eingeklappt.