From 66d57ab8c6e08fc159f8fce979142cd917d5287b Mon Sep 17 00:00:00 2001 From: Kai Moritz Date: Sat, 20 Jun 2026 16:43:23 +0000 Subject: [PATCH] CLAUDE.md: juplo.de-spezifische Nav-Details durch allgemeines Vertragsmodell ersetzen MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit Die Beschreibung des Alias-Nav-Verhaltens verwies auf BlogNav.astro und Classic/None-Layouts — beides ist juplo.de-spezifisch. Ersetzt durch ein rendereragnostisches Vertragsmodell (was params.alias: true bedeutet und welches Verhalten empfohlen wird). Querverweis auf website/CLAUDE.md für die konkrete Implementierung. Co-Authored-By: Claude Sonnet 4.6 --- CLAUDE.md | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index cd98fa2..22f7ea3 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -50,10 +50,13 @@ Beide Dateien haben dieselbe `url` — Nav-Links an beiden Positionen zeigen als **Nav-Verhalten von Alias-Einträgen:** -Stubs erhalten `params.alias: true` im Frontmatter. Der Renderer (Astro: `BlogNav.astro`) wertet dieses Flag aus: -- Im Classic-Layout: `isCurrent` und `isAncestor` werden für Alias-Nodes in der `off`-Berechnung übersprungen. Dadurch ist der Alias verborgen, wenn die Seite aktiv ist (der kanonische Eintrag übernimmt die Darstellung). Sichtbar ist der Alias dagegen, wenn man eine Geschwisterseite betrachtet (normale `isSibling`-Logik greift). -- Im Layout "None" (kein CSS): Alle Einträge sind sichtbar. Alias-Einträge tragen einen Barrierefreiheits-Hinweis ` (Schnellzugriff)` nach dem Titel-Element — außerhalb von ``, also nie fett. Kanonische Einträge erhalten keinen Hinweis. Im Classic-Layout ist der Hinweis per CSS ausgeblendet (`#submenu .alias-hint { display: none }`). -- Der bestehende `off`-Mechanismus reicht für Classic; der alias-hint benötigt eine CSS-Regel im Renderer. +Stubs erhalten `params.alias: true` im Frontmatter. Dieses Flag signalisiert dem Renderer, dass es sich um einen Zusatzeintrag handelt — empfohlenes Verhalten: + +- `isCurrent`- und `isAncestor`-Logik für Alias-Nodes unterdrücken, sodass der Alias verborgen bleibt, wenn seine Seite aktiv ist (der kanonische Eintrag übernimmt die Darstellung). +- Den Alias sichtbar lassen, wenn eine Geschwisterseite betrachtet wird (normale Geschwister-Logik). +- Optional: Einen Barrierefreiheits-Hinweis im Markup ergänzen (z.B. als `` nach dem Titel), der Screen-Reader-Nutzenden signalisiert, dass dieser Eintrag ein Zusatzzugang zu einer auch anderswo gelisteten Seite ist. Im visuellen Layout per CSS ausblenden. + +Die konkrete Implementierung für juplo.de (Astro/`BlogNav.astro`, CSS-Klassen, Hint-Text) ist in der `CLAUDE.md` von `website/` dokumentiert. ## Maven-Site-Dokumentation neu generieren -- 2.39.5