Multilanguage

Quartz kennt eine Sprache je Website — ein locale in der Konfiguration, und damit hat es sich. quartz-multilanguage ergänzt alles, was fehlt, um dieselben Notizen aus einem Vault in mehreren Sprachen zu veröffentlichen: Es erkennt die Sprache jeder Seite, findet die Übersetzungen zueinander, bringt einen Umschalter mit, schreibt hreflang und og:locale, leitet die Startseite weiter und sagt einem Besucher, wenn es seine Sprache gibt.

Was es kann

Die Sprache jeder Seite erkennen

Am Sprachordner (en/…), an einer Endung im Dateinamen (notiz.en.md) oder an einem Feld im Frontmatter — in der Reihenfolge, die man festlegt. → 2

Übersetzungen zueinander finden

Über einen gemeinsamen Schlüssel im Frontmatter, über Obsidian-Aliase (passend zum Obsidian-Plugin „Multilingual“) oder einfach über denselben Pfad. → 3

Ein Umschalter

Als Textlinks, als Aufklappmenü ohne JavaScript oder als Flaggen; beschriftet mit Sprachcode, Name, Eigenname oder dem Titel der Übersetzung. Er führt auf die Übersetzung dieser Seite. → 4

Was Suchmaschinen wissen müssen

<html lang>, hreflang mit x-default und og:locale stehen auf jeder Seite richtig. → 5

Besucher landen in ihrer Sprache

Die Startseite leitet nach der Sprache des Browsers weiter und merkt sich eine Wahl. Wo eine Übersetzung fehlt, gibt es eine Weiterleitung oder einen Hinweis „nur auf Englisch“, und Daten erscheinen in der Sprache der Seite. → 6, 7

Eine Site für alle Sprachen, oder eine je Sprache

Der Normalfall ist ein Build mit allen Sprachen. Wer je Sprache eine eigene Adresse will, baut nur die gewünschten. → 8

Diese Website ist ihr eigener Beleg

Sie steht auf Deutsch und Englisch, aus einem Vault, mit diesem Plugin. Der Umschalter oben rechts ist seine Komponente; wer die Sprache wechselt, landet auf der Übersetzung dieser Seite — außer auf den Tag-Seiten, die kein Gegenstück haben. Dort führt er zur Startseite der anderen Sprache und sagt es im Tooltip.

Die neun Kapitel

Kapitel	Die Frage, die es beantwortet
1 – Einstieg	Was Quartz allein kann, und was hier dazukommt
2 – Spracherkennung	Woher weiß eine Seite, welche Sprache sie hat?
3 – Verknüpfen	Wie finden zwei Fassungen derselben Seite zueinander?
4 – Der Umschalter	Wie sieht der Wechsel aus, und was steht darin?
5 – Adressen und Metadaten	Was Suchmaschinen von der Mehrsprachigkeit erfahren
6 – Weiterleitungen	Wohin führt /, und was passiert bei fehlender Übersetzung?
7 – Hinweise und Links	„Diese Seite gibt es auch auf …“ — und Links, die die Sprache wechseln
8 – Bauen	Eine Site für alle Sprachen, oder eine je Sprache?
9 – Nachschlagen	Alle Optionen, alle Grenzen

In einer Minute

npx quartz plugin add github:boxi-os/quartz-multilanguage

Ein Eintrag konfiguriert alles auf einmal — Erkennung, Verknüpfung, Umschalter:

plugins:
  - source: github:boxi-os/quartz-multilanguage
    enabled: true
    order: 65
    options:
      languages:
        - { code: de, native: Deutsch, locale: de-DE }
        - { code: en, native: English, locale: en-US }
      defaultLanguage: de
    layout:
      position: header
      group: toolbar

Ausführlich steht das unter [[1-einstieg/02-die-erste-zweisprachige-site|1.2 – Die erste zweisprachige Site]].

Wo es sonst noch steht

Die Kurzfassung ist die README des Repositorys. Das Schwesterplugin quartz-layout-box setzt Markup ins Layout und arbeitet gut mit diesem zusammen; beide gehören zu QuartzControl, nötig ist die App aber nicht.