diff --git a/layouts/partials/sidebar.html b/layouts/partials/sidebar.html new file mode 100644 index 00000000..04b4d074 --- /dev/null +++ b/layouts/partials/sidebar.html @@ -0,0 +1,321 @@ +{{- $context := .context -}} + +{{- $disableSidebar := .disableSidebar | default false -}} +{{- $displayPlaceholder := .displayPlaceholder | default false -}} + +{{- $navRoot := cond (eq site.Home.Type "docs") site.Home $context.FirstSection -}} +{{- $pageURL := $context.RelPermalink -}} + +{{- if .context.Params.sidebar.hide -}} + {{- $disableSidebar = true -}} + {{- $displayPlaceholder = false -}} +{{- end -}} + +{{- $sidebarClass := "hx:md:sticky" -}} +{{- if $disableSidebar -}} + {{- if $displayPlaceholder -}} + {{- $sidebarClass = "hx:md:hidden hx:xl:block" -}} + {{- else -}} + {{- $sidebarClass = "hx:md:hidden" -}} + {{- end -}} +{{- end -}} + + + +{{- define "sidebar-main" -}} + {{ template "sidebar-tree" (dict "context" .context "level" 0 "page" .page "pageURL" .pageURL "toc" (.toc | default false)) }} +{{- end -}} + +{{- define "sidebar-tree" -}} + {{- if ge .level 4 -}} + {{- return -}} + {{- end -}} + + {{- $context := .context -}} + {{- $page := .page }} + {{- $pageURL := .page.RelPermalink -}} + {{- $level := .level -}} + {{- $toc := .toc | default false -}} + {{- $useMainMenu := and (eq $level 0) $toc -}} + {{- $mainMenuEntries := slice -}} + + {{- $items := slice -}} + {{- if $useMainMenu -}} + {{- range $menuItem := site.Menus.main -}} + {{- $menuType := $menuItem.Params.type | default "" -}} + {{- $isIconOnly := and $menuItem.Params.icon (ne $menuType "link") -}} + {{- /* Keep only navigation links in the mobile sidebar. */ -}} + {{- if or (eq $menuType "search") (eq $menuType "theme-toggle") (eq $menuType "language-switch") $isIconOnly -}} + {{- continue -}} + {{- end -}} + + {{- $menuTitle := or (T $menuItem.Identifier) $menuItem.Name -}} + {{- /* Dropdown parents mirror navbar behavior: render a labeled group of child links. */ -}} + {{- if $menuItem.HasChildren -}} + {{- $childEntries := slice -}} + {{- range $childItem := $menuItem.Children -}} + {{- $childType := $childItem.Params.type | default "" -}} + {{- $childIsIconOnly := and $childItem.Params.icon (ne $childType "link") -}} + {{- if or (eq $childType "search") (eq $childType "theme-toggle") (eq $childType "language-switch") $childIsIconOnly -}} + {{- continue -}} + {{- end -}} + + {{- $childTitle := or (T $childItem.Identifier) $childItem.Name -}} + {{- with $childItem.Page -}} + {{- if ne .Params.sidebar.exclude true -}} + {{- $childEntries = $childEntries | append (dict "title" $childTitle "link" .RelPermalink) -}} + {{- end -}} + {{- continue -}} + {{- end -}} + + {{- $childLink := $childItem.URL -}} + {{- with $childItem.PageRef -}} + {{- if hasPrefix . "/" -}} + {{- $childLink = relLangURL (strings.TrimPrefix "/" .) -}} + {{- end -}} + {{- end -}} + {{- if $childLink -}} + {{- $childEntries = $childEntries | append (dict "title" $childTitle "link" $childLink) -}} + {{- end -}} + {{- end -}} + + {{- if gt (len $childEntries) 0 -}} + {{- $mainMenuEntries = $mainMenuEntries | append (dict "type" "group" "title" $menuTitle "children" $childEntries) -}} + {{- end -}} + {{- continue -}} + {{- end -}} + + {{- /* Normalize page-backed entries so we keep nested tree behavior. */ -}} + {{- with $menuItem.Page -}} + {{- if ne .Params.sidebar.exclude true -}} + {{- $mainMenuEntries = $mainMenuEntries | append (dict "type" "page" "item" . "title" $menuTitle) -}} + {{- end -}} + {{- continue -}} + {{- end -}} + + {{- $link := $menuItem.URL -}} + {{- with $menuItem.PageRef -}} + {{- if hasPrefix . "/" -}} + {{- $link = relLangURL (strings.TrimPrefix "/" .) -}} + {{- end -}} + {{- end -}} + {{- if $link -}} + {{- $mainMenuEntries = $mainMenuEntries | append (dict "type" "url" "link" $link "title" $menuTitle) -}} + {{- end -}} + {{- end -}} + + {{- /* Fall back to the docs tree when main only contains controls/icons. */ -}} + {{- if eq (len $mainMenuEntries) 0 -}} + {{- $useMainMenu = false -}} + {{- $items = where (union site.Home.RegularPages site.Home.Sections) "Params.sidebar.exclude" "!=" true -}} + {{- end -}} + {{- else -}} + {{- $items = where (union .context.RegularPages .context.Sections) "Params.sidebar.exclude" "!=" true -}} + {{- end -}} + + {{- $hasItems := gt (len $items) 0 -}} + {{- if $useMainMenu -}} + {{- $hasItems = gt (len $mainMenuEntries) 0 -}} + {{- end -}} + + {{- if $hasItems -}} + {{- if eq $level 0 -}} + {{- if $useMainMenu -}} + {{- /* Mixed list: page entries render trees; url entries render leaf links. */ -}} + {{- range $entry := $mainMenuEntries -}} + {{- if eq (index $entry "type") "page" -}} + {{- $item := index $entry "item" -}} + {{- if $item.Params.sidebar.separator -}} +