In der quartz.config.yaml steht ein Feld:
configuration:
locale: de-DEEs entscheidet über die Oberfläche: die Wörter, die Quartz selbst beisteuert — „Backlinks“, „Zuletzt geändert“, die Beschriftung der Suche —, und über das Format der Datumsangaben. Es gilt für die ganze Website, und es gibt genau eines.
Damit lässt sich eine Website in einer Sprache bauen. Wer Notizen in zwei Sprachen hat, kann sie alle in einen Vault legen — Quartz baut daraus Seiten, und die Seiten stehen nebeneinander. Was fehlt, ist alles, was aus zwei Stapeln Seiten eine zweisprachige Website macht:
| Was fehlt | Was das heißt |
|---|---|
| Die Sprache je Seite | Quartz weiß nicht, dass de/kaffee deutsch ist. <html lang> trägt für jede Seite dasselbe. |
| Die Verbindung | Niemand weiß, dass de/kaffee und en/coffee dieselbe Seite sind. |
| Ein Umschalter | Ohne Verbindung kann es ihn nicht geben. |
hreflang | Suchmaschinen sehen zwei unabhängige Seiten statt zweier Fassungen einer. |
| Der Einstieg | / führt auf eine Startseite. Welche? |
| Der Hinweis | Ein Besucher landet auf der falschen Sprache und erfährt nicht, dass es seine gibt. |
Genau diese sechs Lücken füllt das Plugin — jede in einem eigenen Kapitel dieses Handbuchs.
Was es nicht ändert
Das site-weite locale bleibt. Die Oberflächentexte anderer Plugins folgen weiterhin ihm, nicht
der Sprache der einzelnen Seite. Auf einer deutschen Site heißt der Kasten unter dem Text also auch
auf den englischen Seiten „Rückverweise“.
Das ist keine Nachlässigkeit, sondern die Grenze zwischen Plugin und Quartz: Diese Texte kommen aus Quartz’ eigener Übersetzungstabelle, die einmal je Bau geladen wird. Wer sie mitübersetzt haben will, baut eine Site je Sprache — wie das geht, steht in Kapitel 8.