From 9c67aca368f68ab916ff61caa36e0de69c43dec3 Mon Sep 17 00:00:00 2001
From: Henk Verlinde <henk@ventizo.com>
Date: Fri, 5 Mar 2021 21:04:55 +0100
Subject: [PATCH] feat: add optional breadcrumb trail

---
 assets/scss/layouts/_pages.scss       |  5 +++++
 config/_default/params.toml           |  1 +
 layouts/docs/single.html              | 11 ++++++++++-
 layouts/partials/main/breadcrumb.html |  4 ++++
 4 files changed, 20 insertions(+), 1 deletion(-)
 create mode 100644 layouts/partials/main/breadcrumb.html

diff --git a/assets/scss/layouts/_pages.scss b/assets/scss/layouts/_pages.scss
index eaa75de75..8938dbc19 100644
--- a/assets/scss/layouts/_pages.scss
+++ b/assets/scss/layouts/_pages.scss
@@ -38,3 +38,8 @@ p.meta {
   margin-top: 0.5rem;
   font-size: $font-size-base;
 }
+
+.breadcrumb {
+  margin-top: 2.25rem;
+  font-size: $font-size-base;
+}
diff --git a/config/_default/params.toml b/config/_default/params.toml
index 159447efc..3fa4b6dd0 100644
--- a/config/_default/params.toml
+++ b/config/_default/params.toml
@@ -53,3 +53,4 @@ editPage = false
   flexSearch = true
   darkMode = true
   bootStrapJs = false
+  breadCrumb = false
diff --git a/layouts/docs/single.html b/layouts/docs/single.html
index f326d5053..54e581bf4 100644
--- a/layouts/docs/single.html
+++ b/layouts/docs/single.html
@@ -3,7 +3,7 @@
 		<div class="col-lg-5 col-xl-4 docs-sidebar">
 			<nav class="docs-links" aria-label="Main navigation">
 				{{ partial "sidebar/docs-menu.html" . }}
-			</nav>        
+			</nav>
 		</div>
 		{{ if ne .Params.toc false -}}
 		<nav class="docs-toc d-none d-xl-block col-xl-3" aria-label="Secondary navigation">
@@ -15,6 +15,15 @@
 		{{ else -}}
 		<main class="docs-content col-lg-11 col-xl-9 mx-xl-auto">
 		{{ end -}}
+			{{ if .Site.Params.options.breadCrumb -}}
+				<!-- https://discourse.gohugo.io/t/breadcrumb-navigation-for-highly-nested-content/27359/6 -->
+				<nav aria-label="breadcrumb">
+					<ol class="breadcrumb">
+						{{ partial "main/breadcrumb" . -}}
+						<li class="breadcrumb-item active" aria-current="page">{{ .Title }}</li>
+					</ol>
+				</nav>
+			{{ end }}
 			<h1>{{ .Title }}</h1>
 			<p class="lead">{{ .Params.lead | safeHTML }}</p>
 			{{ partial "main/headline-hash.html" .Content }}
diff --git a/layouts/partials/main/breadcrumb.html b/layouts/partials/main/breadcrumb.html
new file mode 100644
index 000000000..db3533e88
--- /dev/null
+++ b/layouts/partials/main/breadcrumb.html
@@ -0,0 +1,4 @@
+{{ with .Parent -}}
+  {{ partial "main/breadcrumb.html" . -}}
+  <li class="breadcrumb-item"><a href="{{ .Permalink }}">{{ if .IsHome }}Home{{ else }}{{ .Title }}{{ end }}</a></li>
+{{ end -}}
\ No newline at end of file