Add lead shortcode; make banner a full-bleed hero image

- lead: wraps content in a Bootstrap .lead paragraph (moved from the
  ctsmockup site, where {.lead} could not target a paragraph).
- banner: resolves src as a page/global resource or base-URL-aware
  link, and spans the full viewport width via symmetric
  calc(50% - 50vw) margins while page content stays in .container.
  Optional height crops via object-fit: cover. A banner that starts a
  page's content is pulled flush against the navbar.
- html { overflow-x: hidden } to absorb the 100vw scrollbar overhang.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

README.md

@@ -1,3 +1,46 @@
 # hugo_bootstrap_theme
 
 Simple Bootstrap-based theme for Hugo.
+
+
+## Shortcodes
+
+### `lead`
+
+Wraps its content in a Bootstrap `.lead` paragraph (the Markdown
+attribute syntax `{.lead}` cannot target a paragraph):
+
+```
+{{< lead >}}
+An introductory paragraph that stands out.
+{{< /lead >}}
+```
+
+Pass extra classes with `class`, e.g. `{{< lead class="mb-5" >}}`.
+
+### `banner`
+
+A full-bleed banner / hero image: it spans the entire viewport width
+while the rest of the page stays within `.container`. Put it on the
+first line of a page's content to get a hero flush against the navbar.
+
+```
+{{< banner src="hero.png" alt="…" >}}
+```
+
+`src` is resolved as a page resource first, then a global resource
+(`assets/`), then as a plain link respecting the site's base URL.
+Optional params: `title`, `height` (a CSS length such as `60vh`, which
+crops the image with `object-fit: cover`) and `class`.
+
+
+## Custom error page
+
+The theme has a custom 404 error page.
+
+If the site has an SVG image in `assets/svg/404.svg`,
+this image will be displayed instead of a generic 404
+code. Regardless of whether an SVG assets exists or not,
+English and German explanations of what's going on will
+be included on the page.
+

assets/scss/hugo_bootstrap_theme.scss

@@ -15,6 +15,12 @@
   --bs-body-line-height: 1.5;
 }
 
+// Keep the full-bleed `.banner` from adding a horizontal scrollbar
+// (100vw is wider than the viewport when a vertical scrollbar is shown).
+html {
+  overflow-x: hidden;
+}
+
 body {
   font-family: var(--bs-font-sans-serif);
   line-height: var(--bs-body-line-height);
@@ -61,8 +67,23 @@ h1, h2, h3, h4, h5 {
   }
 }
 
-// Images
+// Full-bleed banner / hero image: spans the viewport width while the
+// surrounding page content stays within `.container`. Works from inside
+// any centred `.container` because the horizontal margins cancel out the
+// container offset (50% of the parent - 50% of the viewport).
 .banner {
+  display: block;
+  width: 100vw;
+  max-width: 100vw;
+  margin-left: calc(50% - 50vw);
+  margin-right: calc(50% - 50vw);
   margin-bottom: 2rem;
 }
 
+// When the banner is the first thing in the page body, pull it flush
+// against the navbar by cancelling the layout's top padding (`py-5`).
+.content-body > .banner:first-child,
+.content-body > p:first-child > .banner:only-child {
+  margin-top: -3rem;
+}
+

layouts/404.html

@@ -0,0 +1,47 @@
+{{ define "main" }}
+<div class="container">
+  <div class="row">
+    <div class="col mt-5 mb-5">
+      {{ with resources.Get "svg/404.svg" }}
+        {{ .Content | safeHTML }}
+      {{ else }}
+        <h1 class="display-1 mx-auto text-center">
+          404
+        </h1>
+      {{ end }}
+    </div>
+  </div>
+  <div class="row">
+    <div class="col-lg-6">
+      <div class="alert alert-danger mb-5" lang="en">
+        <h4 class="alert-heading">
+          Page not found
+        </h4>
+        <p>
+          The page you were trying to navigate to was not found on this
+          server.
+        </p>
+        <hr />
+        <p class="mb-0">
+          <a href="{{ .Site.BaseURL }}" class="alert-link">Back to the home page.</a>
+        </p>
+      </div>
+    </div>
+    <div class="col-lg-6">
+      <div class="alert alert-danger" lang="de">
+        <h4 class="alert-heading">
+          Seite nicht gefunden
+        </h4>
+        <p>
+          Die angeforderte Seite existiert nicht auf diesem Server.
+        </p>
+        <hr />
+        <p class="mb-0">
+          <a href="{{ .Site.BaseURL }}" class="alert-link">Zurück zur Homepage.</a>
+        </p>
+      </div>
+    </div>
+  </div>
+</div>
+{{ end }}
+

layouts/_partials/footer.html

@@ -2,7 +2,7 @@
   <div class="container py-4">
     <div class="row">
       <div class="col-md-6">
-        <p>&copy; {{ now.Year }} {{ .Site.Title }}</p>
+        <p>&copy; {{ now.Year }} {{ or (or .Params.Author .Site.Params.Author) .Site.Title }}</p>
       </div>
       <div class="col-md-6 text-md-end">
         <p>

layouts/_partials/header.html

@@ -1,7 +1,9 @@
 <nav class="navbar navbar-expand-lg navbar-light bg-light sticky-top">
   <div class="container"> <!-- Changed from container-fluid to container -->
     <a class="navbar-brand fw-bold" href="{{ .Site.BaseURL }}">
