1.2 – Die erste zweisprachige Site

1. Inhalt ordnen

Der einfachste Weg sind zwei Sprachordner:

content/
  de/
    index.md
    kaffee.md
  en/
    index.md
    coffee.md

Andere Wege — Dateisuffixe, ein Frontmatter-Feld — stehen in Kapitel 2.

2. Plugin installieren

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

3. Eintragen

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

Ein Eintrag genügt. Das Plugin ist mehreres auf einmal — was, steht unter 1.3; die Konfiguration merkt davon nichts.

4. Ansehen

npx quartz build --serve

Der Umschalter steht oben rechts. Ein Klick führt von de/kaffee auf en/coffee — sofern die beiden verknüpft sind. Bei gleichen Basispfaden geschieht das von selbst; de/kaffee und en/coffee heißen aber verschieden, und dafür braucht es einen Hinweis im Frontmatter:

---
title: Kaffee
translationKey: kaffee
---

Dieselbe Zeile in en/coffee.md, und beide gehören zusammen. Kapitel 3 zeigt die drei Wege dorthin.

Wenn etwas nicht stimmt

Was zu sehen ist	Woran es liegt
Kein Umschalter	Nur eine Sprache konfiguriert — oder die Seite hat keine Übersetzung und switcher.missing: hide ist gesetzt.
Der Umschalter führt auf die Startseite	Die Seiten sind nicht verknüpft. Das ist der Normalfall bei missing: home.
Alle Seiten gelten als deutsch	detection findet nichts — Ordnernamen prüfen, oder defaultLanguage.
<html lang> stimmt nicht	locale im Spracheintrag fehlt; ohne ihn wird der code genommen.