]> juplo.de Git - maven-thymeleaf-skin/commitdiff
CLAUDE.md: juplo.de-spezifische Nav-Details durch allgemeines Vertragsmodell ersetzen
authorKai Moritz <kai.milan.moritz@googlemail.com>
Sat, 20 Jun 2026 16:43:23 +0000 (16:43 +0000)
committerKai Moritz <kai.milan.moritz@googlemail.com>
Sat, 20 Jun 2026 16:43:23 +0000 (16:43 +0000)
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 <noreply@anthropic.com>
CLAUDE.md

index cd98fa2cf0452e0f9be405c7086645cb306c4fd9..22f7ea3e3f5bdc22e616dfb6c8a25daeca2a549c 100644 (file)
--- 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 `<span class="alias-hint"> (Schnellzugriff)</span>` nach dem Titel-Element — außerhalb von `<strong>`, 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 `<span>` 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