body direct children: <nav>, <header>, <article role="main">, <footer> - <nav>: site navigation (own landmark) - <header>: page identity — title, author, date, metadata - <article role="main">: content (screen reader gets landmark via role) - <footer>: site footer No <main> wrapper. Fewer tags, clearer signal. Header block defined per-layout (prose gets eyebrow/date, docs gets hgroup). Content block defined per-layout (docs adds sidebar <nav> + <aside> TOC).
92 lines
2.3 KiB
HTML
92 lines
2.3 KiB
HTML
{{ define "header" }}
|
|
<header>
|
|
{{- if .Description -}}
|
|
<hgroup>
|
|
<h1>{{ .Title }}</h1>
|
|
<p>{{ .Description }}</p>
|
|
</hgroup>
|
|
{{- else -}}
|
|
<h1>{{ .Title }}</h1>
|
|
{{- end }}
|
|
</header>
|
|
{{ end }}
|
|
|
|
{{ define "content" }}
|
|
{{/* Vault sidebar navigation */}}
|
|
<nav aria-label="Vault" data-nav="sidebar">
|
|
{{- $menuName := .Site.Params.vault_menu | default "vault" -}}
|
|
{{- $menu := index .Site.Menus $menuName -}}
|
|
{{- if $menu -}}
|
|
{{- range $menu -}}
|
|
{{- if .HasChildren -}}
|
|
<small>{{ .Name }}</small>
|
|
<ul>
|
|
{{- range .Children -}}
|
|
<li>
|
|
<a href="{{ .URL }}"
|
|
{{- if $.IsMenuCurrent $menuName . }} aria-current="page"{{ end -}}>
|
|
{{- .Name -}}
|
|
</a>
|
|
</li>
|
|
{{- end -}}
|
|
</ul>
|
|
{{- else -}}
|
|
<ul>
|
|
<li>
|
|
<a href="{{ .URL }}"
|
|
{{- if $.IsMenuCurrent $menuName . }} aria-current="page"{{ end -}}>
|
|
{{- .Name -}}
|
|
</a>
|
|
</li>
|
|
</ul>
|
|
{{- end -}}
|
|
{{- end -}}
|
|
{{- else -}}
|
|
{{- with .CurrentSection -}}
|
|
<small>{{ .Title }}</small>
|
|
<ul>
|
|
{{- range .RegularPages -}}
|
|
<li>
|
|
<a href="{{ .RelPermalink }}"
|
|
{{- if eq .RelPermalink $.RelPermalink }} aria-current="page"{{ end -}}>
|
|
{{- .LinkTitle -}}
|
|
</a>
|
|
</li>
|
|
{{- end -}}
|
|
</ul>
|
|
{{- end -}}
|
|
{{- end -}}
|
|
</nav>
|
|
|
|
<article role="main">
|
|
{{ .Content }}
|
|
|
|
{{- $prevURL := index .Params "prev-url" -}}
|
|
{{- $prevTitle := index .Params "prev-title" -}}
|
|
{{- $nextURL := index .Params "next-url" -}}
|
|
{{- $nextTitle := index .Params "next-title" -}}
|
|
{{- if or $prevURL $nextURL -}}
|
|
<footer data-role="prev-next">
|
|
{{- if $prevURL -}}
|
|
<a href="{{ $prevURL }}" rel="prev">
|
|
<small>← Previous</small>
|
|
<span>{{ $prevTitle }}</span>
|
|
</a>
|
|
{{- end -}}
|
|
{{- if and $nextURL $nextTitle -}}
|
|
<a href="{{ $nextURL }}" rel="next">
|
|
<small>Next →</small>
|
|
<span>{{ $nextTitle }}</span>
|
|
</a>
|
|
{{- end -}}
|
|
</footer>
|
|
{{- end -}}
|
|
</article>
|
|
|
|
{{- with .TableOfContents -}}
|
|
<aside data-toc>
|
|
<small>On this page</small>
|
|
{{ . }}
|
|
</aside>
|
|
{{- end -}}
|
|
{{ end }}
|