-      <img src="/img/favicon.svg" alt="{{ .Site.Title }}" title="{{ .Site.Title }}">
+      {{- $logo := "img/favicon.svg" -}}
+      {{- if os.FileExists "static/img/logo.svg" -}}{{- $logo = "img/logo.svg" -}}{{- end -}}
+      <img src="{{ $logo | relURL }}" alt="{{ .Site.Title }}" title="{{ .Site.Title }}">
     </a>
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" 

layouts/_partials/human_file_size.html

@@ -0,0 +1,7 @@
+{{/* Call this with a resource's content e.g., partial "human_file_size" .Content */}}
+{{- $bytes := len . -}}
+{{- $kb := div $bytes 1024 -}}
+{{- $mb := div $kb 1024 -}}
+{{- if ge $mb 1 -}}{{- $mb -}} MB
+{{- else if ge $kb 1 -}}{{- $kb -}} KB
+{{- else -}}{{- $bytes -}} B{{- end -}}

layouts/_partials/meta.html

@@ -1,27 +1,26 @@
 <meta charset="UTF-8">
-<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>{{ if .IsHome }}{{ .Site.Title }}{{ else }}{{ .Title }} - {{ .Site.Title }}{{ end }}</title>
 <meta name="description" content="{{ .Page.Params.description }}">
-<meta name="author" content="{{ .Site.Params.author }}">
-<meta name="generator" content="{{ hugo.Environment }}">
+<meta name="author" content="{{ or .Page.Params.author .Site.Params.author }}">
+<meta name="generator" content="gohugo.io; {{ hugo.Environment }}">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
 <link rel="icon" type="image/png" href="/img/favicon.png">
 
-<title>{{ if .IsHome }}{{ .Site.Title }}{{ else }}{{ .Title }} - {{ .Site.Title }}{{ end }}</title>
-
 <!-- Compile SCSS to CSS -->
-{{ with resources.Get "scss/main.scss" }}
-    {{ $opts := dict
+{{- with resources.Get "scss/main.scss" -}}
+  {{- $opts := dict
     "enableSourceMap" (not hugo.IsProduction)
     "outputStyle" (cond hugo.IsProduction "compressed" "expanded")
     "targetPath" "css/main.css"
     "transpiler" "dartsass"
-    }}
-    {{ with . | toCSS $opts }}
-        {{ if hugo.IsProduction }}
-            {{ with . | fingerprint "sha512" }}
+  -}}
+  {{- with . | toCSS $opts -}}
+    {{- if hugo.IsProduction -}}
+      {{- with . | fingerprint "sha512" -}}
           <link rel="stylesheet" href="{{ .RelPermalink }}" integrity="{{ .Data.Integrity }}" crossorigin="anonymous">
-            {{ end }}
-        {{ else }}
+      {{- end -}}
+    {{- else -}}
       <link rel="stylesheet" href="{{ .RelPermalink }}">
-        {{ end }}
-    {{ end }}
-{{ end }}
+    {{- end -}}
+  {{- end -}}
+{{- end -}}

layouts/_partials/scripts_extra.html

@@ -0,0 +1,2 @@
+<!-- extra scripts may go here -->
+

layouts/_shortcodes/banner.html

@@ -1,4 +1,36 @@
-{{ $src := .Get "src" }}
-{{ $alt := .Get "alt" }}
-{{ $title := .Get "title" }}
-<img class="banner img-fluid" src="{{ $src }}" alt="{{ $alt }}" title="{{ $title }}" width="100%">
+{{- /*
+  Full-bleed banner / hero image.
+
+  The image spans the entire viewport width while the surrounding page
+  content stays within `.container` (see the `.banner` rules in
+  hugo_bootstrap_theme.scss). Place the shortcode as the first line of a
+  page's content to get a hero that sits flush against the navbar.
+
+  Params:
+    src     image path - resolved as a page resource first, then a global
+            resource (assets/), then treated as a link/URL respecting the
+            site's base URL
+    alt     alternative text (default: empty)
+    title   optional title attribute
+    height  optional CSS length (e.g. "60vh"); crops the image with
+            object-fit: cover
+    class   optional extra CSS classes
+*/ -}}
+{{- $src := .Get "src" -}}
+{{- $alt := or (.Get "alt") "" -}}
+{{- $title := .Get "title" -}}
+{{- $height := .Get "height" -}}
+{{- $class := .Get "class" -}}
+{{- $url := $src -}}
+{{- with $.Page.Resources.GetMatch $src -}}
+  {{- $url = .RelPermalink -}}
+{{- else -}}
+  {{- with resources.Get $src -}}
+    {{- $url = .RelPermalink -}}
+  {{- else -}}
+    {{- $url = $src | relURL -}}
+  {{- end -}}
+{{- end -}}
+<img class="banner{{ with $class }} {{ . }}{{ end }}" src="{{ $url }}" alt="{{ $alt }}"
+  {{- with $title }} title="{{ . }}"{{ end }}
+  {{- with $height }} style="height:{{ . }};object-fit:cover"{{ end }}>

layouts/_shortcodes/lead.html

@@ -0,0 +1,2 @@
+{{ $additional_classes := .Get "class" }}
+<p class="lead {{ $additional_classes }}">{{ .Inner | safeHTML }}</p>

layouts/baseof.html

@@ -3,6 +3,7 @@
 <head>
     {{- partial "meta.html" . -}}
     {{- partial "head_extra.html" . -}}
+    {{- block "extra_head" . }}{{ end }}
 </head>
 <body>
     {{- partial "header.html" . -}}