7.2 – Zusammenspiel

Die Layout-Box braucht nur ein Frontmatter-Feld namens lang. Wer es hinschreibt, ist ihr gleich.

Ohne weiteres Plugin

Eine Site mit einer Handvoll übersetzter Seiten kommt ohne aus:

---
title: About
lang: en
---

Ab da greift byLang.en. Das reicht für eine zweisprachige Startseite oder ein Impressum in zwei Fassungen.

Mit quartz-multilanguage

Sobald es um ganze Sprachbäume geht, wird das Feld von Hand zu pflegen mühsam. Dann setzt quartz-multilanguage es selbst — aus dem Ordnernamen (en/…), aus einem Dateisuffix (notiz.en.md) oder aus dem Frontmatter. Es bringt außerdem den Sprachumschalter mit, den diese Website oben rechts trägt.

Für die Layout-Box ändert sich dadurch nichts: Sie liest weiterhin nur lang.

Die Reihenfolge zählt an einer Stelle

order bestimmt, wann Quartz ein Plugin lädt. Die Layout-Box ist eine reine Komponente und liest das Frontmatter erst beim Bau der Seite — zu diesem Zeitpunkt hat jeder Transformer längst geschrieben, was er zu schreiben hat.

Deshalb gibt es hier keine Reihenfolge zu beachten

Wer beide Plugins verwendet, muss an order nichts einstellen. Der Wert, der bei quartz-multilanguage empfohlen wird (order: 65, nach crawl-links), betrifft dessen eigene Arbeit am Inhalt, nicht das Zusammenspiel mit dieser Box.

Zwei Dateien statt zwei Einträgen

Ein häufiger Umweg ist, für jede Sprache eine eigene Instanz anzulegen und sie über display oder Frontmatter auseinanderzuhalten. Das funktioniert, kostet aber zwei Einträge, zwei frontmatterKeys und doppelte Pflege. byLang ist dafür da.