From e49c67f8baeac0e074e5c7ac5ab870e76ea014c2 Mon Sep 17 00:00:00 2001
From: Patrick Kollitsch <davidsneighbourdev+gh@gmail.com>
Date: Thu, 19 Nov 2026 08:19:53 +0000
Subject: [PATCH] feat(layouts): restructure header navigation for hooks and class params
---
config/_default/params.toml | 16 +++++
layouts/_partials/site-navigation.html | 105 +++++++++++++++++++++++++++-------
2 files changed, 99 insertions(+), 22 deletions(-)
diff --git a/config/_default/params.toml b/config/_default/params.toml
index 9c0a4e0..2ccf0ad 100644
--- a/config/_default/params.toml
+++ b/config/_default/params.toml
@@ -6,6 +6,22 @@
[ananke.home]
content_alignment = "center" # options: left, center, right
+# Tachyons classes for the header navigation (layouts/_partials/site-navigation.html).
+# An empty value uses the theme default shown in the comment. A value replaces the
+# default classes of that element; its `ananke-nav-*` hook class always stays.
+[ananke.navigation.classes]
+nav = "" # <nav>: "pv3 ph3 ph4-ns"
+inner = "" # row inside <nav>: "flex flex-wrap items-center justify-between center"
+brand = "" # site title or logo link: "f3 fw2 hover-white white-90 dib no-underline"
+toggle = "" # menu button below the -l breakpoint: "f5 white-90 hover-white"
+panel = "" # collapsible panel with menu, languages, and social links: "flex-l items-center"
+menu = "" # main menu <ul>: "pl0 mr3" ("pr0 ml3" for right-to-left)
+item = "" # main menu <li>: "list f5 f4-ns fw4 dib pr3" ("pl3" for right-to-left)
+link = "" # main menu link: "hover-white white-90 no-underline"
+submenu_toggle = "" # submenu button: "hover-white white-90"
+submenu = "" # submenu <ul>: "list ma0 pv2 ph0 br2 ba b--white-20" plus background_color_class
+submenu_link = "" # submenu link: "db pv2 ph3 f5 white-90 hover-white hover-bg-white-10 no-underline"
+
[ananke.social]
icon_path = "ananke/socials/%s.svg"
diff --git a/layouts/_partials/site-navigation.html b/layouts/_partials/site-navigation.html
index ce515d8..451e53f 100644
--- a/layouts/_partials/site-navigation.html
+++ b/layouts/_partials/site-navigation.html
@@ -1,4 +1,48 @@
{{- /*
+ Site header navigation.
+
+ Every element has a stable `ananke-nav-*` or `ananke-submenu*` hook class
+ for custom CSS. The Tachyons classes next to it are defaults; replace them
+ per element with `[params.ananke.navigation.classes]`. Collapsing (below the
+ Tachyons `-l` breakpoint) and the dropdown position are in _styles.css.
+
+ Hooks: `navigation-start` renders after the brand link (for example a search
+ box), `navigation-end` renders at the end of the collapsible panel.
+
+ Without JavaScript, the menu and all submenus are visible and the toggle
+ buttons stay hidden. site-scripts.html enhances both.
+*/ -}}
+
+{{- /* Returns the classes for each navigation element: configured or default. */ -}}
+{{- define "_partials/AnankeNavigationClasses.html" -}}
+ {{- $rtl := compare.Eq site.Language.Direction "rtl" -}}
+ {{- $background := site.Params.background_color_class | compare.Default "bg-black" -}}
+ {{- $defaults := collections.Dictionary
+ "nav" "pv3 ph3 ph4-ns"
+ "inner" "flex flex-wrap items-center justify-between center"
+ "brand" "f3 fw2 hover-white white-90 dib no-underline"
+ "toggle" "f5 white-90 hover-white"
+ "panel" "flex-l items-center"
+ "menu" (compare.Conditional $rtl "pr0 ml3" "pl0 mr3")
+ "item" (printf "list f5 f4-ns fw4 dib %s" (compare.Conditional $rtl "pl3" "pr3"))
+ "link" "hover-white white-90 no-underline"
+ "submenu_toggle" "hover-white white-90"
+ "submenu" (printf "list ma0 pv2 ph0 br2 ba b--white-20 %s" $background)
+ "submenu_link" "db pv2 ph3 f5 white-90 hover-white hover-bg-white-10 no-underline"
+ -}}
+ {{- $configured := collections.Dictionary -}}
+ {{- with site.Params.ananke.navigation -}}
+ {{- with .classes -}}{{- $configured = . -}}{{- end -}}
+ {{- end -}}
+ {{- $classes := collections.Dictionary -}}
+ {{- range $key, $default := $defaults -}}
+ {{- $value := collections.Index $configured $key | compare.Default $default -}}
+ {{- $classes = collections.Merge $classes (collections.Dictionary $key $value) -}}
+ {{- end -}}
+ {{- return $classes -}}
+{{- end -}}
+
+{{- /*
Returns the aria-current value for a menu entry: "page" if it links to the
current page, "true" if the current page is below it (Hugo's HasMenuCurrent,
which includes pages inside the entry's section), or an empty string.
@@ -14,80 +58,97 @@
{{- end -}}
{{- define "_partials/AnankeSubmenuIcon.html" -}}
-<svg class="ananke-submenu-icon" aria-hidden="true" focusable="false" width="12" height="12" viewBox="0 0 12 12"><path d="M2 4.5l4 4 4-4" fill="none" stroke="currentColor" stroke-width="1.5"/></svg>
+<svg class="ananke-submenu-icon" aria-hidden="true" focusable="false" width="12" height="12" viewBox="0 0 12 12"><path d="M2 4.5l4 4 4-4" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/></svg>
+{{- end -}}
+
+{{- define "_partials/AnankeMenuToggleIcon.html" -}}
+<svg class="ananke-nav-toggle-icon" aria-hidden="true" focusable="false" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round"><path class="ananke-nav-toggle-line" d="M3 5h14"/><path class="ananke-nav-toggle-line" d="M3 10h14"/><path class="ananke-nav-toggle-line" d="M3 15h14"/></svg>
{{- end -}}
{{- define "_partials/AnankeSubmenu.html" -}}
{{- $page := .page }}
-<ul {{ with .id }}id="{{ . }}" class="ananke-submenu list pa0 ma0 {{ $page.Site.Params.background_color_class | compare.Default "bg-black" }}"{{ else }}class="ananke-submenu-nested list ma0"{{ end }}>
+{{- $classes := .classes }}
+<ul {{ with .id }}id="{{ . }}" class="ananke-submenu {{ $classes.submenu }}"{{ else }}class="ananke-submenu-nested list ma0 pa0"{{ end }}>
{{- range .entries }}
{{- $current := partials.Include "AnankeMenuCurrent.html" (dict "page" $page "entry" .) }}
<li class="ananke-submenu-item">
{{- if .URL }}
- <a class="hover-white white-90 no-underline" href="{{ .URL }}" title="{{ lang.Translate "pageTitle" . }}"{{ with $current }} aria-current="{{ . }}"{{ end }}>{{ .Name }}</a>
+ <a class="ananke-submenu-link {{ $classes.submenu_link }}" href="{{ .URL }}" title="{{ lang.Translate "pageTitle" . }}"{{ with $current }} aria-current="{{ . }}"{{ end }}>{{ .Name }}</a>
{{- else }}
- <span class="white-90">{{ .Name }}</span>
+ <span class="ananke-submenu-link {{ $classes.submenu_link }}">{{ .Name }}</span>
{{- end }}
{{- with .Children }}
- {{ partials.Include "AnankeSubmenu.html" (dict "page" $page "entries" .) }}
+ {{ partials.Include "AnankeSubmenu.html" (dict "page" $page "entries" . "classes" $classes) }}
{{- end }}
</li>
{{- end }}
</ul>
{{- end -}}
-<nav class="pv3 ph3 ph4-ns" role="navigation">
- <div class="flex-l center items-center justify-between">
- <a href="{{ .Site.Home.RelPermalink }}" class="f3 fw2 hover-white white-90 dib no-underline">
+{{- $classes := partials.Include "AnankeNavigationClasses.html" . -}}
+<nav class="ananke-nav {{ $classes.nav }}" role="navigation">
+ <div class="ananke-nav-inner {{ $classes.inner }}">
+ <a href="{{ .Site.Home.RelPermalink }}" class="ananke-nav-brand {{ $classes.brand }}">
{{ with .Site.Params.site_logo }}
<img src="{{ urls.RelURL . }}" class="w100 mw5-ns" alt="{{ $.Site.Title }}" />
{{ else }}
{{ .Site.Title }}
{{ end }}
</a>
- <div class="flex-l items-center">
+ {{- with partials.Include "hook.html" (dict "hook" "navigation-start" "context" .) | strings.TrimSpace }}
+ <div class="ananke-nav-slot">{{ . | safeHTML }}</div>
+ {{- end }}
+ {{- if .Site.Menus.main }}
+ <button type="button" class="ananke-nav-toggle {{ $classes.toggle }}" aria-expanded="false" aria-controls="ananke-nav-panel" hidden>
+ {{- partials.Include "AnankeMenuToggleIcon.html" -}}
+ <span class="ananke-nav-toggle-label">{{ lang.Translate "menuToggle" }}</span>
+ </button>
+ {{- end }}
+ <div id="ananke-nav-panel" class="ananke-nav-panel {{ $classes.panel }}">
{{ partials.Include "i18nlist.html" . }}
{{ if .Site.Menus.main }}
- <ul class="{{ compare.Conditional (compare.Eq $.Site.Language.Direction "rtl") "pr0 ml3" "pl0 mr3" }}">
+ <ul class="ananke-nav-menu {{ $classes.menu }}">
{{ range $index, $entry := .Site.Menus.main }}
{{- $current := partials.Include "AnankeMenuCurrent.html" (dict "page" $ "entry" $entry) -}}
{{- if not $entry.HasChildren }}
- <li class="list f5 f4-ns fw4 dib {{ compare.Conditional (compare.Eq $.Site.Language.Direction "rtl") "pl3" "pr3" }}">
- <a class="hover-white white-90 no-underline" href="{{ .URL }}" title="{{ lang.Translate "pageTitle" . }}"{{ with $current }} aria-current="{{ . }}"{{ end }}>
+ <li class="ananke-nav-item {{ $classes.item }}">
+ <a class="ananke-nav-link {{ $classes.link }}" href="{{ .URL }}" title="{{ lang.Translate "pageTitle" . }}"{{ with $current }} aria-current="{{ . }}"{{ end }}>
{{ .Name }}
</a>
</li>
{{- else }}
{{- /*
A parent entry with children. The child list is always in the
- markup, so it stays reachable without JavaScript. The toggle button
- is hidden until site-scripts.html reveals it and collapses the list.
- Entries below the second level render as nested lists inside the
- submenu, without their own toggle.
+ markup, so it stays reachable without JavaScript. Entries below the
+ second level render as nested lists inside the submenu, without
+ their own toggle.
*/}}
{{- $submenu_id := printf "ananke-submenu-%d" $index }}
- <li class="list f5 f4-ns fw4 dib {{ compare.Conditional (compare.Eq $.Site.Language.Direction "rtl") "pl3" "pr3" }} ananke-has-submenu">
+ <li class="ananke-nav-item ananke-has-submenu {{ $classes.item }}">
{{- if .URL }}
- <a class="hover-white white-90 no-underline" href="{{ .URL }}" title="{{ lang.Translate "pageTitle" . }}"{{ with $current }} aria-current="{{ . }}"{{ end }}>
+ <a class="ananke-nav-link {{ $classes.link }}" href="{{ .URL }}" title="{{ lang.Translate "pageTitle" . }}"{{ with $current }} aria-current="{{ . }}"{{ end }}>
{{ .Name }}
</a>
- <button type="button" class="ananke-submenu-toggle hover-white white-90" aria-expanded="false" aria-controls="{{ $submenu_id }}" hidden>
+ <button type="button" class="ananke-submenu-toggle {{ $classes.submenu_toggle }}" aria-expanded="false" aria-controls="{{ $submenu_id }}" hidden>
<span class="clip">{{ lang.Translate "submenuToggle" . | compare.Default .Name }}</span>
{{- partials.Include "AnankeSubmenuIcon.html" }}
</button>
{{- else }}
- <span class="white-90 ananke-submenu-label">{{ .Name }}</span>
- <button type="button" class="ananke-submenu-toggle hover-white white-90" aria-expanded="false" aria-controls="{{ $submenu_id }}"{{ with $current }} aria-current="{{ . }}"{{ end }} hidden>
+ <span class="ananke-submenu-label {{ $classes.link }}">{{ .Name }}</span>
+ <button type="button" class="ananke-submenu-toggle {{ $classes.submenu_toggle }}" aria-expanded="false" aria-controls="{{ $submenu_id }}"{{ with $current }} aria-current="{{ . }}"{{ end }} hidden>
{{ .Name }}
{{- partials.Include "AnankeSubmenuIcon.html" }}
</button>
{{- end }}
- {{ partials.Include "AnankeSubmenu.html" (dict "page" $ "entries" .Children "id" $submenu_id) }}
+ {{ partials.Include "AnankeSubmenu.html" (dict "page" $ "entries" .Children "id" $submenu_id "classes" $classes) }}
</li>
{{- end }}
{{ end }}
</ul>
{{ end }}
{{ partials.IncludeCached "social/follow.html" . }}
+ {{- with partials.Include "hook.html" (dict "hook" "navigation-end" "context" .) | strings.TrimSpace }}
+ <div class="ananke-nav-end">{{ . | safeHTML }}</div>
+ {{- end }}
</div>
</div>
</nav>
--
Gitblit v1.10.0