Merge pull request #671 from gethinode/validation

Improve argument validation and documentation

README.md

@@ -9,32 +9,32 @@
 
 <!-- Badges -->
 <p align="center">
-    <a href="https://gohugo.io" alt="Hugo website">
+    <a href="https://gohugo.io">
-        <img src="https://img.shields.io/badge/generator-hugo-brightgreen">
+        <img src="https://img.shields.io/badge/generator-hugo-brightgreen" alt="Hugo website">
     </a>
-    <a href="https://gethinode.com" alt="Hinode theme">
+    <a href="https://gethinode.com">
-        <img src="https://img.shields.io/badge/theme-hinode-blue">
+        <img src="https://img.shields.io/badge/theme-hinode-blue" alt="Hinode theme">
     </a>
-    <a href="https://www.npmjs.com/package/%40gethinode/hinode" alt="npm package">
+    <a href="https://www.npmjs.com/package/%40gethinode/hinode">
-        <img src="https://img.shields.io/npm/v/%40gethinode/hinode">
+        <img src="https://img.shields.io/npm/v/%40gethinode/hinode" alt="npm package">
     </a>
-    <a href="https://app.netlify.com/sites/gethinode-demo/deploys" alt="Netlify Status">
+    <a href="https://app.netlify.com/sites/gethinode-demo/deploys">
-        <img src="https://img.shields.io/netlify/0ad42e3e-fdfa-4d37-8e26-58badd429a67">
+        <img src="https://img.shields.io/netlify/0ad42e3e-fdfa-4d37-8e26-58badd429a67"  alt="Netlify Status">
     </a>
-    <a href="https://stats.uptimerobot.com/xyGVYhLJmV" alt="UptimeRobot Status">
+    <a href="https://stats.uptimerobot.com/xyGVYhLJmV">
-        <img src="https://img.shields.io/uptimerobot/status/m791334689-73d9dfc82030f4f955b2d6bb">
+        <img src="https://img.shields.io/uptimerobot/status/m791334689-73d9dfc82030f4f955b2d6bb" alt="UptimeRobot Status">
     </a>
-    <a href="https://github.com/gethinode/hinode/commits/main" alt="Last commit">
+    <a href="https://github.com/gethinode/hinode/commits/main">
-        <img src="https://img.shields.io/github/last-commit/gethinode/hinode.svg">
+        <img src="https://img.shields.io/github/last-commit/gethinode/hinode.svg" alt="Last commit">
     </a>
-    <a href="https://github.com/gethinode/hinode/issues" alt="Issues">
+    <a href="https://github.com/gethinode/hinode/issues">
-        <img src="https://img.shields.io/github/issues/gethinode/hinode.svg">
+        <img src="https://img.shields.io/github/issues/gethinode/hinode.svg" alt="Issues">
     </a>
-    <a href="https://github.com/gethinode/hinode/pulls" alt="Pulls">
+    <a href="https://github.com/gethinode/hinode/pulls">
-        <img src="https://img.shields.io/github/issues-pr-raw/gethinode/hinode.svg">
+        <img src="https://img.shields.io/github/issues-pr-raw/gethinode/hinode.svg" alt="Pulls">
     </a>
-    <a href="https://github.com/gethinode/hinode/blob/main/LICENSE" alt="License">
+    <a href="https://github.com/gethinode/hinode/blob/main/LICENSE">
-        <img src="https://img.shields.io/github/license/gethinode/hinode">
+        <img src="https://img.shields.io/github/license/gethinode/hinode" alt="License">
     </a>
 </p>
 

assets/js/analytics.js

@@ -11,8 +11,8 @@
 {{- end -}}
 
 {{- $pc := .Site.Config.Privacy.GoogleAnalytics -}}
-{{- if (and (not .Site.IsServer) (not $pc.Disable)) -}}
+{{- if (and (not hugo.IsServer) (not $pc.Disable)) -}}
-    {{ with .Site.GoogleAnalytics -}}
+    {{ with .Site.Config.Services.GoogleAnalytics.ID -}}
         {{ if hasPrefix . "G-"}}
             {{ template "__ga_js_set_doNotTrack" $ }}
 

assets/scss/app-dart.scss

@@ -5,6 +5,7 @@
 
 // Include default variable overrides
 @import "common/variables-dart.scss"; // note: modified for dart-sass
+@import "theme/variables.scss";
 @import "common/icons.scss";
 
 // Import Bootstrap configuration (mounted by core Bootstrap module)
@@ -26,6 +27,7 @@
 @import "components/comments.scss";
 @import "components/feature.scss";
 @import "components/footer.scss";
+@import "components/nav.scss";
 @import "components/navbar.scss";
 @import "components/img.scss";
 @import "components/pagination.scss";
@@ -36,7 +38,7 @@
 @import "components/table.scss";
 @import "components/timeline.scss";
 @import "components/toc.scss";
-@import "components/vimeo.scss";
+@import "components/video.scss";
 @import "common/animation.scss";
 @import "common/styles.scss";
 @import "layouts/reboot.scss";

assets/scss/app.scss

@@ -3,6 +3,7 @@
 
 // Include default variable overrides
 @import "common/variables.scss";
+@import "theme/variables.scss";
 @import "common/icons.scss";
 
 // Import Bootstrap configuration (mounted by core Bootstrap module)
@@ -24,6 +25,7 @@
 @import "components/comments.scss";
 @import "components/feature.scss";
 @import "components/footer.scss";
+@import "components/nav.scss";
 @import "components/navbar.scss";
 @import "components/img.scss";
 @import "components/pagination.scss";
@@ -34,7 +36,7 @@
 @import "components/table.scss";
 @import "components/timeline.scss";
 @import "components/toc.scss";
-@import "components/vimeo.scss";
+@import "components/video.scss";
 @import "common/animation.scss";
 @import "common/styles.scss";
 @import "layouts/reboot.scss";

assets/scss/common/_variables-dart.scss

@@ -40,4 +40,8 @@ $primary-text-emphasis-dark:        mix(white, h.$primary, h.$dark-mode-tint) !d
 $secondary-text-emphasis-dark:      mix(white, h.$secondary, h.$dark-mode-tint) !default;
 $link-color-dark:                   mix(white, h.$primary, h.$dark-mode-tint) !default;
 $primary-bg-subtle-dark:            mix(black, h.$primary, h.$dark-mode-shade) !default;
-$primary-border-subtle-dark:        mix(black, h.$primary, calc(h.$dark-mode-shade / 2)) !default;
+$primary-border-subtle-dark:        mix(black, h.$primary, calc(h.$dark-mode-shade / 2)) !default;
+
+$dropdown-transition: opacity .15s ease-in-out !default;
+$dropdown-horizontal-margin-top: calc((-1.5 * 1rem) - 2px);
+$dropdown-horizontal-padding-y: calc(1rem + 2px);

assets/scss/common/_variables.scss

@@ -33,4 +33,10 @@ $secondary-text-emphasis-dark:      mix(white, $secondary, $dark-mode-tint) !def
 $link-color-dark:                   mix(white, $primary, $dark-mode-tint) !default;
 $primary-bg-subtle-dark:            mix(black, $primary, $dark-mode-shade) !default;
 $primary-border-subtle-dark:        mix(black, $primary, $dark-mode-shade / 2) !default;
-// scss-docs-end color-mode
+// scss-docs-end color-mode
+
+// scss-docs-start horizontal-nav
+$dropdown-transition: opacity .15s ease-in-out !default;
+$dropdown-horizontal-margin-top: calc((-1.5 * 1rem) - 2px);
+$dropdown-horizontal-padding-y: calc(1rem + 2px);
+// scss-docs-end horizontal-nav

assets/scss/components/_img.scss

@@ -14,3 +14,8 @@
     height: 100%;
     object-fit: cover;
 }
+
+.mirrorred {
+    -webkit-transform: scaleX(-1);
+    transform: scaleX(-1);
+}

assets/scss/components/_nav.scss

@@ -0,0 +1,103 @@
+.nav-tabs > .nav-link.active {
+    border-bottom-color: var(--bs-body-bg) !important;
+    border-bottom-style: solid !important;
+    z-index: 1;
+}
+
+.nav-callout {
+    --#{$prefix}nav-callout-bg: var(--#{$prefix}light);
+    --#{$prefix}nav-callout-active-bg: var(--bs-primary-bg-subtle);
+    --#{$prefix}nav-callout-gap: #{$nav-underline-gap};
+    
+    column-gap: var(--#{$prefix}nav-callout-gap) !important;
+}
+
+.nav-callout > .tab-content {
+    background-color: var(--#{$prefix}nav-callout-bg);
+    padding: 2 * $spacer;
+    margin-top: 0 !important;
+}
+
+.nav-callout > .nav-link {
+    display: flex;
+    text-align: start;
+    vertical-align: text-top;
+    border-radius: 0;
+    padding: 0 0 (4 * $spacer) 0;
+    border-bottom: none;
+}
+
+.nav-callout > .nav-link.active {
+    background-image: linear-gradient(to top right, var(--#{$prefix}nav-callout-bg) 50%, transparent 0);
+    background-size: 50% (3 * $spacer);
+    background-repeat: no-repeat;
+    background-position: 50% bottom;
+    font-weight: 600;
+    color: var(--bs-nav-underline-link-active-color);
+}
+
+.nav-callout .accordion-button {
+    background-color: var(--#{$prefix}nav-callout-bg) !important;
+    border: solid;
+    border-color: var(--#{$prefix}border-color);
+    border-radius: var(--#{$prefix}accordion-inner-border-radius) !important;
+    margin-bottom: 0;
+
+    &:focus {
+        border-bottom: none !important;
+        box-shadow: none;
+    }
+
+    &:not(.collapsed) {
+        box-shadow: none;
+    }
+}
+
+.nav-callout > .accordion-item {
+    margin-top: 2 * $spacer;
+    margin-bottom: 2 * $spacer;
+    border: none;
+}
+
+.nav-callout .accordion-button[aria-expanded="false"] {
+    border-bottom: solid !important;
+    border-color: var(--#{$prefix}border-color) !important;
+    border-radius: var(--#{$prefix}accordion-inner-border-radius);
+}
+
+.nav-callout .accordion-button[aria-expanded="true"] {
+    border-color: var(--#{$prefix}border-color) !important;
+    border-bottom: none !important;
+    border-radius: var(--#{$prefix}accordion-inner-border-radius) var(--#{$prefix}accordion-inner-border-radius) 0 0 !important;
+    padding-bottom: 3 * $spacer;
+    background-image: linear-gradient(to top right, var(--#{$prefix}nav-callout-active-bg) 50%, transparent 0);
+    background-size: 10% (2.5 * $spacer);
+    background-repeat: no-repeat;
+    background-position: 10% bottom;
+}
+
+.nav-callout .accordion-collapse {
+    background-color: var(--#{$prefix}nav-callout-active-bg) !important;
+    border-radius: 0 0 var(--#{$prefix}accordion-inner-border-radius) var(--#{$prefix}accordion-inner-border-radius);
+    border-top: none !important;
+    border-left: solid;
+    border-right: solid;
+    border-bottom: solid;
+    border-color: var(--#{$prefix}border-color);
+}
+
+@if $enable-dark-mode {
+    @include color-mode(dark) {
+        .nav-callout {
+            --#{$prefix}nav-callout-bg: var(--#{$prefix}tertiary-bg);
+        }
+
+        .nav-callout .accordion-button[aria-expanded="true"] {
+            background-image: linear-gradient(to top right, shade-color($primary, 70%) 50%, transparent 0);
+        }
+
+        .nav-callout .accordion-collapse {
+            background-color: shade-color($primary, 70%) !important;
+        }
+    }
+}

assets/scss/components/_navbar.scss

@@ -119,3 +119,73 @@
 }
 
 // stylelint-enable annotation-no-unknown
+
+:root {
+    --dropdown-horizontal-bg: var(--#{$prefix}light);
+}
+
+@if $enable-dark-mode {
+    @include color-mode(dark) {
+        --dropdown-horizontal-bg: var(--#{$prefix}tertiary-bg);
+    }
+}
+
+.dropdown-horizontal {
+    @each $breakpoint in map-keys($grid-breakpoints) {
+        $next: breakpoint-next($breakpoint, $grid-breakpoints);
+        $infix: breakpoint-infix($next, $grid-breakpoints);
+
+        @include media-breakpoint-up($next) {
+            &#{$infix} { 
+                position: static !important; 
+            } 
+    
+            &#{$infix} > .dropdown-menu {
+                opacity: 0;
+                display: block;
+                visibility: hidden;
+                background-color: var(--dropdown-horizontal-bg) if($enable-important-utilities, !important, null);
+                width: 100%;
+                height: auto;
+                text-align: center;
+                border-radius: 0;
+                border: 0;
+                margin-top: $dropdown-horizontal-margin-top;
+                padding-top: $dropdown-horizontal-padding-y;
+                padding-bottom: $dropdown-horizontal-padding-y;
+                box-shadow: 0.125rem 0.25rem rgba(0, 0, 0, .075);
+            
+                @include transition($dropdown-transition);
+            }
+    
+            &#{$infix} > .dropdown-menu.show {
+                visibility: visible;
+                opacity: 1;
+            }
+    
+            &#{$infix} > .dropdown-menu > li {
+                display: inline-block;
+                padding-left: $spacer;
+                padding-right: $spacer;
+            }
+    
+            &#{$infix} > .dropdown-menu > li > a {
+                padding-left: .25 * $spacer;
+                padding-right: .25 * $spacer;
+
+                &.active,
+                &:hover,
+                &:focus {
+                    color: var(--bs-body-color);
+                    border-bottom: solid 1px var(--bs-navbar-hover-color);
+                    margin-bottom: -1px;
+                    background-color: transparent;
+                }
+            }
+            
+            &#{$infix} > .nav-link.show {
+                background-color: var(--dropdown-horizontal-bg) if($enable-important-utilities, !important, null);
+            }            
+        }
+    }
+}

assets/scss/components/_toc.scss

@@ -93,4 +93,8 @@
             }
         }
     }
-}
+}
+
+.section-menu > .nav-link.active, .section-menu > .nav-link:hover {
+    color: var(--bs-primary);
+}

assets/scss/components/_video.scss

@@ -1,3 +1,19 @@
+.youtube-embedded {
+    position: relative;
+    padding-bottom: 56.25%;
+    height: 0;
+    overflow: hidden;
+}
+
+.youtube-embedded > iframe {
+    position: absolute;
+    top: 0;
+    left: 0;
+    width: 100%;
+    height: 100%;
+    border:0;
+}
+
 // Adapted from https://github.com/gohugoio/hugo/tpl/tplimpl/embedded/templates/shortcodes/vimeo_simple.html
 .__h_video {
     position: relative;

assets/scss/theme/_variables.scss

@@ -0,0 +1,2 @@
+// Placeholder to quickly add your own theme variable overrides
+// The file is included at the beginning of the build pipeline

config/_default/hugo.toml

@@ -6,7 +6,6 @@ enableGitInfo = true
 # toml-docs-end main
 
 # additional settings
-# googleAnalytics = "G-xxxxxxxxxx"
 baseURL = "https://example.com/"
 canonifyURLs = false
 enableEmoji = true
@@ -73,6 +72,8 @@ home = ["HTML", "RSS", "REDIR"]
     disableInlineCSS = true
   [services.twitter]
     disableInlineCSS = true
+  [services.googleAnalytics]
+    # ID = "G-xxxxxxxxxx"
 
 [outputFormats]
   [outputFormats.XML]
@@ -83,10 +84,16 @@ home = ["HTML", "RSS", "REDIR"]
     permalinkable = false
     name = "xml"
 
+[minify]
+  [minify.tdewolff.js]
+    keepVarNames = true
+    precision = 0
+    version = 2022
+
 [module]
   [module.hugoVersion]
     extended = true
-    min = "0.110.0"
+    min = "0.120.0"
     max = ""
   [[module.mounts]]
     source = "archetypes"
@@ -97,6 +104,9 @@ home = ["HTML", "RSS", "REDIR"]
   [[module.mounts]]
     source = "content"
     target = "content"
+  [[module.mounts]]
+    source = "data"
+    target = "data"
   [[module.mounts]]
     source = "i18n"
     target = "i18n"

config/_default/params.toml

@@ -7,6 +7,8 @@
     canonifyAssetsURLs = false
     endorse = true
     footerBelowFold = false
+    loading = "lazy"
+    breakpoint = "md"
     [main.externalLinks]
         cue = false
         tab = false
@@ -61,6 +63,7 @@
     logo = "/img/logo_icon.svg"
     color = "body"
     fixed = true
+    horizontal = false
     offset = "5.5rem"
     search = true
     searchModal = false

config/postcss.config.js

@@ -14,6 +14,7 @@ const purgecss = require('@fullhuman/postcss-purgecss')({
     ...whitelister([
       './assets/scss/components/_clipboard.scss',
       './assets/scss/components/_command.scss',
+      './assets/scss/components/_nav.scss',
       './assets/scss/components/_navbar.scss',
       './assets/scss/components/_search.scss',
       './assets/scss/components/_syntax.scss',
@@ -27,6 +28,7 @@ const purgecss = require('@fullhuman/postcss-purgecss')({
       './_vendor/github.com/gethinode/mod-leaflet/dist/leaflet.scss',
       './_vendor/github.com/twbs/bootstrap/scss/_carousel.scss',
       './_vendor/github.com/twbs/bootstrap/scss/_dropdown.scss',
+      './_vendor/github.com/twbs/bootstrap/scss/_modal.scss',
       './_vendor/github.com/twbs/bootstrap/scss/_reboot.scss',
       './_vendor/github.com/twbs/bootstrap/scss/_tooltip.scss',
       './_vendor/github.com/twbs/bootstrap/scss/_transitions.scss',

data/structures/card.yml

@@ -0,0 +1,174 @@
+comment: >-
+  Displays a Bootstrap card. Either specify a valid path, or set the arguments
+  title, href, header, description, and thumbnail individually. The latter
+  arguments override any page attributes.
+arguments:
+    title:
+      type: string
+      optional: true
+      comment: >-
+        Title of the card.
+    path:
+      type: path
+      optional: true
+      comment: >-
+        Path of the page, override with other parameters.
+    href:
+      type: url
+      optional: true
+      comment: >-
+        Address for the button or hyperlink.
+      group: partial
+    class:
+      type: string
+      optional: true
+      parent: merge
+      comment: >-
+        Class attribute of the card element, e.g. “w-50”.
+    color:
+      type: select
+      optional: true
+      parent: cascade
+      comment: >-
+        Theme color of the card. By default, no color is specified.
+      options:
+        values:
+          - primary
+          - secondary
+          - success
+          - danger
+          - warning
+          - info
+          - light
+          - dark
+          - white
+          - black
+          - body
+          - body-tertiary
+    padding:
+      type: select
+      optional: true
+      default: auto
+      parent: cascade
+      comment: >-
+        Padding of the content.
+      options:
+        values:
+          - "0"
+          - "1"
+          - "2"
+          - "3"
+          - "4"
+          - "5"
+          - "auto"
+    gutter:
+      type: select
+      optional: true
+      default: "0"
+      parent: cascade
+      comment: >-
+        Gutter between columns in a group.
+      options:
+        values:
+          - "0"
+          - "1"
+          - "2"
+          - "3"
+          - "4"
+          - "5"
+    header:
+      type: select
+      optional: true
+      default: full
+      parent: cascade
+      comment: >-
+        Header components of the card, displayed in small caps. 
+      options:
+        values:
+          - full
+          - publication
+          - tags
+          - none
+    footer:
+      type: select
+      optional: true
+      default: none
+      parent: cascade
+      comment: >-
+        Footer components of the card, displayed in small caps.
+      options:
+        values:
+          - full
+          - publication
+          - tags
+          - none
+    description:
+      type:
+        - string
+        - template.HTML
+      optional: true
+      comment: >-
+        Description of the card.
+      group: partial
+    loading:
+      type: select
+      optional: true
+      default: eager
+      comment: >-
+        Loading behavior of the image. The loading of lazily loaded images is
+        deferred until the image is within scrolling range of the viewport. This
+        should reduce the initial loading time of the website. It is recommended
+        to lazily load only those images that are below the page fold.
+      options:
+        values:
+          - lazy
+          - eager
+      group: partial
+    thumbnail:
+      type: path
+      optional: true
+      comment: >-
+        Thumbnail image url, displayed on top or the left of the card.
+    ratio:
+      type: select
+      optional: true
+      comment: >-
+        Ratio of the thumbnail image, defaults to "16x9" (stacked orientation)
+        or "1x1" (horizontal orientation).
+      options:
+        values:
+          - 1x1
+          - 3x2
+          - 4x3
+          - 16x9
+          - 21x9
+      group: partial
+    alt:
+      type: string
+      optional: true
+      release: v0.19.0
+      comment: >-
+        Alternate text for the thumbnail, uses "title" by default.
+    icon:
+      type: string
+      optional: true
+      comment: >-
+        Font Awesome icon, displayed on top or the left of the card.
+    orientation:
+      type: select
+      optional: true
+      default: stacked
+      parent: cascade
+      comment: >-
+        Placement of the thumbnail or icon.
+      options:
+        values:
+          - stacked
+          - horizontal
+          - horizontal-sm
+          - none
+body:
+  optional: true
+  comment: >-
+    Description of the card.
+  group: shortcode

exampleSite/config/_default/hugo.toml

@@ -5,7 +5,6 @@ paginate = 9
 enableGitInfo = true
 
 # additional settings
-googleAnalytics = "G-T85PPZ36GN"
 baseURL = "https://demo.gethinode.com/"
 canonifyURLs = false
 enableEmoji = true
@@ -63,6 +62,8 @@ home = ["HTML", "RSS", "REDIR"]
     disableInlineCSS = true
   [services.twitter]
     disableInlineCSS = true
+  [services.googleAnalytics]
+    ID = "G-T85PPZ36GN"
 
 [outputFormats]
   [outputFormats.XML]
@@ -73,6 +74,12 @@ home = ["HTML", "RSS", "REDIR"]
     permalinkable = false
     name = "xml"
 
+[minify]
+  [minify.tdewolff.js]
+    keepVarNames = true
+    precision = 0
+    version = 2022
+
 [module]
   replacements = 'github.com/gethinode/hinode -> ../..'
   [[module.imports]]

exampleSite/config/_default/params.toml

@@ -5,6 +5,8 @@
     modes = ["light", "dark"]
     canonifyAssetsURLs = false
     footerBelowFold = false
+    loading = "lazy"
+    breakpoint = "md"
     [main.externalLinks]
         cue = true
         tab = true
@@ -16,6 +18,8 @@
     optional = ["leaflet", "katex", "lottie"]
     excludeSCSS = ["bootstrap"]
     disableTemplate = ["katex"]
+    [modules.katex]
+        state = "defer"
     [modules.fontawesome]
         inline = true
         debug = true
@@ -48,6 +52,7 @@
     logo = "/img/logo_icon.svg"
     color = "body"
     fixed = true
+    horizontal = false
     offset = "5.5rem"
     search = true
     searchModal = false

exampleSite/config/postcss.config.js

@@ -14,6 +14,7 @@ const purgecss = require('@fullhuman/postcss-purgecss')({
     ...whitelister([
       './assets/scss/components/_clipboard.scss',
       './assets/scss/components/_command.scss',
+      './assets/scss/components/_nav.scss',
       './assets/scss/components/_navbar.scss',
       './assets/scss/components/_search.scss',
       './assets/scss/components/_syntax.scss',
@@ -27,6 +28,7 @@ const purgecss = require('@fullhuman/postcss-purgecss')({
       './_vendor/github.com/gethinode/mod-leaflet/dist/leaflet.scss',
       './_vendor/github.com/twbs/bootstrap/scss/_carousel.scss',
       './_vendor/github.com/twbs/bootstrap/scss/_dropdown.scss',
+      './_vendor/github.com/twbs/bootstrap/scss/_modal.scss',
       './_vendor/github.com/twbs/bootstrap/scss/_reboot.scss',
       './_vendor/github.com/twbs/bootstrap/scss/_tooltip.scss',
       './_vendor/github.com/twbs/bootstrap/scss/_transitions.scss',

exampleSite/content/en/blog/fourth-post.md

@@ -1,9 +1,10 @@
 ---
 author: Mark Dumay
-title: Fourth post
+title: Fourth post (excluded from search)
 date: 2023-01-01
-description: This is my fourth blog post.
+description: This is my fourth blog post. It is excluded from the search index.
 tags: ["blog"]
+searchExclude: true
 thumbnail:
   url: img/flowers.jpg
   author: Arvee Marie

exampleSite/go.sum

@@ -4,6 +4,8 @@ github.com/gethinode/mod-bootstrap v1.2.0 h1:JkTcImU3qpi25WgKvUxUYiMoiXtrxrG+Wf/
 github.com/gethinode/mod-bootstrap v1.2.0/go.mod h1:DcpPc2cNaXUPGEvhD7npuEEPA7573NvakTlrwFbyjr8=
 github.com/gethinode/mod-bootstrap v1.2.1 h1:z54dgsbhShhlri+X77Z+yLrg0wz/f8C8ojA/wnlhsJc=
 github.com/gethinode/mod-bootstrap v1.2.1/go.mod h1:DcpPc2cNaXUPGEvhD7npuEEPA7573NvakTlrwFbyjr8=
+github.com/gethinode/mod-bootstrap v1.2.2 h1:Q8E04OKWr9owk7nhQ/NBukUgSFhsECxZsOLEaf5oeiQ=
+github.com/gethinode/mod-bootstrap v1.2.2/go.mod h1:DcpPc2cNaXUPGEvhD7npuEEPA7573NvakTlrwFbyjr8=
 github.com/gethinode/mod-flexsearch v1.2.0 h1:SSMpWzK9SMbi9QRYfil9PJZLLWWLHWzlTc69UxtSWAA=
 github.com/gethinode/mod-flexsearch v1.2.0/go.mod h1:TXbGbWsvmhBdsTzRt887mcpFfr4ORpzG3+h/l4W3YM4=
 github.com/gethinode/mod-flexsearch v1.3.0 h1:RbfEDw219Y1rOVp9lHmy5ePdF9lyPalDu2J5oVeejrU=
@@ -14,6 +16,12 @@ github.com/gethinode/mod-flexsearch v1.4.1 h1:z+GKvhJ4v6BsZsWVZRgbO9WcmSZEVUkb3Q
 github.com/gethinode/mod-flexsearch v1.4.1/go.mod h1:TXbGbWsvmhBdsTzRt887mcpFfr4ORpzG3+h/l4W3YM4=
 github.com/gethinode/mod-flexsearch v1.5.1 h1:9fYlnHgiEXckL0EoC0zlSNO7BWZf5yiOroSWT13Kphc=
 github.com/gethinode/mod-flexsearch v1.5.1/go.mod h1:TXbGbWsvmhBdsTzRt887mcpFfr4ORpzG3+h/l4W3YM4=
+github.com/gethinode/mod-flexsearch v1.6.0 h1:Rjx+GLOByFLmaWD9hZXwmuKN8A89te6BZAIq2c9QBKg=
+github.com/gethinode/mod-flexsearch v1.6.0/go.mod h1:TXbGbWsvmhBdsTzRt887mcpFfr4ORpzG3+h/l4W3YM4=
+github.com/gethinode/mod-flexsearch v1.7.0 h1:VFTf6iUyT9b47jTDAxh8nVHU1eUBrdxlykaC90lTfqk=
+github.com/gethinode/mod-flexsearch v1.7.0/go.mod h1:TXbGbWsvmhBdsTzRt887mcpFfr4ORpzG3+h/l4W3YM4=
+github.com/gethinode/mod-flexsearch v1.7.1 h1:f4rjKkhleDVzqwUmwP1xZdhjru5VQ9g0MRDz0G6oLyY=
+github.com/gethinode/mod-flexsearch v1.7.1/go.mod h1:TXbGbWsvmhBdsTzRt887mcpFfr4ORpzG3+h/l4W3YM4=
 github.com/gethinode/mod-fontawesome v1.2.4 h1:SqE3CQ+boaBIhrVh3MPu4nz0uoHPfEH5t60nNY1CfsI=
 github.com/gethinode/mod-fontawesome v1.2.4/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
 github.com/gethinode/mod-fontawesome v1.2.5 h1:RqkLRj6+s+gM4nKd0IwNMMDA8cRmxfp0fxkVH4FdAGU=
@@ -28,6 +36,12 @@ github.com/gethinode/mod-fontawesome v1.4.0 h1:JfmVYwQl19jmZxgxY64yvGqJAAEiFkKf2
 github.com/gethinode/mod-fontawesome v1.4.0/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
 github.com/gethinode/mod-fontawesome v1.5.0 h1:3mW5dnWauuF9wSWXNIY+PPgTNPlc/xQOQoG7XGic1Yk=
 github.com/gethinode/mod-fontawesome v1.5.0/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
+github.com/gethinode/mod-fontawesome v1.5.1 h1:C7goQY4HrEua/lpjC++laydNKBuYo1+307ngn5tyXeM=
+github.com/gethinode/mod-fontawesome v1.5.1/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
+github.com/gethinode/mod-fontawesome v1.6.1 h1:iqOgDGdw7Bs4hnzjF/8JsUn10omyKQZTglLqNenT1K0=
+github.com/gethinode/mod-fontawesome v1.6.1/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
+github.com/gethinode/mod-fontawesome v1.7.3 h1:YzRCYSasVRIcImVmTJYjqNJ+KmyNWfm/bMgtM0slvzs=
+github.com/gethinode/mod-fontawesome v1.7.3/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
 github.com/gethinode/mod-katex v1.0.1/go.mod h1:byAfpI3wuqNJIooTGVEGc1cjBhhCy4+CcK1H6495MYg=
 github.com/gethinode/mod-katex v1.0.2 h1:pIG4n3qLl/IVe7BEiwn+GL8r5lOCtF6FDxlcrPKdAXk=
 github.com/gethinode/mod-katex v1.0.2/go.mod h1:byAfpI3wuqNJIooTGVEGc1cjBhhCy4+CcK1H6495MYg=
@@ -35,6 +49,8 @@ github.com/gethinode/mod-katex v1.0.3 h1:fvlUWqcUQqv2zRNM2kfmJ6GhXA816Tl1nfVrUkm
 github.com/gethinode/mod-katex v1.0.3/go.mod h1:byAfpI3wuqNJIooTGVEGc1cjBhhCy4+CcK1H6495MYg=
 github.com/gethinode/mod-katex v1.0.4 h1:NozgWPFnHhx1W+E9DnwMTRpvxPbdqdANEtwp9N3/mj8=
 github.com/gethinode/mod-katex v1.0.4/go.mod h1:byAfpI3wuqNJIooTGVEGc1cjBhhCy4+CcK1H6495MYg=
+github.com/gethinode/mod-katex v1.0.5 h1:AVhcTINYory0ygChQERf8PcyJkbT1oqhmLRF6ESnWOY=
+github.com/gethinode/mod-katex v1.0.5/go.mod h1:byAfpI3wuqNJIooTGVEGc1cjBhhCy4+CcK1H6495MYg=
 github.com/gethinode/mod-leaflet v0.3.4 h1:oY+YQ0JiJuhFQNrk9XgFdg0NMsTUQPXNfnILp4ia4r4=
 github.com/gethinode/mod-leaflet v0.3.4/go.mod h1:uGggt87x4Fw7wBoJpSiUvNkYg+s/Ujne7klAX2rxMRk=
 github.com/gethinode/mod-leaflet v0.3.5 h1:69Bv/6zRXhbcTzo7TMr58h3ry47srHRpM1k81LrLbYU=

exampleSite/hugo_stats.json

@@ -38,8 +38,14 @@
       "sub",
       "sup",
       "svg",
+      "table",
+      "tbody",
+      "td",
+      "th",
+      "thead",
       "time",
       "title",
+      "tr",
       "ul",
       "use"
     ],
@@ -56,9 +62,9 @@
       "alert-dismissible",
       "align-items-center",
       "align-items-end",
-      "align-items-start",
       "align-middle",
       "align-self-center",
+      "align-self-end",
       "anchor",
       "badge",
       "bg-body",
@@ -119,12 +125,16 @@
       "col-6",
       "col-8",
       "col-9",
+      "col-auto",
+      "col-lg-2",
       "col-lg-4",
       "col-lg-8",
       "col-md-10",
       "col-md-2",
+      "col-md-3",
       "col-md-4",
       "col-md-8",
+      "col-md-9",
       "col-md-auto",
       "col-sm-12",
       "col-sm-3",
@@ -140,6 +150,7 @@
       "d-grid",
       "d-inline",
       "d-inline-flex",
+      "d-lg-block",
       "d-md-block",
       "d-md-flex",
       "d-md-none",
@@ -165,10 +176,6 @@
       "fa-2xs",
       "fa-4x",
       "fa-activity",
-      "fa-angle-left",
-      "fa-angle-right",
-      "fa-angles-left",
-      "fa-angles-right",
       "fa-arrow-left",
       "fa-arrow-right",
       "fa-bootstrap",
@@ -212,7 +219,6 @@
       "form-control",
       "fs-3",
       "fs-5",
-      "fw-30",
       "fw-bold",
       "fw-semibold",
       "g-0",
@@ -303,15 +309,12 @@
       "p-2",
       "p-3",
       "p-4",
-      "page-item",
-      "page-link",
-      "pagination",
-      "pagination-terse",
       "pb-2",
       "pb-3",
       "pb-4",
       "pb-5",
       "pb-md-0",
+      "pe-1",
       "pe-3",
       "position-absolute",
       "position-fixed",
@@ -321,7 +324,6 @@
       "ps-1",
       "ps-3",
       "ps-xl-3",
-      "pt-3",
       "pt-5",
       "pt-md-3",
       "px-4",
@@ -341,6 +343,7 @@
       "row",
       "row-cols-1",
       "row-cols-2",
+      "row-cols-lg-3",
       "row-cols-md-2",
       "row-cols-md-3",
       "row-cols-sm-2",
@@ -350,6 +353,7 @@
       "search-suggestions",
       "shadow",
       "show",
+      "sidebar-overflow",
       "slide",
       "small",
       "spinner-border",
@@ -361,6 +365,8 @@
       "syntax-highlight",
       "tab-content",
       "tab-pane",
+      "table",
+      "table-responsive",
       "tag-link",
       "text-bg-body",
       "text-bg-body-tertiary",

go.mod

@@ -3,10 +3,13 @@ module github.com/gethinode/hinode
 go 1.19
 
 require (
+	github.com/airbnb/lottie-web v5.12.2+incompatible // indirect
 	github.com/gethinode/mod-bootstrap v1.2.2 // indirect
-	github.com/gethinode/mod-flexsearch v1.5.1 // indirect
+	github.com/gethinode/mod-flexsearch v1.7.1 // indirect
-	github.com/gethinode/mod-fontawesome v1.5.0 // indirect
+	github.com/gethinode/mod-fontawesome v1.7.3 // indirect
-	github.com/gethinode/mod-katex v1.0.4 // indirect
+	github.com/gethinode/mod-katex v1.0.5 // indirect
 	github.com/gethinode/mod-leaflet v0.3.5 // indirect
 	github.com/gethinode/mod-lottie v1.3.0 // indirect
+	github.com/nextapps-de/flexsearch v0.0.0-20230711092928-1243fd883ec3 // indirect
+	github.com/twbs/bootstrap v5.3.2+incompatible // indirect
 )

go.sum

@@ -1,3 +1,5 @@
+github.com/airbnb/lottie-web v5.12.2+incompatible h1:Ldogtlhiucf7mMsgisyxSBY0qunV44+lpa9Icy2KoQc=
+github.com/airbnb/lottie-web v5.12.2+incompatible/go.mod h1:nTss557UK9FGnp8QYlCMO29tjUHwbdAHG/DprbGfHGE=
 github.com/gethinode/mod-bootstrap v1.0.1 h1:NDZar+UEL42YHCvzzO+jVgqkZU5INA12BpjX3y6U4I4=
 github.com/gethinode/mod-bootstrap v1.0.1/go.mod h1:DcpPc2cNaXUPGEvhD7npuEEPA7573NvakTlrwFbyjr8=
 github.com/gethinode/mod-bootstrap v1.1.0 h1:BbalsW8kmFhv+J+dcc41TGcjIlM/p69AB0h0oGhAXIU=
@@ -32,6 +34,12 @@ github.com/gethinode/mod-flexsearch v1.4.1 h1:z+GKvhJ4v6BsZsWVZRgbO9WcmSZEVUkb3Q
 github.com/gethinode/mod-flexsearch v1.4.1/go.mod h1:TXbGbWsvmhBdsTzRt887mcpFfr4ORpzG3+h/l4W3YM4=
 github.com/gethinode/mod-flexsearch v1.5.1 h1:9fYlnHgiEXckL0EoC0zlSNO7BWZf5yiOroSWT13Kphc=
 github.com/gethinode/mod-flexsearch v1.5.1/go.mod h1:TXbGbWsvmhBdsTzRt887mcpFfr4ORpzG3+h/l4W3YM4=
+github.com/gethinode/mod-flexsearch v1.6.0 h1:Rjx+GLOByFLmaWD9hZXwmuKN8A89te6BZAIq2c9QBKg=
+github.com/gethinode/mod-flexsearch v1.6.0/go.mod h1:TXbGbWsvmhBdsTzRt887mcpFfr4ORpzG3+h/l4W3YM4=
+github.com/gethinode/mod-flexsearch v1.7.0 h1:VFTf6iUyT9b47jTDAxh8nVHU1eUBrdxlykaC90lTfqk=
+github.com/gethinode/mod-flexsearch v1.7.0/go.mod h1:TXbGbWsvmhBdsTzRt887mcpFfr4ORpzG3+h/l4W3YM4=
+github.com/gethinode/mod-flexsearch v1.7.1 h1:f4rjKkhleDVzqwUmwP1xZdhjru5VQ9g0MRDz0G6oLyY=
+github.com/gethinode/mod-flexsearch v1.7.1/go.mod h1:TXbGbWsvmhBdsTzRt887mcpFfr4ORpzG3+h/l4W3YM4=
 github.com/gethinode/mod-fontawesome v1.0.2 h1:ZSK6D20/w4y5GnfYfTBB58uHD0ChIfkpKfRGwioS9rg=
 github.com/gethinode/mod-fontawesome v1.0.2/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
 github.com/gethinode/mod-fontawesome v1.1.0 h1:rsDzUI+3ZlS/do2ff3ne8/z3KwHeysmuA+WsXlumXXk=
@@ -58,6 +66,12 @@ github.com/gethinode/mod-fontawesome v1.4.0 h1:JfmVYwQl19jmZxgxY64yvGqJAAEiFkKf2
 github.com/gethinode/mod-fontawesome v1.4.0/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
 github.com/gethinode/mod-fontawesome v1.5.0 h1:3mW5dnWauuF9wSWXNIY+PPgTNPlc/xQOQoG7XGic1Yk=
 github.com/gethinode/mod-fontawesome v1.5.0/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
+github.com/gethinode/mod-fontawesome v1.5.1 h1:C7goQY4HrEua/lpjC++laydNKBuYo1+307ngn5tyXeM=
+github.com/gethinode/mod-fontawesome v1.5.1/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
+github.com/gethinode/mod-fontawesome v1.6.1 h1:iqOgDGdw7Bs4hnzjF/8JsUn10omyKQZTglLqNenT1K0=
+github.com/gethinode/mod-fontawesome v1.6.1/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
+github.com/gethinode/mod-fontawesome v1.7.3 h1:YzRCYSasVRIcImVmTJYjqNJ+KmyNWfm/bMgtM0slvzs=
+github.com/gethinode/mod-fontawesome v1.7.3/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
 github.com/gethinode/mod-katex v1.0.0 h1:me/3dIIZBkfk1mRIFt8QiAGYwYDoSG5bc2hHRtIutFc=
 github.com/gethinode/mod-katex v1.0.0/go.mod h1:byAfpI3wuqNJIooTGVEGc1cjBhhCy4+CcK1H6495MYg=
 github.com/gethinode/mod-katex v1.0.1 h1:809QUztxmKgMNchU+v03iMO7Ma+ISc3ZzhXYauc21rs=
@@ -68,6 +82,8 @@ github.com/gethinode/mod-katex v1.0.3 h1:fvlUWqcUQqv2zRNM2kfmJ6GhXA816Tl1nfVrUkm
 github.com/gethinode/mod-katex v1.0.3/go.mod h1:byAfpI3wuqNJIooTGVEGc1cjBhhCy4+CcK1H6495MYg=
 github.com/gethinode/mod-katex v1.0.4 h1:NozgWPFnHhx1W+E9DnwMTRpvxPbdqdANEtwp9N3/mj8=
 github.com/gethinode/mod-katex v1.0.4/go.mod h1:byAfpI3wuqNJIooTGVEGc1cjBhhCy4+CcK1H6495MYg=
+github.com/gethinode/mod-katex v1.0.5 h1:AVhcTINYory0ygChQERf8PcyJkbT1oqhmLRF6ESnWOY=
+github.com/gethinode/mod-katex v1.0.5/go.mod h1:byAfpI3wuqNJIooTGVEGc1cjBhhCy4+CcK1H6495MYg=
 github.com/gethinode/mod-leaflet v0.2.3 h1:QQI4h+IH0jZ7fx4q0um2YIEiYBoW3OAfW8qHzbRCDPk=
 github.com/gethinode/mod-leaflet v0.2.3/go.mod h1:uGggt87x4Fw7wBoJpSiUvNkYg+s/Ujne7klAX2rxMRk=
 github.com/gethinode/mod-leaflet v0.3.1 h1:H5MaOa+BB1KuVw7abTqfIn/SNzzRsAyx/WQoSe+2Ykc=
@@ -90,3 +106,7 @@ github.com/gethinode/mod-lottie v1.2.0 h1:9S0Y4PlEO66dIvFxayatmDEf8WWxqbLNLi4z56
 github.com/gethinode/mod-lottie v1.2.0/go.mod h1:erRCgSL2FCfKHI0jQbSpM+g0jXl7SjKVJrh7kWGteKs=
 github.com/gethinode/mod-lottie v1.3.0 h1:vQ8CXkjdp2IeFskTzu+ZnKOEio8GtN08urVK+oCH81E=
 github.com/gethinode/mod-lottie v1.3.0/go.mod h1:erRCgSL2FCfKHI0jQbSpM+g0jXl7SjKVJrh7kWGteKs=
+github.com/nextapps-de/flexsearch v0.0.0-20230711092928-1243fd883ec3 h1:H/qVR5O4BXjRjD+5PZB+r4ug2BSJ2Of4RtwOntd+OKo=
+github.com/nextapps-de/flexsearch v0.0.0-20230711092928-1243fd883ec3/go.mod h1:5GdMfPAXzbA2gXBqTjC6l27kioSYzHlqDMh0+wyx7sU=
+github.com/twbs/bootstrap v5.3.2+incompatible h1:tuiO5acc6xnZUR77Sbi5aKWXxjYxbmsSbJwYrhAKoQQ=
+github.com/twbs/bootstrap v5.3.2+incompatible/go.mod h1:fZTSrkpSf0/HkL0IIJzvVspTt1r9zuf7XlZau8kpcY0=

hugo_stats.json

@@ -15,6 +15,7 @@
       "link",
       "meta",
       "nav",
+      "ol",
       "p",
       "path",
       "script",
@@ -29,11 +30,14 @@
       "active",
       "align-items-center",
       "align-self-center",
+      "align-self-end",
       "bg-body",
       "bg-opacity-10",
       "bg-primary",
       "bottom-0",
       "bottom-bar",
+      "breadcrumb",
+      "breadcrumb-item",
       "btn",
       "btn-close",
       "btn-primary",
@@ -41,8 +45,10 @@
       "col-12",
       "col-6",
       "col-md-2",
+      "col-md-3",
       "col-md-4",
       "col-md-8",
+      "col-md-9",
       "col-sm-12",
       "collapse",
       "collapsed",
@@ -85,7 +91,6 @@
       "form-control",
       "fs-3",
       "fs-5",
-      "fw-30",
       "fw-bold",
       "hstack",
       "img-fluid",
@@ -144,7 +149,6 @@
       "row-cols-1",
       "row-cols-2",
       "row-cols-md-2",
-      "row-cols-sm-2",
       "row-cols-sm-3",
       "search",
       "search-input",

i18n/de.yaml

@@ -30,9 +30,9 @@
 - id: shareSystem
   translation: "Betriebssystem"
 - id: copyToClipboard
-  translation: "In Zwischenablage kopieren"
+  translation: "In die Zwischenablage kopieren"
 - id: copiedToClipboard
-  translation: "Der Text befindet sich in die Zwischenablage"
+  translation: "befindet sich in der Zwischenablage"
 - id: link
   translation: "Link zur Webseite"
 - id: code

i18n/en.yaml

@@ -27,6 +27,18 @@
   translation: "More {{ . }}"
 - id: emptyList
   translation: "No articles found"
+- id: emptyTags
+  translation: "No tags found"
+
+# Languages
+- id: lang_de
+  translation: "German"
+- id: lang_en
+  translation: "English"
+- id: lang_nl
+  translation: "Dutch"
+- id: lang_fr
+  translation: "French"
 
 # Sharing
 - id: shareLink
@@ -79,6 +91,8 @@
   translation: "On this page"
 - id: seeAlso
   translation: "See also"
+- id: sectionMenu
+  translation: "Select a topic"
 
 # Sidebar
 - id: toggleSidebar
@@ -119,3 +133,17 @@
   translation: "Show"
 - id: comments
   translation: "Comments" 
+
+# Arguments
+- id: name
+  translation: "Name"
+- id: type
+  translation: "Type"
+- id: required 
+  translation: "Required"
+- id: default
+  translation: "Default"
+- id: comment
+  translation: "Comment"
+- id: supportedValues
+  translation: "Supported values"

i18n/nl.yaml

@@ -25,6 +25,18 @@
   translation: "Meer {{ . }}"
 - id: emptyList
   translation: "Geen artikelen gevonden"
+- id: emptyTags
+  translation: "Geen tags gevonden"
+
+# Languages
+- id: lang_de
+  translation: "Duits"
+- id: lang_en
+  translation: "Engels"
+- id: lang_nl
+  translation: "Nederlands"
+- id: lang_fr
+  translation: "Frans"
 
 # Sharing
 - id: shareLink
@@ -77,6 +89,8 @@
   translation: "Inhoudsopgave"
 - id: seeAlso
   translation: "Zie ook"
+- id: sectionMenu
+  translation: "Selecteer een onderwerp"
 
 # Sidebar
 - id: toggleSidebar
@@ -117,3 +131,18 @@
   translation: "Tonen"
 - id: comments
   translation: "Reacties" 
+
+
+# Arguments
+- id: name
+  translation: "Naam"
+- id: type
+  translation: "Type"
+- id: required 
+  translation: "Verplicht"
+- id: default
+  translation: "Standaardwaarde"
+- id: comment
+  translation: "Toelichting"
+- id: supportedValues
+  translation: "Toegestane waarden"

i18n/zh-hans.yaml

@@ -0,0 +1,135 @@
+# Single pages
+- id: postedOnDate
+  translation: "发布于 {{ . }}"
+- id: lastModified
+  translation: "最后修改于 {{ . }}"
+- id: read
+  translation: "阅读"
+- id: minutesShort
+  translation: "分钟"
+- id: words
+  translation: "字"
+- id: photoFull
+  translation: "照片由 %s 于 %s 拍摄"
+- id: photoShort
+  translation: "照片由 {{ . }} 拍摄"
+- id: photoOn
+  translation: "于"
+- id: draft
+  translation: "草稿"
+
+# List pages
+- id: article
+  translation: "文章"
+- id: articles
+  translation: "文章"
+- id: more
+  translation: "更多 {{ . }}"
+- id: emptyList
+  translation: "没有找到文章"
+- id: emptyTags
+  translation: "没有找到标签"
+
+# Languages
+- id: lang_de
+  translation: "German"
+- id: lang_en
+  translation: "English"
+- id: lang_nl
+  translation: "Dutch"
+- id: lang_fr
+  translation: "French"
+
+# Sharing
+- id: shareLink
+  translation: "分享至 {{ . }}"
+- id: shareSystem
+  translation: "系统"
+- id: copyToClipboard
+  translation: "复制到剪贴板"
+- id: copiedToClipboard
+  translation: "已复制到剪贴板"
+- id: link
+  translation: "链接"
+- id: code
+  translation: "代码"
+- id: download
+  translation: "下载文章"
+
+# Pagination
+- id: paginationNav
+  translation: "页面导航"
+- id: paginationPrevious
+  translation: "上一页"
+- id: paginationNext
+  translation: "下一页"
+- id: paginationFirst
+  translation: "第一页"
+- id: paginationLast
+  translation: "最后一页"
+
+# Navigation
+- id: colorMode
+  translation: "切换主题"
+- id: colorLight
+  translation: "亮色"
+- id: colorDark
+  translation: "暗色"
+- id: colorAuto
+  translation: "自动"
+- id: toggleMainNav
+  translation: "切换主导航"
+- id: home
+  translation: "首页"
+- id: languageSwitcherLabel
+  translation: "语言"
+- id: close
+  translation: "关闭"
+
+# Table of contents
+- id: toc
+  translation: "本页目录"
+- id: seeAlso
+  translation: "参见"
+- id: sectionMenu
+  translation: "选择一个主题"
+
+# Sidebar
+- id: toggleSidebar
+  translation: "切换侧边栏导航"
+
+# Feature
+- id: addedFeature
+  translation: "新增于 {{ . }}"
+- id: deprecatedFeature
+  translation: "已弃用于 {{ . }}"
+
+# Versioning
+- id: latest
+  translation: "最新"
+- id: allVersions
+  translation: "所有版本"
+- id: newerVersionAlert
+  translation: "有一个更新版本的 {{ . }}!"
+
+# 404 page
+- id: pageNotFound
+  translation: "您访问的页面不存在或发生了其他错误。请返回我们的{{ . }}。"
+- id: pageNotFoundTitle
+  translation: "页面未找到"
+- id: pageNotFoundHome
+  translation: "首页"
+
+# Footer
+- id: copyright
+  translation: "Copyright"
+- id: rights
+  translation: "版权所有"
+- id: poweredBy
+  translation: "由 {{ . }} 提供支持。"
+
+# Comments
+- id: show
+  translation: "显示"
+- id: comments
+  translation: "评论"

i18n/zh-hant.yaml

@@ -0,0 +1,135 @@
+# Single pages
+- id: postedOnDate
+  translation: "發佈於 {{ . }}"
+- id: lastModified
+  translation: "最後修改於 {{ . }}"
+- id: read
+  translation: "閱讀"
+- id: minutesShort
+  translation: "分鐘"
+- id: words
+  translation: "字"
+- id: photoFull
+  translation: "照片由 %s 於 %s 拍攝"
+- id: photoShort
+  translation: "照片由 {{ . }} 拍攝"
+- id: photoOn
+  translation: "於"
+- id: draft
+  translation: "草稿"
+
+# List pages
+- id: article
+  translation: "文章"
+- id: articles
+  translation: "文章"
+- id: more
+  translation: "更多 {{ . }}"
+- id: emptyList
+  translation: "沒有找到文章"
+- id: emptyTags
+  translation: "沒有找到標籤"
+
+# Languages
+- id: lang_de
+  translation: "German"
+- id: lang_en
+  translation: "English"
+- id: lang_nl
+  translation: "Dutch"
+- id: lang_fr
+  translation: "French"
+
+# Sharing
+- id: shareLink
+  translation: "分享至 {{ . }}"
+- id: shareSystem
+  translation: "系統"
+- id: copyToClipboard
+  translation: "複製到剪貼板"
+- id: copiedToClipboard
+  translation: "已複製到剪貼板"
+- id: link
+  translation: "連結"
+- id: code
+  translation: "程式碼"
+- id: download
+  translation: "下載文章"
+
+# Pagination
+- id: paginationNav
+  translation: "頁面導航"
+- id: paginationPrevious
+  translation: "上一頁"
+- id: paginationNext
+  translation: "下一頁"
+- id: paginationFirst
+  translation: "第一頁"
+- id: paginationLast
+  translation: "最後一頁"
+
+# Navigation
+- id: colorMode
+  translation: "切換主題"
+- id: colorLight
+  translation: "亮色"
+- id: colorDark
+  translation: "暗色"
+- id: colorAuto
+  translation: "自動"
+- id: toggleMainNav
+  translation: "切換主導航"
+- id: home
+  translation: "首頁"
+- id: languageSwitcherLabel
+  translation: "語言"
+- id: close
+  translation: "關閉"
+
+# Table of contents
+- id: toc
+  translation: "本頁目錄"
+- id: seeAlso
+  translation: "參見"
+- id: sectionMenu
+  translation: "選擇一個主題"
+
+# Sidebar
+- id: toggleSidebar
+  translation: "切換側邊欄導航"
+
+# Feature
+- id: addedFeature
+  translation: "新增於 {{ . }}"
+- id: deprecatedFeature
+  translation: "已棄用於 {{ . }}"
+
+# Versioning
+- id: latest
+  translation: "最新"
+- id: allVersions
+  translation: "所有版本"
+- id: newerVersionAlert
+  translation: "有一個更新版本的 {{ . }}!"
+
+# 404 page
+- id: pageNotFound
+  translation: "您訪問的頁面不存在或發生了其他錯誤。請返回我們的{{ . }}。"
+- id: pageNotFoundTitle
+  translation: "頁面未找到"
+- id: pageNotFoundHome
+  translation: "首頁"
+
+# Footer
+- id: copyright
+  translation: "Copyright"
+- id: rights
+  translation: "版權所有"
+- id: poweredBy
+  translation: "由 {{ . }} 提供支持。"
+
+# Comments
+- id: show
+  translation: "顯示"
+- id: comments
+  translation: "評論"

layouts/_default/baseof.html

@@ -39,11 +39,17 @@
     {{- errorf "Bootstrap is a required module, please add it to 'modules.core' in your site parameters" -}}
 {{- end -}}
 
+{{- $fullCover := or (or (and .IsHome .Site.Params.home.fullCover) .Page.Params.fullCover) .Site.Params.main.footerBelowFold }}
+{{- $.Scratch.Set "fullCover" $fullCover -}}
+
 {{- /* Define section headings */ -}}
-{{ $sections := partial "utilities/GetSections.html" . }}
+{{- $loading := "" -}}
+{{- if $fullCover }}{{ $loading = .Site.Params.main.loading }}{{ end -}}
+{{ $sections := partial "utilities/GetSections.html" (dict "page" . "loading" $loading) }}
 {{- $.Scratch.Set "sections" $sections -}}
 
-{{- $fullCover := or (or (and .IsHome .Site.Params.home.fullCover) .Page.Params.fullCover) .Site.Params.main.footerBelowFold }}
+{{- /* Define main breakpoint */ -}}
+{{- $.Scratch.Set "breakpoint" (partial "utilities/GetBreakpoint.html") }}
 
 <!doctype html>
 <html lang="{{ .Site.Language.Lang }}" class="no-js">

layouts/_default/list.html

@@ -1,88 +1,30 @@
 {{- define "featured" }}
-    {{- $sections := $.Scratch.Get "sections" -}}
+    {{ .Render "list/header" }}
-    {{- $headings := slice }}
-    {{ if .Params.sectionMenu }}
-        {{ range $sections }}
-            {{ $headings = $headings | append .title }}
-        {{ end }}
-    {{ end }}
-
-    {{- $page := . -}}
-    {{- $orientation := site.Params.list.feature.orientation | default "horizontal" -}}
-    {{- $width := site.Params.list.feature.width | default 6 -}}
-    {{- $justify := site.Params.list.feature.justify | default "center" -}}
-    {{- $align := site.Params.list.feature.align | default "center" -}}
-    {{- $actions := $page.Params.actions -}}
-    {{- $layout := $page.Params.layout -}}
-
-    {{ if $page.IsHome }}
-        {{- $orientation = or site.Params.home.feature.orientation $orientation -}}
-        {{- $width = or site.Params.home.feature.width $width -}}
-        {{- $justify = or site.Params.home.feature.justify $justify -}}
-        {{- $align = or site.Params.home.feature.align $align -}}
-        {{- $actions = (or $actions site.Params.featured.actions) -}}
-    {{ end }}
-
-    {{/* Display featured section */}}
-    {{- if or (eq $layout "featured") $page.IsHome -}}
-        {{- partial "list/featured.html" (dict 
-            "page" .
-            "headings" $headings
-            "actions" $actions
-            "orientation" $orientation
-            "width" $width
-            "justify" $justify
-            "align" $align) 
-        -}}
-    {{- end -}}
 {{ end }}
 
 {{- define "main" -}}
     {{- $page := . -}}
     {{- $sections := $.Scratch.Get "sections" -}}
+    {{- $fullCover := $.Scratch.Get "fullCover" -}}
     {{- $layout := $page.Params.layout -}}
 
-    <div class="container-xxl flex-fill px-4 px-xxl-0">
+    <div class="container-xxl p-4 px-xxl-0">
         {{- if ne $layout "featured" -}}
             {{ if and (not $page.IsHome) site.Params.navigation.breadcrumb }}
                 <div>{{ partial "assets/breadcrumb.html" $page }}</div>
             {{ end -}}
         {{- end -}}
 
-        <div class="row row-cols-1 row-cols-sm-2">
+        {{ .Render "list/body" }}
-            <div class="col col-sm-12 col-md-8">
+
-                {{ if not $page.IsHome }}
+        {{ .Render "list/footer" }}
-                    {{ with $page.Title }}<p id="{{ anchorize . }}" class="display-4 mt-5{{ if and page.IsHome site.Params.home.centerHeadline }} text-center{{ end }}">{{ . }}</p>{{ end }}
-                {{ end }}
-                {{ if ($page.Params.menu) }}
-                    {{- partial "assets/section-menu.html" $page -}}
-                {{- end -}}
-                {{- $content := partial "utilities/ProcessContent" (dict "page" $page "raw" $page.RawContent) -}}
-                {{ $content | safeHTML }}
-                {{ if and (and $sections (eq (len $sections) 1)) (not $content) }}
-                    <p class="pt-4">{{- T "emptyList" }}.</p>
-                {{ end }}
-            </div>
-            {{ with $page.Params.contact }}
-                {{- $contact := site.GetPage . }}
-                {{- if not $contact }}
-                    {{- errorf "Error processing content file '%s' - Cannot find contact: %s" $page.File . -}}
-                {{- else -}}
-                    {{ $color := site.Params.contact.color | default "primary" }}
-                    {{ $style := site.Params.contact.style | default "shadow" }}
-                    <div class="col col-md-4 d-none d-md-block pt-5">
-                        {{- partial "assets/card.html" (dict "path" $page.Params.contact "color" $color "header" "none" "footer" "none" "ratio" "1x1" "class" (printf "w-75 mx-auto mt-4 %s" $style)) -}}
-                    </div>
-                    <div class="col col-sm-12 d-md-none pt-5">
-                        {{- partial "assets/card.html" (dict "path" $page.Params.contact "color" $color "header" "none" "footer" "none" "orientation" "horizontal" "class" $style) -}}
-                    </div>
-                {{- end }}
-            {{ end }}
-        </div>    
     </div>
 
     {{/* Display generated sections */}}
     {{ range $sections }}
         {{ .content | safeHTML }}
     {{ end }}
+
+    {{/* Fill remaining space to push page footer to viewport bottom */}}
+    <div class="container-fluid flex-fill"></div>
 {{- end -}}

layouts/_default/list/body.html

@@ -0,0 +1,27 @@
+{{- $sections := $.Scratch.Get "sections" -}}
+{{- $fullCover := $.Scratch.Get "fullCover" -}}
+{{- $breakpoint := $.Scratch.Get "breakpoint" -}}
+{{- $layout := .Params.layout -}}
+
+<div class="row row-cols-1 row-cols-{{ $breakpoint.current }}-2">
+    <div class="col-12 col-{{ $breakpoint.current }}-9">
+        {{ if not .IsHome }}
+            {{ with .Title }}<p id="{{ anchorize . }}" class="display-4 mt-5{{ if and $.IsHome site.Params.home.centerHeadline }} text-center{{ end }}">{{ . }}</p>{{ end }}
+        {{ end }}
+        {{ if (.Params.menu) }}
+            {{- partial "assets/section-menu.html" . -}}
+        {{- end -}}
+        {{- $loading := "" -}}
+        {{- if or (eq $layout "featured") .IsHome -}}
+            {{- if $fullCover }}{{ $loading = site.Params.main.loading }}{{ end }}
+        {{ end }}
+        {{- $content := partial "utilities/ProcessContent" (dict "page" . "raw" .RawContent "loading" $loading) -}}
+        {{- $content | safeHTML -}}
+        {{ if and (and $sections (eq (len $sections) 1)) (not $content) }}
+            <p class="pt-4">{{- T "emptyList" }}.</p>
+        {{ end }}
+    </div>
+    <div class="col col-{{ $breakpoint.current }}-3 d-none d-{{ $breakpoint.current }}-block">
+        {{/* Empty in default layout */}}        
+    </div>
+</div>    

layouts/_default/list/footer.html

@@ -0,0 +1 @@
+{{/* Adds a custom footer directly below the list body */}}

layouts/_default/list/header.html

@@ -0,0 +1,35 @@
+{{- $sections := $.Scratch.Get "sections" -}}
+{{- $headings := slice }}
+{{ if .Params.sectionMenu }}
+    {{ range $sections }}
+        {{ $headings = $headings | append .title }}
+    {{ end }}
+{{ end }}
+
+{{- $orientation := site.Params.list.feature.orientation | default "horizontal" -}}
+{{- $width := site.Params.list.feature.width | default 6 -}}
+{{- $justify := site.Params.list.feature.justify | default "center" -}}
+{{- $align := site.Params.list.feature.align | default "center" -}}
+{{- $actions := .Params.actions -}}
+{{- $layout := .Params.layout -}}
+
+{{ if .IsHome }}
+    {{- $orientation = or site.Params.home.feature.orientation $orientation -}}
+    {{- $width = or site.Params.home.feature.width $width -}}
+    {{- $justify = or site.Params.home.feature.justify $justify -}}
+    {{- $align = or site.Params.home.feature.align $align -}}
+    {{- $actions = (or $actions site.Params.featured.actions) -}}
+{{ end }}
+
+{{/* Display featured section */}}
+{{- if or (eq $layout "featured") .IsHome -}}
+    {{- partial "list/featured.html" (dict 
+        "page" .
+        "headings" $headings
+        "actions" $actions
+        "orientation" $orientation
+        "width" $width
+        "justify" $justify
+        "align" $align) 
+    -}}
+{{- end -}}

layouts/_default/single.html

@@ -1,13 +1,13 @@
 {{- define "partials/single-main.html" -}}
+    {{- $breakpoint := $.Scratch.Get "breakpoint" -}}
     {{ if .Site.Params.navigation.breadcrumb }}{{ partial "assets/breadcrumb.html" . }}{{ end -}}
 
     {{ .Render "single/header" }}
 
     {{- if and .Site.Params.navigation.toc .Params.includeToc | default true -}}
-        <div class="d-md-none pb-5">{{ partial "assets/toc-dropdown.html" . }}</div>
+        <div class="d-{{ $breakpoint.current }}-none pb-5">{{ partial "assets/toc-dropdown.html" . }}</div>
     {{- end -}}
     {{ .Render "single/body" }}
-    {{ partial "utilities/ProcessContent" (dict "page" .Page "raw" .RawContent) }}
 
     {{ .Render "single/footer" }}
     {{- if and .Site.Params.comments.enabled .Params.showComments | default true -}}
@@ -17,21 +17,15 @@
 {{ end -}}
 
 {{ define "main" -}}
-    {{- $download := .Params.download -}}
-    {{- if and $download (not (fileExists (path.Join "static" $download))) -}}
-        {{- errorf "Cannot find download file for page '%s': %s" .File.Path $download -}}
-    {{- end -}}
-    
     {{- $menu := .Scratch.Get "sidebar" -}}
     {{- $version := .Scratch.Get "version" -}}
+    {{- $breakpoint := $.Scratch.Get "breakpoint" -}}
 
     {{ $sidebar := "" }}
     {{- $hasSidebar := .Site.Params.navigation.sidebar | default true -}}
     {{ if and $menu $hasSidebar  }}{{ $sidebar = partial "assets/sidebar.html" (dict "page" . "menu" $menu "version" $version) }}{{ end }}
 
-    {{ $toc := "" }}
+    {{ $toc := .Render "single/panel-toc" }}
-    {{- $hasTOC := and .Site.Params.navigation.toc .Params.includeToc | default true -}}
-    {{ if $hasTOC }}{{ $toc = partial "assets/toc.html" (dict "page" . "download" $download) }}{{ end -}}
 
     {{ with $sidebar -}}
         <div class="offcanvas offcanvas-start" tabindex="-1" id="offcanvass-sidebar" aria-inledby="offcanvas-label">
@@ -46,34 +40,24 @@
     {{ end }}
 
     <div class="container-xxl flex-fill p-4 px-xxl-0">
-        {{ if and $menu $hasSidebar -}}
+        {{ if $hasSidebar -}}
-            <div class="row row-cols-md-2 row-cols-lg-3">
+            <div class="row row-cols-1 row-cols-{{ $breakpoint.current }}-2 row-cols-{{ $breakpoint.next }}-3">
-                <div class="col col-md-3 col-lg-2 d-none pt-5 d-md-block sidebar-overflow sticky-top">
+                <div class="col col-{{ $breakpoint.next }}-2 d-none d-{{ $breakpoint.next }}-block sidebar-overflow sticky-top pt-5">
                     {{ $sidebar | safeHTML }}
                 </div>
-                <div class="col col-md-9 col-lg-8 mb-5 p-4">
+                <div class="col-12 col-{{ $breakpoint.current }}-9 col-{{ $breakpoint.next }}-8 mb-5 p-4">
                     {{ partial "partials/single-main.html" . }}
                 </div>
-                <div class="col col-lg-2 d-none d-lg-block pt-5">
+                <div class="col col-{{ $breakpoint.current }}-3 col-{{ $breakpoint.next }}-2 d-none d-{{ $breakpoint.current }}-block pt-5">
                     {{ $toc | safeHTML }}
                 </div>
             </div>
-        {{ else if $hasSidebar }}
-            <div class="row row-cols-1 row-cols-sm-3">
-                <div class="col col-md-2 d-none d-md-block"></div>
-                <div class="col col-sm-12 col-md-8">
-                    {{ partial "partials/single-main.html" . }}
-                </div>
-                <div class="col col-md-2 d-none d-md-block">
-                    {{ $toc | safeHTML }}
-                </div>
-            </div>    
         {{ else }}
-            <div class="row row-cols-1 row-cols-sm-2">
+            <div class="row row-cols-1 row-cols-{{ $breakpoint.current }}-2">
-                <div class="col col-sm-12 col-md-9">
+                <div class="col col-{{ $breakpoint.prev }}-12 col-{{ $breakpoint.current }}-9">
                     {{ partial "partials/single-main.html" . }}
                 </div>
-                <div class="col col-md-3 d-none d-md-block">
+                <div class="col col-{{ $breakpoint.current }}-3 d-none d-{{ $breakpoint.current }}-block">
                     {{ $toc | safeHTML }}
                 </div>
             </div>    

layouts/_default/single/body.html

@@ -1 +1,3 @@
-{{- partial "single/thumbnail.html" . -}}
+{{- partial "single/thumbnail.html" (dict "page" . "class" "mb-5") -}}
+
+{{ partial "utilities/ProcessContent" (dict "page" .Page "raw" .RawContent) }}

layouts/_default/single/header.html

@@ -1,12 +1,31 @@
-{{ $lastmodstr := (partial "utilities/date.html" (dict "date" .Lastmod "format" "long")) -}}
+{{- $metadata := "full" -}}
-{{ $datestr := (partial "utilities/date.html" (dict "date" .Date "format" "long")) -}}
+{{ if isset .Params "metadata" }}
+    {{ $metadata = .Params.metadata }}
+{{ else }}
+    {{- with (index site.Params.pages .Type ) -}}
+        {{ if isset . "metadata" }}{{ $metadata = (index . "metadata") }}{{ end }}
+    {{- end -}}
+{{ end }}
+
+{{- $supportedStates := slice "full" "original" "none" -}}
+{{- if not (in $supportedStates $metadata) -}}
+    {{- errorf "layout [_default/single/header.html] - Invalid value for param 'metadata': %s" $metadata -}}
+{{- end -}}
+
 {{ with .Title }}<p class="display-4 mt-5">{{ . }}</p>{{ end }}
-<small class="text-body-secondary text-uppercase">
+{{ if ne $metadata "none" }}
-    {{ $datestr | i18n "postedOnDate" -}}
+    {{ $lastmodstr := (partial "utilities/date.html" (dict "date" .Lastmod "format" "long")) -}}
-    {{ if ne $datestr $lastmodstr -}}&nbsp;({{ $lastmodstr | i18n "lastModified" }}){{ end }} &bull;
+    {{ $datestr := (partial "utilities/date.html" (dict "date" .Date "format" "long")) -}}
-    {{ .ReadingTime | lang.FormatNumber 0 }}&nbsp;{{ i18n "minutesShort" }} {{ i18n "read" }} &bull;
+    <small class="text-body-secondary text-uppercase">
-    {{ .WordCount | lang.FormatNumber 0 }}&nbsp;{{ i18n "words" }}
+        {{ $datestr | i18n "postedOnDate" -}}
-</small>
+        {{ if eq $metadata "full" }}
+            {{ if ne $datestr $lastmodstr -}}&nbsp;({{ $lastmodstr | i18n "lastModified" }}){{ end }}
+        {{ end }}
+        &bull;
+        {{ .ReadingTime | lang.FormatNumber 0 }}&nbsp;{{ i18n "minutesShort" }} {{ i18n "read" }} &bull;
+        {{ .WordCount | lang.FormatNumber 0 }}&nbsp;{{ i18n "words" }}
+    </small>
+{{ end }}
 
 {{- if gt (len (.GetTerms "tags")) 0 -}}
     <div class="mt-3">

layouts/_default/single/panel-toc.html

@@ -0,0 +1,42 @@
+{{- $download := .Params.download -}}
+{{- if and $download (not (fileExists (path.Join "static" $download))) -}}
+    {{- errorf "Cannot find download file for page '%s': %s" .File.Path $download -}}
+{{- end -}}
+
+{{- $toc := .Site.Params.navigation.toc -}}
+{{ if $toc }}
+    {{ if isset .Params "includeToc" }}
+        {{ $toc = .Params.includeToc }}
+    {{ else }}
+        {{- with (index site.Params.pages .Type) -}}
+            {{ if isset . "includetoc" }}
+                {{ $toc = index . "includetoc" }}
+                {{ if ne (printf "%T" $toc) "bool" }}
+                    {{ errorf "Expected bool value in site parameters: pages.%s.includeToc" $.Type }}
+                {{ end }}
+            {{ end }}
+    {{- end -}}
+    {{ end }}
+{{ end }}
+
+<div class="toc toc-sidebar mb-5 my-md-0 ps-xl-3 mb-lg-5 p-3 text-body-secondary sticky-top">
+    {{ with $download }}
+        {{ $title := (T "download" ) }}
+        {{ $lang := strings.TrimPrefix "." (path.Ext (path.BaseName .)) }}
+        {{ if and $lang (ne (string site.LanguageCode) $lang) }}
+            {{ range site.Languages }}
+                {{ if eq .LanguageCode $lang }}
+                    {{ $title = printf "%s (%s)" (T "download") (T (printf "lang_%s" .LanguageCode)) }}
+                {{ end }}
+            {{ end }}
+        {{ end }}
+        <div class="mb-5 text-center">
+            {{ $attr := dict "download" (path.Base .) }}
+            {{ partial "assets/button.html" (dict "href" . "title" $title "color" "primary" "outline" "true" "icon" "fas download" "size" "sm" "attributes" $attr) }}
+        </div>
+    {{ end }}
+
+    {{ if $toc }}
+        {{ partial "assets/toc.html" (dict "page" . "download" $download) }}
+    {{ end -}}
+</div>

layouts/docs/single/body.html

@@ -1 +1 @@
-{{/* Intentionally left blank to suppress thumbnail */}}
+{{ partial "utilities/ProcessContent" (dict "page" .Page "raw" .RawContent) }}

layouts/minimal/single/body.html

@@ -1 +1 @@
-{{/* Intentionally left blank to suppress thumbnail */}}
+{{ partial "utilities/ProcessContent" (dict "page" .Page "raw" .RawContent) }}

layouts/partials/assets/button.html

@@ -67,7 +67,7 @@
 {{- with .badge }}{{ $badge = . }}{{ end -}}
 
 {{- $label := "" -}}
-{{- with .label }}{{ $label = . }}{{ end -}}
+{{- if .label }}{{ $label = .label }}{{ else }}{{ $label = $title }}{{ end -}}
 
 {{- $tooltip := "" -}}
 {{- if not (strings.HasSuffix $state "active") -}}
@@ -143,7 +143,8 @@
 
 {{- $attributes := .attributes -}}
 
-<a aria-label="{{ (or $label $title) | safeHTML }}" {{ if ne $state "disabled" }}{{ with $href }}href="{{ . }}"{{ end }}{{ end -}}
+<a aria-label="{{ (or $label $title) | safeHTML }}"
+    {{ if ne $state "disabled" }}{{ with $href }}href="{{ . }}"{{ end }}{{ end -}}
     {{- with $id }} id="{{ . }}"{{ end -}}
     {{- with $target }} target="{{ . }}"{{ end }}{{ with $rel }} rel="{{ . }}"{{ end -}}
     {{- with $toast }} data-toast-target="{{ $toast }}"{{ end -}}

layouts/partials/assets/card-group.html

@@ -36,6 +36,7 @@
 -->
 
 {{- $page := .page -}}
+{{- $breakpoint := partial "utilities/GetBreakpoint.html" -}}
 
 {{- if not (in (slice "*hugolib.pageState" "*hugolib.pageForShortcode") (printf "%T" $page)) -}}
     {{- errorf "partial [assets/card-group.html] - Invalid value for param 'page': %T" $page -}}
@@ -66,7 +67,7 @@
 {{ range $index, $element := $pages }}
     {{ $params := dict }}
     <!-- regular page -->
-    {{- if $element.RelPermalink -}}
+    {{- if and $element.RelPermalink $element.File -}}
         {{- $params = merge $params (dict "path" $element.File.Path) -}}
     <!-- headless page -->
     {{- else -}}
@@ -108,10 +109,10 @@
 {{- end -}}
 {{- $colGrid := "" -}}
 {{- if eq $cols "1" }}{{ $colGrid = "row-cols-1" -}}
-{{- else if eq $cols "2" }}{{ if $responsive }}{{ $colGrid = "row-cols-1 row-cols-sm-1 row-cols-md-2" }}{{ else }}{{ $colGrid = "row-cols-2" }}{{ end -}}
+{{- else if eq $cols "2" }}{{ if $responsive }}{{ $colGrid = printf "row-cols-1 row-cols-%s-1 row-cols-%s-2" $breakpoint.prev $breakpoint.current }}{{ else }}{{ $colGrid = "row-cols-2" }}{{ end -}}
-{{- else if eq $cols "3" }}{{ if $responsive }}{{ $colGrid = "row-cols-1 row-cols-sm-2 row-cols-md-3" }}{{ else }}{{ $colGrid = "row-cols-3" }}{{ end -}}
+{{- else if eq $cols "3" }}{{ if $responsive }}{{ $colGrid = printf "row-cols-1 row-cols-%s-2 row-cols-%s-3" $breakpoint.prev $breakpoint.current }}{{ else }}{{ $colGrid = "row-cols-3" }}{{ end -}}
-{{- else if eq $cols "4" }}{{ if $responsive }}{{ $colGrid = "row-cols-1 row-cols-sm-2 row-cols-md-4" }}{{ else }}{{ $colGrid = "row-cols-4" }}{{ end -}}
+{{- else if eq $cols "4" }}{{ if $responsive }}{{ $colGrid = printf "row-cols-1 row-cols-%s-2 row-cols-%s-4" $breakpoint.prev $breakpoint.current }}{{ else }}{{ $colGrid = "row-cols-4" }}{{ end -}}
-{{- else if eq $cols "5" }}{{ if $responsive }}{{ $colGrid = "row-cols-1 row-cols-sm-3 row-cols-md-5" }}{{ else }}{{ $colGrid = "row-cols-5" }}{{ end -}}
+{{- else if eq $cols "5" }}{{ if $responsive }}{{ $colGrid = printf "row-cols-1 row-cols-%s-3 row-cols-%s-5" $breakpoint.prev $breakpoint.current }}{{ else }}{{ $colGrid = "row-cols-5" }}{{ end -}}
 {{ end -}}
 
 {{- $gutter := .gutter | default "4" -}}
@@ -144,6 +145,14 @@
 {{- $ratio := .ratio -}}
 {{- $wrapper := .wrapper | default "p-0" -}}
 
+{{- $loading := .loading -}}
+{{- $validSettings := slice "lazy" "eager" -}}
+{{- if $loading -}}
+    {{ if not (in $validSettings $loading) -}}
+        {{- errorf "partial [assets/card-group.html] - Invalid value for param 'loading': %s" $loading -}}
+    {{ end -}}
+{{- end -}}
+
 {{- if and (eq $cols 1) (eq $orientation "horizontal") }}{{ $orientation = "horizontal-sm" }}{{ end -}}
 
 <div class="container-fluid {{ $wrapper }}">
@@ -157,6 +166,7 @@
                 "footer" $footer
                 "orientation" $orientation
                 "ratio" $ratio
+                "loading" $loading
             ) -}}
             {{- $params = merge $params $element }}
 
@@ -177,7 +187,7 @@
             <div class="pt-3">{{ partial "assets/pagination.html" (dict "page" $page "format" "terse") }}</div>
         {{- end -}} 
     {{ else }}
-        {{ if gt $count $max }}
+        {{ if and (gt $count $max) $moreTitle }}
             <a class="btn btn-outline-primary" href="{{ $moreURL| safeURL }}" role="button">{{ $moreTitle }}</a>
         {{ end }}
     {{ end }}

layouts/partials/assets/card.html

@@ -1,31 +1,49 @@
 <!-- 
-    Displays a Bootstrap card. Either specify a valid path, or set the arguments title, href, header, description, and
+    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
-    thumbnail individually. The latter arguments override any page attributes.
+    Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
-    
+    Visit gethinode.com/license for more details.
-    The shortcode supports the following arguments:
-    "path"          Optional path of the page, override with other parameters.
-    "title"         Required title of the card.
-    "href"          Optional address for the button or hyperlink.
-    "class"         Optional class attribute of the card element, e.g. “w-50”.
-    "color":        Optional theme color of the card, either "primary", "secondary", "success", "danger",
-                    "warning", "info", "light", "dark", "white", "black", "body", or "body-tertiary". By default, no
-                    color is specified.
-    "padding":      Optional padding of the content, either "0", "1", "2", "3", "4", "5", or "auto" (default).
-    "gutter"        Gutter between columns in a group, either "0" (default), "1", "2", "3", "4", or "5".
-    "header"        Optional header components of the card, displayed in small caps. Supported values are "full"
-                    (default), "publication", "tags", and "none".
-    "footer"        Optional footer components of the card, displayed in small caps. Supported values are "full",
-                    "publication", "tags", and "none" (default).
-    "description"   Optional description of the card.
-    "thumbnail"     Optional thumbnail image url, displayed on top or the left of the card.
-    "ratio"         Optional ratio of the thumbnail image, defaults to "16x9" (stacked orientation) or "1x1" (horizontal
-                    orientation).
-    "alt"           Optional alternate text for the thumbnail, uses "title" by default.
-    "icon"          Optional Font Awesome icon, displayed on top or the left of the card.
-    "orientation"   Optional placecement of the thumbnail or icon, either "stacked" (default), "horizontal",
-                    "horizontal-sm" or "none".
 -->
 
+<!-- Validate and initialize arguments -->
+{{ if partial "utilities/IsInvalidArgs.html" (dict "structure" "card" "args" .) }}
+    {{- errorf "partial [assets/card.html] - Invalid arguments" -}}
+{{ end }}
+
+<!-- Initialize arguments and default values -->
+{{- $alt := .alt -}}
+{{- $class := .class -}}
+{{- $color := .color -}}
+{{- $description := .description -}}
+{{- $footer := .footer | default "none" -}}
+{{- $gutter := .gutter | default "0" -}}
+{{- $header := .header | default "full" -}}
+{{- $href := .href -}}
+{{- $icon := .icon -}}
+{{- $loading := .loading -}}
+{{- $orientation := .orientation | default "stacked" -}}
+{{- $padding := .padding | default "auto" -}}
+{{- $ratio := .ratio -}}
+{{- $thumbnail := .thumbnail -}}
+{{- $title := .title -}}
+
+<!-- Override arguments -->
+{{- $page := "" }}
+{{- if .path }}
+    {{- $page = site.GetPage .path }}
+    {{- if not $page }}
+        {{- errorf "partial [assets/card.html] - Cannot find page: %s" .path -}}
+    {{- end }}
+{{- end }}
+{{- with $page -}}
+    {{- if not $title }}{{ $title = .Title }}{{ end -}}
+    {{- if not $href }}{{ $href = .RelPermalink  }}{{ end -}}
+    {{- if not $description }}{{ $description = partial "utilities/GetDescription.html" . }}{{ end -}}
+    {{- if not $thumbnail }}{{ $thumbnail = (or (and (reflect.IsMap .Params.Thumbnail) .Params.Thumbnail.url) .Params.Thumbnail) }}{{ end -}}
+    {{- if not $icon }}{{ $icon = .Params.icon }}{{ end -}}
+{{- end -}}
+
+{{- if eq $orientation "none" }}{{ $thumbnail = "" }}{{ $icon = "" }}{{ end -}}
+
 <!-- Inline partial to render the card's body -->
 {{- define "partials/card-body.html" -}}
     {{- $title := .title -}}
@@ -77,82 +95,16 @@
     </small></p>
 {{- end -}}
 
-{{- $page := "" }}
+<!-- Main code -->
-{{- if .path }}
-    {{- $page = site.GetPage .path }}
-    {{- if not $page }}
-        {{- errorf "partial [assets/card.html] - Cannot find page: %s" .path -}}
-    {{- end }}
-{{- end }}
-
-{{- $title := .title -}}
-{{- $alt := .alt -}}
-{{- $href := .href -}}
-{{- $description := .description -}}
-{{- $thumbnail := .thumbnail -}}
-{{- $ratio := .ratio -}}
-{{- $icon := .icon -}}
-
-{{- $color := "" -}}
-{{- with .color }}{{ $color = . }}{{ end -}}
-{{- if $color -}}
-    {{- $supportedColors := slice "primary" "secondary" "success" "danger" "warning" "info" "light" "dark" "white" "black" "body" "body-tertiary" -}}
-    {{- if not (in $supportedColors $color) -}}
-        {{- errorf "partial [assets/card.html] - Invalid value for param 'color': %s" $color -}}
-    {{- end -}}
-{{- end -}}
-
-{{- $header := "full" -}}
-{{- with .header }}{{ $header = . }}{{ end -}}
-{{- $supportedKeywords := slice "full" "publication" "tags" "none" -}}
-{{- if not (in $supportedKeywords $header) -}}
-    {{- errorf "partial [assets/card.html] - Invalid value for param 'header': %s" $header -}}
-{{- end -}}
-
-{{- $footer := "none" -}}
-{{- with .footer }}{{ $footer = . }}{{ end -}}
-{{- if not (in $supportedKeywords $footer) -}}
-    {{- errorf "partial [assets/card.html] - Invalid value for param 'footer': %s" $footer -}}
-{{- end -}}
-
-{{- with $page -}}
-    {{- if not $title }}{{ $title = .Title }}{{ end -}}
-    {{- if not $href }}{{ $href = .RelPermalink  }}{{ end -}}
-    {{- if not $description }}{{ $description = partial "utilities/GetDescription.html" . }}{{ end -}}
-    {{- if not $thumbnail }}{{ $thumbnail = (or (and (reflect.IsMap .Params.Thumbnail) .Params.Thumbnail.url) .Params.Thumbnail) }}{{ end -}}
-    {{- if not $icon }}{{ $icon = .Params.icon }}{{ end -}}
-{{- end -}}
-
-{{- $class := .class -}}
-
-{{- $padding := "auto" -}}
-{{- with .padding }}{{ $padding = . }}{{ end -}}
-{{- $supportedPaddings := slice "0" "1" "2" "3" "4" "5" "auto" -}}
-{{- if not (in $supportedPaddings $padding) -}}
-    {{- errorf "partial [assets/card.html] - Invalid value for param 'padding': %s" $padding -}}
-{{- end -}}
-
-{{- $gutter := .gutter | default "0" -}}
-{{ $supportedGutters:= slice "0" "1" "2" "3" "4" "5" -}}
-{{ if not (in $supportedGutters $gutter) -}}
-    {{- errorf "partial [assets/card.html] - Invalid value for param 'gutter': %s" $gutter -}}
-{{ end -}}
-
-{{- $orientation := "stacked" -}}
-{{- with .orientation }}{{ $orientation = . }}{{ end -}}
-{{- $supportedOrientations := slice "stacked" "horizontal" "horizontal-sm" "none" -}}
-{{- if not (in $supportedOrientations $orientation) -}}
-    {{- errorf "partial [assets/card.html] - Invalid value for param 'orientation': %s" $orientation -}}
-{{- end -}}
-{{- if eq $orientation "none" }}{{ $thumbnail = "" }}{{ $icon = "" }}{{ end -}}
-
 {{ if ne $gutter "0" }}<div class="g-{{ $gutter }}">{{ end }}
+
 {{- if hasPrefix $orientation "horizontal" -}}
+    <!-- Render horizontal card -->
     <div class="card {{ with $color }}bg-{{ . }} text-bg-{{ . }}{{ end }} {{ $class }}">
         <div class="row g-0 row-cols-1 h-100">
             <div class="col-4{{ if eq  $orientation "horizontal-sm" }} col-md-2{{ end }}">
                 {{- if $thumbnail -}}
-                    {{- partial "assets/image.html" (dict "url" $thumbnail "ratio" (or $ratio "1x1") "outerClass" "h-100 card-img-wrap" "innerClass" "rounded-start card-img-h100" "title" $title) -}}
+                    {{- partial "assets/image.html" (dict "url" $thumbnail "ratio" (or $ratio "1x1") "outerClass" "h-100 card-img-wrap" "innerClass" "rounded-start card-img-h100" "title" $title "loading" $loading) -}}
                 {{- else if $icon -}}
                     <div class="card-icon p-{{ $padding }} h-100 fa-wrapper d-flex align-items-center justify-content-center">
                         {{- partial "assets/icon.html" (dict "icon" (printf "%s fa-fluid fa-fw" $icon)) -}}
@@ -171,9 +123,10 @@
         </div>
     </div>
 {{- else -}}
+    <!-- Render stacked / default card -->
     <div class="card {{ with $color }}bg-{{ . }} text-bg-{{ . }}{{ end }} {{ $class }}">
         {{- if $thumbnail -}}
-            {{- partial "assets/image.html" (dict "url" $thumbnail "ratio" (or $ratio "16x9") "outerClass" "card-img-wrap" "innerClass" "card-img-top" "title" (or $alt $title)) -}}
+            {{- partial "assets/image.html" (dict "url" $thumbnail "ratio" (or $ratio "16x9") "outerClass" "card-img-wrap" "innerClass" "card-img-top" "title" (or $alt $title) "loading" $loading) -}}
         {{- else if $icon -}}
             <div class="card-icon  p-{{ $padding }}">
                 {{- partial "assets/icon.html" (dict "icon" (printf "%s fa-4x" $icon)) -}}
@@ -186,4 +139,5 @@
         </div>
     </div>
 {{- end -}}
+
 {{ if ne $gutter "0" }}</div>{{ end }}

layouts/partials/assets/carousel-item.html

@@ -5,8 +5,16 @@
 {{- $ratio := .ratio -}}
 {{- $portrait := .portrait -}}
 
-<div class="carousel-item{{ if $active }} active{{ end }}">
+{{- $loading := .loading -}}
-    {{ partial "assets/image.html" (dict "url" $src "ratio" $ratio "page" $page "innerClass" "d-block w-100" "portrait" $portrait) }}
+{{- $validSettings := slice "lazy" "eager" -}}
+{{- if $loading -}}
+    {{ if not (in $validSettings $loading) -}}
+        {{- errorf "partial [assets/carousel-item.html] - Invalid value for param 'loading': %s" $loading -}}
+    {{ end -}}
+{{- end -}}
+
+<div class="carousel-item{{ if $active }} active{{ end }}" {{ if not $active }} fetchpriority="low"{{ end }}>
+    {{ partial "assets/image.html" (dict "url" $src "ratio" $ratio "page" $page "innerClass" "d-block w-100" "portrait" $portrait "loading" $loading) }}
     <div class="carousel-caption gradient"></div>
     {{ with $caption }}
         <div class="carousel-caption d-none d-md-block">

layouts/partials/assets/image.html

@@ -21,6 +21,14 @@
                     applicable to vector graphics.
     "portrait":     Optional flag to adjust the ratio from landscape to portrait. The image itself is not rotated, only
                     the crop area is adjusted. Not applicable to vector graphics.
+    "loading":      Optional loading behavior of the image, either "eager" (default) or "lazy". The loading of lazily
+                    loaded images is deferred until the image is within scrolling range of the viewport. This should
+                    reduce the initial loading time of the website. It is recommended to lazily load only those images
+                    that are below the page fold.
+    "priority":     Optional fetch priority of the image, either "high", "low", or "auto" (default). The priority
+                    provides a hint to the browser on how it should prioritize the fetch of the image relative to other
+                    images. The implementation is experimental and currently only supported by Chrome, Edge, and Opera.
+                    (https://developer.mozilla.org/en-US/docs/Web/API/HTMLImageElement/fetchpriority#browser_compatibility).
     "outerClass":   Optional class attribute of the outer div element, e.g. "img-wrap".
     "innerClass":   Optional class attribute of the inner img element, e.g. "rounded".
     "title":        Optional alternate text of the image.
@@ -40,9 +48,7 @@
 {{- $url := .url -}}
 
 {{- $mode := false -}}
-{{- with .mode -}}
+{{- with .mode }}{{ $mode = . }}{{ end -}}
-    {{ $mode = . -}}
-{{- end -}}
 {{- $outerClass := .outerClass -}}
 {{- $innerClass := .innerClass -}}
 {{- $title := .title -}}
@@ -53,6 +59,23 @@
 {{- $modes := site.Params.main.modes | default (slice "light" "dark") -}}
 {{- $page := .page -}}
 
+{{- $loading := .loading -}}
+{{- $validSettings := slice "lazy" "eager" -}}
+{{- if $loading -}}
+    {{ if not (in $validSettings $loading) -}}
+        {{- errorf "partial [assets/image.html] - Invalid value for param 'loading'" -}}
+    {{ end -}}
+{{- end -}}
+{{- $lazy := eq $loading "lazy" -}}
+
+{{- $priority := .priority -}}
+{{- $validPriorities := slice "high" "low" "auto" -}}
+{{- if $priority -}}
+    {{ if not (in $validPriorities $priority) -}}
+        {{- errorf "partial [assets/image.html] - Invalid value for param 'priority'" -}}
+    {{ end -}}
+{{- end -}}
+{{- if eq $priority "auto" }}{{ $priority = "" }}{{ end -}}
 
 {{- define "partials/image-portrait.html" -}}
     {{- $dimensions := slice }}
@@ -68,12 +91,14 @@
             {{- $portraits = $portraits | append (printf "%sx%s" (index $p 1) (index $p 0)) -}}
         {{- end -}}
     {{- end -}}
+
     {{- $ret := "" }}
     {{- if reflect.IsSlice $dim -}}
         {{ $ret = $portraits -}}
     {{- else if gt (len $portraits) 0 -}}
         {{- $ret = index $portraits 0 -}}
     {{- end -}}
+
     {{- return $ret -}}
 {{- end -}}
 
@@ -87,29 +112,23 @@
     {{- $fallback := "" -}}
 
     {{- with $img -}}
-        {{- if eq $ratio "4x3" -}}
+        {{- if eq $ratio "4x3" -}}{{- $dim  = "1400x1050" }}
-            {{- $dim  = "1400x1050" }}
+        {{- else if eq $ratio "3x2" -}}{{- $dim  = "1400x933" }}
-        {{- else if eq $ratio "3x2" -}}
+        {{- else if eq $ratio "1x1" -}}{{- $dim  = "1400x1400" }}
-            {{- $dim  = "1400x933" }}
+        {{- else if eq $ratio "16x9" -}}{{- $dim = "1400x788" -}}
-        {{- else if eq $ratio "1x1" -}}
+        {{- else if eq $ratio "21x9" -}}{{- $dim = "1400x600" -}}
-            {{- $dim  = "1400x1400" }}
-        {{- else if eq $ratio "16x9" -}}
-            {{- $dim = "1400x788" -}}
-        {{- else if eq $ratio "21x9" -}}
-            {{- $dim = "1400x600" -}}
         {{- else -}}
             {{- $dim = printf "%sx%d" $width (int (math.Round (mul (div (float $width) $img.Width) $img.Height))) -}}
         {{- end -}}
 
-        {{- if $portrait -}}
+        {{- if $portrait -}}{{- $dim = partial "partials/image-portrait.html" (dict "dim" $dim) -}}{{- end -}}
-            {{- $dim = partial "partials/image-portrait.html" (dict "dim" $dim) -}}
-        {{- end -}}
 
         {{- if $ratio -}}
             {{- $fallback = ($img.Fill (printf "%s jpg" $dim)) -}}
         {{- else -}}
             {{- $fallback = ($img.Fit (printf "%s jpg" $dim)) -}}
         {{- end -}}
+
         {{- $clean := path.Ext $img.RelPermalink -}}
         {{- $ext := path.Ext $img.RelPermalink -}}
         {{- $fallback = $fallback | resources.Copy (replace $img.RelPermalink $clean (printf "-%s%s" $dim $ext)) -}}
@@ -158,6 +177,7 @@
             {{- else -}}
                 {{- $scaled = $img.Fit (printf "%s webp" $dim) -}}
             {{- end -}}
+
             {{- $scaled = $scaled | resources.Copy (replace $img.RelPermalink $clean (printf "-%s.webp" $dim)) -}}
             {{- if $absoluteURL -}}
                 {{- $imgset = printf "%s, %s %sw" $imgset $scaled.Permalink (index $widths $index) -}}
@@ -165,6 +185,7 @@
                 {{- $imgset = printf "%s, %s %sw" $imgset $scaled.RelPermalink (index $widths $index) -}}
             {{- end -}}
         {{- end -}}
+        
         {{- $imgset = strings.TrimPrefix ", " $imgset -}}
     {{- end -}}
 
@@ -186,7 +207,9 @@
     {{- $imgset := "" -}}
     {{- $mode := .mode -}}
     {{- $modes := .modes -}}
+    {{- $lazy := .lazy -}}
     {{- $page := .page -}}
+    {{- $priority := .priority -}}
     {{- $isVector := false -}}
 
     {{- $segments := split $url "#" -}}
@@ -200,15 +223,26 @@
     {{- if hasSuffix $url "svg" -}}
         {{- $fallbackURL = $url -}}
         {{- $isVector = true -}}
+        {{- $res := partial "utilities/GetResource.html" (dict "url" $url "page" $page) -}}
+        {{ if not $res }}
+            {{- if not (fileExists (path.Join "/static" $url)) -}}
+                {{ warnf "Cannot find vector image resource: %q" $url -}}
+            {{ end }}
+        {{ end }}
     {{- else -}}
-        {{- $img := partial "utilities/GetImage.html" (dict "url" $url "page" $page) -}}
+        {{- $res := partial "utilities/GetImage.html" (dict "url" $url "page" $page) -}}
+        {{- $img := "" -}}
+        {{ with $res }}
+            {{ $img = $res.resource }}
+            {{ if $res.mirror }}{{ $innerClass = printf "%s mirrorred" $innerClass }}{{ end }}
+        {{ end }}
         {{- if $img -}}
             {{- $fallback := partial "partials/image-default.html" (dict "img" $img "ratio" $ratio "portrait" $portrait) -}}
-                {{- if $absoluteURL -}}
+            {{- if $absoluteURL -}}
-                    {{- $fallbackURL = $fallback.Permalink -}}
+                {{- $fallbackURL = $fallback.Permalink -}}
-                {{- else -}}
+            {{- else -}}
-                    {{- $fallbackURL = $fallback.RelPermalink -}}
+                {{- $fallbackURL = $fallback.RelPermalink -}}
-                {{- end -}}
+            {{- end -}}
             {{- $imgset = partial "partials/image-scaled.html " (dict "img" $img "ratio" $ratio "portrait" $portrait) -}}
         {{- end -}}
     {{- end -}}
@@ -219,30 +253,33 @@
         {{- end -}}
     {{- end -}}
 
+    {{- $width := "" -}}
+    {{- $height := "" -}}
+    {{- $input := (split (path.BaseName $fallbackURL) "-") | collections.Reverse -}}
+    {{ if $isVector }}
+        {{- $height = "500" -}}
+        {{ $width = string (partial "utilities/GetWidth.html" (dict "path" $fallbackURL "height" 500)) }}
+    {{- else if gt ($input | len) 1 -}}
+        {{- $dim := (split (index $input 0) "x") -}}
+        {{- if eq ($dim | len) 2 -}}
+            {{- $width = index $dim 0 -}}
+            {{- $height = index $dim 1 -}}
+        {{- end -}}
+    {{- end }}
+
     {{- if $caption -}}
         <figure {{ with $outerClass }}class="{{ . }}"{{ end }}>
     {{ end }}
-    <div class="{{ if not $caption }}{{ $outerClass }}{{ end }}">
+    <div class="{{ if not $caption }}{{ $outerClass }}{{ end }}">        
         {{- if not $anchor -}}
-            {{- $input := (split (path.BaseName $fallbackURL) "-") | collections.Reverse -}}
-            {{- $width := "" -}}
-            {{- $height := "" -}}
-            {{- if gt ($input | len) 1 -}}
-                {{- $dim := (split (index $input 0) "x") -}}
-                {{- if eq ($dim | len) 2 -}}
-                    {{- $width = index $dim 0 -}}
-                    {{- $height = index $dim 1 -}}
-                {{- end -}}
-            {{- end }}
             <img class="img-fluid {{ $innerClass }}"
-                {{ with $imgset -}}
-                srcset="{{ . }}"
-                sizes="100vw"
-                {{- end }}
                 src="{{ $fallbackURL }}"
+                {{ if $lazy }}loading="lazy"{{ end }}
+                {{ with $priority }}fetchpriority="{{ . }}"{{ end }}
+                {{ with $imgset -}}srcset="{{ . }}" sizes="100vw"{{- end }}
                 {{ with $height }}height="{{ . }}"{{ end }}
                 {{ with $width }}width="{{ . }}"{{ end }}
-                alt="{{ $title }}">
+                {{ with $title }}alt="{{ . }}"{{ end }}>
         {{- else }}
             <svg class="{{ $innerClass }}">
                 <use href="{{ $fallbackURL }}#{{ $anchor }}"></use>
@@ -250,12 +287,26 @@
         {{ end }}
     </div>
     {{- if $caption -}}
-        <figcaption class="figure-caption">{{ $caption | safeHTML }}</figcaption>
+            <figcaption class="figure-caption">{{ $caption | safeHTML }}</figcaption>
-    </figure>
+        </figure>
     {{- end -}}
 {{- end -}}
 
+
 <!-- Initiate the regular or color-mode image -->
+{{ $params := dict }}
+{{- $params = merge $params (dict
+    "ratio" $ratio
+    "portrait" $portrait
+    "outerClass" $outerClass
+    "innerClass" $innerClass
+    "title" $title
+    "caption" $caption
+    "lazy" $lazy
+    "priority" $priority
+    "page" $page)
+-}}
+
 {{- if $mode -}}
     {{- $ext := path.Ext $url -}}
     {{- $base := strings.TrimSuffix $ext $url -}}
@@ -265,28 +316,14 @@
 
     {{- range $suffix := $modes -}}
         {{- $image := printf "%s-%s%s" $base $suffix $ext -}}
-        {{- partial "partials/image-definition.html" (dict 
+        {{- $params = merge $params (dict
-            "ratio" $ratio
-            "portrait" $portrait
             "url" $image
-            "outerClass" $outerClass
-            "innerClass" $innerClass
-            "title" $title
-            "caption" $caption
             "mode" $suffix
-            "modes" $modes
+            "modes" $modes)
-            "page" $page)
         -}}
+        {{- partial "partials/image-definition.html" $params -}}
     {{- end -}}
-{{- else -}}
+{{ else }}
-    {{- partial "partials/image-definition.html" (dict 
+    {{- $params = merge $params (dict "url" $url) -}}
-        "ratio" $ratio
+    {{- partial "partials/image-definition.html" $params -}}
-        "portrait" $portrait
-        "url" $url
-        "outerClass" $outerClass
-        "innerClass" $innerClass
-        "title" $title
-        "caption" $caption
-        "page" $page)
-    -}}
 {{- end -}}

layouts/partials/assets/list.html

@@ -28,7 +28,9 @@
     {{- $thumbnail := .thumbnail -}}
     {{- $style := .style -}}
     {{- $mode := .mode -}}
-    {{- partial "assets/image.html" (dict "url" $thumbnail "outerClass" $style "mode" $mode) -}}
+    {{- $title := .title -}}
+    {{- $loading := .loading -}}
+    {{- partial "assets/image.html" (dict "url" $thumbnail "title" $title "outerClass" $style "mode" $mode "loading" $loading) -}}
 {{- end -}}
 
 {{- $page := .page -}}
@@ -49,6 +51,14 @@
 {{ $vertical := false }}
 {{ $type := "pills" }}
 
+{{- $loading := .loading -}}
+{{- $validSettings := slice "lazy" "eager" -}}
+{{- if $loading -}}
+    {{ if not (in $validSettings $loading) -}}
+        {{- errorf "partial [assets/list.html] - Invalid value for param 'loading': %s" $loading -}}
+    {{ end -}}
+{{- end -}}
+
 <div class="d-none d-md-block p-0">
     {{- range $index, $item := $list -}}
         {{- $odd := eq (mod $index 2) 1 -}}
@@ -61,7 +71,7 @@
                         {{- $style = "reveal fade-bottom-n5 rotate-n5 ps-3" -}}
                         {{- if $odd }}{{ $style = "reveal fade-bottom-5 rotate-5 pe-3" }}{{ end }}
                     {{ end }}
-                    {{ partial "partials/list-img.html" (dict "thumbnail" $thumbnail "style" $style "mode" $item.Params.colormode) }}
+                    {{ partial "partials/list-img.html" (dict "thumbnail" $thumbnail "title" $item.Title "style" $style "mode" $item.Params.colormode "loading" $loading) }}
                 </div>
                 <div class="col-6{{ if $odd }} order-first{{ end }} psw-lg-5 p-5">
                     {{ partial "partials/list-content.html" (dict "title" $item.Title "content" (or $item.Description $item.Content)) }}
@@ -78,7 +88,7 @@
         <div class="container d-flex flex-column">
             <div class="row pt-5 pb-5 align-items-center flex-fill row-cols-2">
                 <div class="col-12 text-center">
-                    {{ partial "partials/list-img.html" (dict "thumbnail" $thumbnail "mode" $item.Params.colormode) }}
+                    {{ partial "partials/list-img.html" (dict "thumbnail" $thumbnail "title" $item.Title "mode" $item.Params.colormode "loading" $loading) }}
                 </div>
                 <div class="col-12 p-3">
                     {{ partial "partials/list-content.html" (dict "title" $item.Title "content" (partial "utilities/GetDescription.html" $item)) }}

layouts/partials/assets/nav-item.html

@@ -10,6 +10,8 @@
     "body"          The body content of the nav-item, supports Markdown and HTML (if enabled).
     "show"          Optional flag to indicate the item should be shown as expanded (only one can be shown at a time).
     "disabled"      Optional flag to indicate the item should be in a disabled state.
+    "type"          Optional type of the item to render, supports "accordion" as alternative format. Defaults to
+                    "tab-pane".
 -->
 
 {{- $id := .id -}}
@@ -21,9 +23,33 @@
 {{- $body := .body -}}
 {{- $show := .show -}}
 {{- $disabled := .disabled -}}
+{{- $type := .type -}}
+{{- $illustration := .illustration -}}
 
-<div class="tab-pane{{ if $show }} active {{ if $fade }}show{{ end }}{{ end }} {{ if $fade}}fade{{ end }}{{ with $class }} {{ . }}{{ end }}" id="{{ $parentID }}-{{ $id }}" 
+{{ if eq $type "accordion" }}
-    role="tabpanel" aria-labelledby="{{ $parentID }}-btn-{{ $id }}" tabindex="0" data-header="{{ $header }}" {{ if $show }}data-show-id="{{ $id }}"{{ end }} 
+    <div class="accordion-item{{ if $show }} show{{ end }}{{ with $class }} {{ . }}{{ end }}">
-    data-has-content="{{ gt (len $body) 0 }}" {{ if $disabled }} data-disabled-id="{{ $id }}"{{ end }}>
+        {{- with $header -}}
-    {{ $body }}
+            <h2 class="accordion-header m-0" id="accordion-{{ $parentID }}-heading-{{ $id }}">
-</div>
+                <button class="accordion-button collapsed {{ if $disabled }} text-secondary{{ end }}" type="button" data-bs-toggle="collapse" data-bs-target="#accordion-{{ $parentID }}-item-{{ $id }}" aria-expanded="false" aria-controls="accordion-{{ $parentID }}-item-{{ $id }}"{{ if $disabled }} disabled{{ end }}>
+                    {{ if $illustration }}
+                        <div class="row">
+                            <div class="col-3 col-sm-2 my-auto">{{ $illustration | safeHTML }}</div>
+                            <div class="col-9 col-sm-10 fs-6 fs-sm-5 my-auto">{{ . }}</div>
+                        </div>
+                    {{ else }}
+                        {{ . }}
+                    {{ end }}
+                </button>
+            </h2>
+        {{- end -}}
+        <div id="accordion-{{ $parentID }}-item-{{ $id }}" class="accordion-collapse collapse{{ with $class }} {{ . }}{{ end }}" aria-labelledby="{{ $parentID }}-heading-{{ $id }}" data-bs-parent="#accordion-{{ $parentID }}">
+            <div class="accordion-body">{{- $body | safeHTML -}}</div>
+        </div>
+    </div>
+{{ else }}
+    <div class="tab-pane{{ if $show }} active {{ if $fade }}show{{ end }}{{ end }} {{ if $fade}}fade{{ end }}{{ with $class }} {{ . }}{{ end }}" id="{{ $parentID }}-{{ $id }}" 
+        role="tabpanel" aria-labelledby="{{ $parentID }}-btn-{{ $id }}" tabindex="0" data-header="{{ $header }}" {{ if $show }}data-show-id="{{ $id }}"{{ end }} 
+        data-has-content="{{ gt (len $body) 0 }}" {{ if $disabled }} data-disabled-id="{{ $id }}"{{ end }}>
+        {{ $body }}
+    </div>
+{{ end }}

layouts/partials/assets/nav.html

@@ -4,7 +4,7 @@
     "page"          Required context of the current page.
     "list"          Required array of pages.
     "title"         Optional title of the tab group.
-    "type"          Optional type of the tab group, either "tabs", "pills" (default), or "underline".
+    "type"          Optional type of the tab group, either "tabs", "pills" (default), "underline" or "callout".
     "vertical"      Optional flag to show vertical tabs instead of horizontal tabs (default).
     "class"         Optional class attribute of the tab group, e.g. “nav-fill”.
     "pane"          Optional style of the panes, either "none" (default) or "persona".
@@ -70,7 +70,7 @@
 {{ $type := "pills" }}
 {{ with .type }}
     {{ $type = . -}}
-    {{ $supportedNavTypes := slice "tabs" "pills" "underline" -}}
+    {{ $supportedNavTypes := slice "tabs" "pills" "underline" "callout" -}}
     {{ if $type }}
         {{ if not (in $supportedNavTypes $type) -}}
             {{ errorf "partial [assets/nav.html] - Invalid value for param 'type': %s" $type -}}
@@ -78,8 +78,39 @@
     {{ end -}}
 {{ end -}}
 
-<div class="{{ if eq $width 50 }}col-sm-12 col-md-10 col-lg-8 col-xl-6{{ else }}col-12{{ end }} mx-auto pt-5 pb-5">
+{{- $loading := .loading -}}
+{{- $validSettings := slice "lazy" "eager" -}}
+{{- if $loading -}}
+    {{ if not (in $validSettings $loading) -}}
+        {{- errorf "partial [assets/nav.html] - Invalid value for param 'loading': %s" $loading -}}
+    {{ end -}}
+{{- end -}}
+
+<div class="{{ if eq $width 50 }}col-sm-12 col-md-10 col-lg-8 col-xl-6{{ else }}col-12{{ end }} mx-auto">
     {{ if $vertical }}<div class="d-flex align-items-start">{{ end }}
+    {{ if eq $type "callout" }}
+        <div class="d-lg-none">
+            <div id="accordion-{{ $id }}" class="accordion mb-3{{ with $class }} {{ . }}{{ end }} nav-callout">
+                {{- range $index, $item := $list -}}
+                    {{ partial "assets/nav-item" (dict 
+                        "id" $index
+                        "parentID" $id
+                        "fade" false
+                        "header" $item.Title
+                        "class" $class
+                        "body" (or $item.Description $item.Content)
+                        "show" false
+                        "disabled" false
+                        "type" "accordion"
+                        "illustration" (partial "utilities/GetIllustration.html" (dict "item" $item "size" "col-12"))
+                        )
+                    }}
+                {{ end -}}
+            </div>
+        </div>
+        <div class="d-none d-lg-block">
+    {{ end }}
+
     <div class="nav{{ with $type }} nav-{{ . }}{{ end }}{{ with $class }} {{ . }}{{ end }}{{ if $vertical }} flex-column{{ end }}" id="nav-{{ $id }}" role="tablist"{{ if $vertical }} aria-orientation="vertical"{{ end }}>
         {{- range $index, $item := $list -}}
             {{ $show := eq $index 0}}
@@ -88,28 +119,39 @@
                 {{ $item.Title }}
             </button>
         {{ end -}}
+
+        <div class="tab-content {{ if eq $type "tabs" }}border border-bottom-0  p-3{{ else if $vertical }}ms-3{{ else }}mt-3{{ end }}">
+            {{ range $index, $item := $list }}
+                {{ $header := $item.Title }}
+                {{ $body := $item.Content }}
+                {{ $show := eq $index 0}}
+                {{- $thumbnail := (or (and (reflect.IsMap $item.Params.Thumbnail) $item.Params.Thumbnail.url) $item.Params.Thumbnail) -}}
+                <div class="tab-pane{{ if $show }} active{{ end }}" id="nav-{{ $id }}-{{ $index }}" role="tabpanel" aria-labelledby="{{ $id }}-btn-{{ $index }}" tabindex="0">
+                    {{- if eq $pane "persona" -}}
+                        {{- partial "assets/persona.html" (dict  
+                            "title" $item.Title
+                            "class" $class
+                            "color" $color
+                            "content" (partial "utilities/GetDescription.html" $item)
+                            "thumbnail" $thumbnail
+                            "loading" $loading
+                        ) -}}
+                    {{- else -}}
+                        {{ $illustration := (partial "utilities/GetIllustration.html" (dict "item" $item)) }}
+                        {{ if $illustration }}
+                            <div class="row">
+                                <div class="col-12 col-lg-10 order-1 order-lg-0">{{- (or $item.Description $item.Content) -}}</div>
+                                <div class="col-12 col-lg-2 order-0 order-lg-1">{{ $illustration | safeHTML }}</div>
+                            </div>
+                        {{ else }}
+                            {{- (or $item.Description $item.Content) -}}
+                        {{ end }}
+                    {{- end -}}
+                </div>    
+            {{ end }}
+        </div>
     </div>
 
-    <div class="tab-content {{ if eq $type "tabs" }}border border-top-0 p-3{{ else if $vertical }}ms-3{{ else }}mt-3{{ end }}">
+    {{ if eq $type "callout" }}</div>{{ end }}
-        {{ range $index, $item := $list }}
-            {{ $header := $item.Title }}
-            {{ $body := $item.Content }}
-            {{ $show := eq $index 0}}
-            {{- $thumbnail := (or (and (reflect.IsMap $item.Params.Thumbnail) $item.Params.Thumbnail.url) $item.Params.Thumbnail) -}}
-            <div class="tab-pane{{ if $show }} active{{ end }}" id="nav-{{ $id }}-{{ $index }}" role="tabpanel" aria-labelledby="{{ $id }}-btn-{{ $index }}" tabindex="0">
-                {{- if eq $pane "persona" -}}
-                {{- partial "assets/persona.html" (dict  
-                    "title" $item.Title
-                    "class" $class
-                    "color" $color
-                    "content" (partial "utilities/GetDescription.html" $item)
-                    "thumbnail" $thumbnail
-                ) -}}
-                {{- else -}}
-                    {{- (or $item.Description $item.Content) -}}
-                {{- end -}}
-            </div>    
-        {{ end }}
-    </div>
     {{ if $vertical }}</div>{{ end }}
 </div>

layouts/partials/assets/navbar.html

@@ -14,7 +14,7 @@
     "logo"          Optional address of the logo image, defaults to the parameter "logo" set in the "main" section of
                     the site's parameter configuration. 
     "title"         Optional brand title, displayed when the logo is not set. Defaults to the site's title.
-    "class":        Optional class attribute of the navbar container.
+    "class"         Optional class attribute of the navbar container.
 -->
 
 <!-- Inline partial to render the color mode switcher -->
@@ -68,7 +68,7 @@
             {{- range $index, $item := $list -}}
                 {{- $active := eq $item.label $version -}}
                 {{- $disabled := false -}}
-                {{- if site.IsServer }}
+                {{- if hugo.IsServer }}
                     {{- $disabled = and $item.redirect (gt (len $item.redirect) 0) -}}
                 {{- end -}}
                 {{ if $item.url }}
@@ -156,7 +156,6 @@
 {{- end -}}
 {{- $searchModal := and $search site.Params.navigation.searchModal -}}
 
-
 {{- $enableDarkMode := default false site.Params.main.enableDarkMode -}}
 {{- with .mode -}}
     {{- $darkModeParam := . -}}
@@ -175,6 +174,8 @@
 
 {{- $enableLanguage := or $page.IsTranslated site.IsMultiLingual -}}
 
+{{- $horizontal := default false site.Params.navigation.horizontal -}}
+
 {{- $logo := site.Params.navigation.logo -}}
 {{- $logoLight := "" -}}
 {{- $logoDark := "" -}}
@@ -223,24 +224,24 @@
 
 <div class="container-fluid {{ if $fixed }}fixed-top{{ end }} p-0{{ with $class }} {{ . }}{{ end }}">
     {{- partial "assets/page-alert.html" (dict "page" $page) -}}
-    <nav class="navbar {{ if $fixed }}navbar-fixed-top{{ end }}  navbar-expand-{{ $size }}{{ if $contrast }} navbar-contrast{{ end }}{{ with $color }} bg-{{ . }}{{ end }} p-4"{{ with $theme }} data-bs-theme="{{ . }}"{{ end }}>
+    <nav class="navbar {{ if $fixed }}navbar-fixed-top{{ end }} navbar-expand-{{ $size }}{{ if $contrast }} navbar-contrast{{ end }}{{ with $color }} bg-{{ . }}{{ end }} p-4"{{ with $theme }} data-bs-theme="{{ . }}"{{ end }}>
         <div class="container-xxl p-0">
             <!-- Insert sidebar toggler when applicable -->
-            <div class="d-flex">
+            <div class="d-flex align-items-center">
                 {{- if $page.Scratch.Get "sidebar" -}}
-                    <button class="navbar-toggler fw-30 collapsed p-0 mx-auto" type="button" data-bs-toggle="offcanvas" data-bs-target="#offcanvass-sidebar" aria-controls="offcanvass-sidebar" aria-label="{{ T "toggleSidebar" }}">
+                    <button class="navbar-toggler collapsed p-0 mx-auto" type="button" data-bs-toggle="offcanvas" data-bs-target="#offcanvass-sidebar" aria-controls="offcanvass-sidebar" aria-label="{{ T "toggleSidebar" }}">
                         {{- partial "assets/icon.html" (dict "icon" "fas ellipsis fa-fw") -}}
                     </button>
                 {{- else -}}
                     <!-- Insert invisible sidebar toggler to center logo correctly on smaller screens -->
-                    <button class="navbar-toggler fw-30 collapsed p-0 mx-auto invisible" type="button">
+                    <button class="navbar-toggler collapsed p-0 mx-auto invisible" type="button">
                         {{- partial "assets/icon.html" (dict "icon" "fas ellipsis fa-fw") -}}
                     </button>
                 {{- end -}}
             </div>
     
             <!-- Insert the brand logo or name -->
-            <a class="navbar-brand mx-auto" href="{{ site.Home.RelPermalink }}">
+            <a class="navbar-brand mx-auto" href="{{ site.Home.RelPermalink }}" aria-label="{{ T "home" }}">
                 {{- if (and $logoLight $logoDark) -}}
                     {{ $width := partial "utilities/GetWidth.html" (dict "path" $logoLight "height" 30) }}
                     <img src="{{if $absoluteURL }}{{ absURL $logoLight }}{{ else }}{{ $logoLight }}{{ end }}" class="d-none-dark" alt="{{ $title }} logo" height="30"{{ with $width }} width="{{ . }}"{{ end }}>
@@ -254,7 +255,7 @@
             </a>
     
             <!-- Insert main navigation toggler -->
-            <div class="d-flex fw-30">
+            <div class="d-flex">
                 <button class="navbar-toggler main-nav-toggler collapsed p-0" type="button" data-bs-toggle="collapse" data-bs-target="#{{ $id }}-collapse"
                     aria-controls="{{ $id }}" aria-expanded="false" aria-label="{{ T "toggleMainNav" }}">
                     <span class="toggler-icon top-bar emphasis{{ with $theme }}-{{ . }}{{ end }}"></span>
@@ -270,10 +271,10 @@
                 <!-- Render top-menu items (maximum depth of 2) -->
                 <ul class="navbar-nav ms-auto">
                     {{- range $menu := $menus -}}
-                        <li class="nav-item{{ if .HasChildren }} dropdown{{ end }}">
+                        <li class="nav-item{{ if .HasChildren }} dropdown{{ if $horizontal }} dropdown-horizontal-{{ $size }}{{ end }}{{ end }}">
                             {{- partial "assets/navbar-item.html" (dict "menu" $menu "page" $page) -}}
                             {{- if .HasChildren -}}
-                                <ul class="dropdown-menu dropdown-menu-end">
+                                <ul class="dropdown-menu">
                                     {{- range .Children -}}
                                         <li>{{- partial "assets/navbar-item.html" (dict "menu" . "parent" $menu "page" $page) -}}</li>
                                     {{- end -}}
@@ -359,8 +360,8 @@
                     </div>
                     <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="{{ T "close" }}"></button>
                 </div>
-                <div class="modal-body p-2">
+                <div class="modal-body p-2 search-background">
-                    <div class="search-suggestions bg-body" data-no-results="{{ T "ui_no_results" }}"></div>
+                    <div class="search-suggestions" data-no-results="{{ T "ui_no_results" }}"></div>
                 </div>
             </div>
         </div>

layouts/partials/assets/persona.html

@@ -56,12 +56,20 @@
 
 {{- $class := .class -}}
 
+{{- $loading := .loading -}}
+{{- $validSettings := slice "lazy" "eager" -}}
+{{- if $loading -}}
+    {{ if not (in $validSettings $loading) -}}
+        {{- errorf "partial [assets/persona.html] - Invalid value for param 'loading': %s" $loading -}}
+    {{ end -}}
+{{- end -}}
+
 <div class="d-none d-md-block">
     <div class="persona position-relative row mt-5 align-middle p-3">
         <div class="col-2">
             <div class="position-absolute top-50 start-0 translate-middle-y col-4 ps-3">
                 {{- if $thumbnail -}}
-                    {{- partial "assets/image.html" (dict "url" $thumbnail "ratio" "1x1" "innerClass" "rounded-5") -}}
+                    {{- partial "assets/image.html" (dict "url" $thumbnail "title" $title "ratio" "1x1" "innerClass" "rounded-5" "loading" $loading) -}}
                 {{ end }}
             </div>
         </div>
@@ -81,7 +89,7 @@
         <div class="col-12">
             <div class="position-absolute top-25 start-50 translate-middle col-6">
                 {{- if $thumbnail -}}
-                    {{- partial "assets/image.html" (dict "url" $thumbnail "ratio" "1x1" "innerClass" "rounded-5") -}}
+                    {{- partial "assets/image.html" (dict "url" $thumbnail "title" $title "ratio" "1x1" "innerClass" "rounded-5" "loading" $loading) -}}
                 {{ end }}
             </div>
         </div>

layouts/partials/assets/section-list.html

@@ -1,7 +1,7 @@
 {{- $page := .page }}
 {{- $section := .section }}
 {{- if not $section }}{{ errorf "partial [assets/section-list.html] - Missing value for param 'section'" }}{{ end -}}
-{{- $home := .home }}
+{{- $home := .home | default false }}
 {{ if ne (printf "%T" $home) "bool" }}
     {{ errorf "partial [assets/section-list.html] - Invalid value for param 'home'"}}
 {{ end }}
@@ -36,13 +36,15 @@
 {{- $width := 100 -}}
 {{- $ratio := "" -}}
 {{- $wrap := false -}}
+{{- $loading := .loading -}}
+{{- $wrapper := .wrapper | default "p-4 px-xxl-0 pb-5" -}}
 
 {{- with (index site.Params.sections $section) -}}
     {{- with index . "title" }}{{ $title = or $.title . }}{{ end -}}
     {{- with index . "sectionHeader" }}{{ $sectionHeader = . }}{{ end -}}
     {{- with index . "sort" }}{{ $sort = . }}{{ end -}}
     {{- if (index . "reverse") }}{{ $order = "desc" }}{{ else }}{{ $order = "asc" }}{{ end -}}
-    {{- if $home }}{{- if (isset . "nested") }}{{ $nested = (index . "nested") }}{{ end -}}{{ end -}}
+    {{- if (isset . "nested") }}{{ $nested = (index . "nested") }}{{ end -}}
     {{- if (index . "separator") }}{{ $separator = true }}{{ else }}{{ $separator = false }}{{ end -}}
     {{- with index . "orientation" }}{{ $orientation = . }}{{ end -}}
     {{- with index . "cols" }}{{ $cols = . }}{{ end -}}
@@ -62,6 +64,10 @@
     {{- with index . "ratio" }}{{ $ratio = . }}{{ end -}}
     {{- with index . "wrap" }}{{ $wrap = . }}{{ end -}}
 {{- end -}}
+
+{{ if isset $page.Params "nested" }}
+    {{ $nested = $page.Params.nested }}
+{{ end }}
 {{ if ne (printf "%T" $nested) "bool" }}
     {{ errorf "partial [assets/section-list.html] - Invalid value for param 'nested'"}}
 {{ end }}
@@ -76,13 +82,25 @@
     {{ else }}
         {{ $list = where site.Pages (printf ".Params.%s" $section) "!=" nil }}
     {{ end }}
-{{ else if $nested }}
+{{ else if eq $kind "related" }}
-    {{ $list = where site.RegularPages "Type" "in" $section }}
+    {{ if $page.Keywords}}
+        {{ $keywords := keyVals "tags" $page.Keywords }}
+        {{ $opts := dict "namedSlices" (slice $keywords) }}
+        {{ $list = site.RegularPages.Related $opts }}
+    {{ end }}
 {{ else if $home }}
     {{ $sectionPage := site.GetPage "section" $section }}
-    {{ $list = $sectionPage.RegularPages }}
+    {{ if $nested }}
+        {{ $list = $sectionPage.RegularPagesRecursive }}
+    {{ else }}
+        {{ $list = $sectionPage.Pages }}
+    {{ end }}
 {{ else }}
-    {{ $list = $page.RegularPages }}
+    {{ if $nested }}
+        {{ $list = $page.RegularPagesRecursive }}
+    {{ else }}
+        {{ $list = $page.Pages }}
+    {{ end }}
 {{ end }}
 
 {{ $max := (len $list) -}}
@@ -99,7 +117,7 @@
 {{- end -}}
 
 {{ if gt $max 0 }}
-    {{- if $home -}}
+    {{- if or $home (eq $kind "related") -}}
         {{- $paginate = false -}}
         {{- $max = int (math.Min $homepage $max) -}}
     {{ end -}}
@@ -121,12 +139,13 @@
         "content" $content
         "class" $style
         "color" $color
+        "loading" $loading
         )
     -}}
     {{- $partial := "" -}}
 
     <div class="container-fluid {{ with $background }} bg-{{ . }}{{ end }} p-0">
-        <div class="container-xxl flex-fill p-4 px-xxl-0 pb-5">
+        <div class="container-xxl {{ $wrapper }}">
             {{- partial "assets/section-header.html" $params -}}
             
             {{ if eq $layout "card" }}

layouts/partials/assets/section-menu.html

@@ -5,7 +5,31 @@
 {{ end }}
 
 {{- if gt (len $items) 0 }}
-    <nav class="navbar navbar-expand navbar-services p-0 fs-5">
+    <div class="d-grid gap-2 mx-auto d-md-none">
+        {{ partial "assets/button.html" (dict 
+            "title" (T "sectionMenu") 
+            "color" "secondary" 
+            "outline" "true" 
+            "class" "toc-button" 
+            "icon" "fas sort"
+            "justify" "between"
+            "collapse" "toc-collapse"
+            "order" "last") 
+        -}}
+    </div>
+
+    <p>
+        <div class="collapse border bg-body-tertiary rounded p-1 navbar-nav-scroll" id="toc-collapse">
+            <div class="toc toc-panel section-menu text-body p-2 fs-6">
+                    {{- range $items }}
+                        {{ $active := eq $page.RelPermalink .RelPermalink }}
+                        <a class="nav-link{{ if $active }} active{{ end }}" href="{{ .RelPermalink }}">{{ .Title }}</a>
+                    {{- end }}
+            </div>
+        </div>
+    </p>
+
+    <nav class="navbar navbar-expand navbar-services p-0 fs-5 d-none d-md-block">
         <div class="container-fluid p-0 pb-3">
             <div class="collapse navbar-collapse" id="navbarNav">
                 <ul class="navbar-nav">

layouts/partials/assets/sharing.html

@@ -1,11 +1,28 @@
 {{- if .Site.Params.sharing.enabled -}}
-    {{- if or .Params.sharing (not (isset .Params "sharing")) -}}
+    {{- $sharing := true -}}
+    {{ if isset .Params "sharing" }}
+        {{ $sharing = .Params.sharing }}
+    {{ else }}
+        {{- with (index site.Params.pages .Type ) -}}
+            {{ if isset . "sharing" }}
+                {{ $sharing = (index . "sharing") }}
+            {{ end }}
+        {{- end -}}
+    {{ end }}
+
+    {{- if $sharing -}}
         {{- $page := . -}}
         {{- $order := "asc" -}}
         {{- $list := .Site.Params.sharing.providers -}}
         {{- if .Site.Params.sharing.reverse }}{{ $order = "desc" }}{{ else }}{{ $order = "asc" }}{{ end -}}
         {{- $sort := .Site.Params.sharing.sort | default "weight" -}}
         {{- $list = sort $list $sort $order -}}
+
+        {{- $download := .Params.download -}}
+        {{- if and $download (not (fileExists (path.Join "static" $download))) -}}
+            {{- errorf "Cannot find download file for page '%s': %s" .File.Path $download -}}
+        {{- end -}}
+        
         <div class="py-3 text-body-secondary hstack gap-1">
             {{ T "shareLink" "" }}
             {{- range $index, $item := $list -}}
@@ -27,6 +44,10 @@
                 {{ $attr := dict "data-sharing-title" .Title "data-sharing-description" .Description "data-sharing-url" .Permalink }}
                 {{ partial "assets/button.html" (dict "href" "#!" "icon" "fas share-nodes fa-fw" "id" "btn-webshare" "class" "btn-social p-0" "attributes" $attr "label" (T "shareLink" (T "shareSystem")) "spacing" false) }}
             {{- end -}}
+            {{ with $download }}
+                {{ $attr := dict "download" (path.Base .) }}
+                {{ partial "assets/button.html" (dict "href" . "icon" "fas download fa-fw" "class" "btn-social p-0" "attributes" $attr "spacing" false) }}
+            {{- end -}}
         </div>
     {{- end -}}
 {{- end -}}

layouts/partials/assets/table.html

@@ -0,0 +1,25 @@
+{{ $page := .page }}
+{{ $input := .input }}
+{{ $args := .args }}
+
+{{- $responsiveVals := slice "table-responsive" "table-responsive-none" "table-responsive-sm" "table-responsive-md" "table-responsive-lg" "table-responsive-xl" "table-responsive-xxl" -}}
+{{- $responsive := intersect $args $responsiveVals -}}
+{{- $main := complement $responsive $args -}}
+
+{{- if in $responsive "table-responsive-none" -}}
+    {{- $responsive = "" -}}
+{{- else if not $responsive -}}
+    {{ $responsive = (slice "table-responsive") -}}
+{{- end -}}
+
+{{- $input := $input | $page.RenderString }}
+{{- $input = replace $input "style=\"text-align:left\"" "class=\"text-start\"" -}}
+{{- $input = replace $input "style=\"text-align:center\"" "class=\"text-center\"" -}}
+{{- $input = replace $input "style=\"text-align:right\"" "class=\"text-end\"" -}}
+{{- $class := delimit $main " " -}}
+{{- $old := "<table>" -}}
+{{- $new := printf "<table class=\"table %s\">" $class -}}
+{{ $input := replace $input $old $new -}}
+{{- with $responsive }}<div class="{{ delimit . " " }}">{{ end -}}
+{{ $input | safeHTML }}
+{{- with $responsive }}</div>{{ end -}}

layouts/partials/assets/toc.html

@@ -1,17 +1,7 @@
 {{- $page := .page -}}
-{{- $download := .download -}}
 
 {{ $items := len (findRE "<li.*?>(.|\n)*?</li>" $page.TableOfContents) -}}
-{{ if or $download (gt $items 1) -}}
+{{ if gt $items 1 -}}
-    <div class="toc toc-sidebar mb-5 my-md-0 ps-xl-3 mb-lg-5 p-3 text-body-secondary sticky-top">
+    <strong class="d-block h6 my-2 pb-2 border-bottom">{{ T "toc" }}</strong>
-        {{ with $download }}
+    {{ $page.TableOfContents }}
-            <div class="mb-5">
-                {{ $attr := dict "download" (path.Base .) }}
-                {{ partial "assets/button.html" (dict "href" . "title" (T "download" ) "color" "primary" "outline" "true" "icon" "fas download" "attributes" $attr) }}
-            </div>
-        {{ end }}
-
-        <strong class="d-block h6 my-2 pb-2 border-bottom">{{ T "toc" }}</strong>
-        {{ $page.TableOfContents }}
-    </div>
 {{ end -}}

layouts/partials/footer/scripts.html

@@ -25,10 +25,10 @@
     {{- $js = $bundle | resources.ExecuteAsTemplate $filename $page -}}
 {{- end -}}
 
-{{- if and (not site.IsServer) $header -}}
+{{- if and (not hugo.IsServer) $header -}}
     {{- $pc := site.Config.Privacy.GoogleAnalytics -}}
-    {{- if and (not $pc.Disable) (hasPrefix site.GoogleAnalytics "G-") }}
+    {{- if and (not $pc.Disable) (hasPrefix site.Config.Services.GoogleAnalytics.ID "G-") }}
-        <script async src="https://www.googletagmanager.com/gtag/js?id={{ site.GoogleAnalytics }}"></script>
+        <script async src="https://www.googletagmanager.com/gtag/js?id={{ site.Config.Services.GoogleAnalytics.ID }}"></script>
     {{- end }}
 {{- end -}}
 

layouts/partials/head/seo.html

@@ -12,8 +12,10 @@
 
 {{- $thumbnail := (or (and (reflect.IsMap .Params.Thumbnail) .Params.Thumbnail.url) .Params.Thumbnail) -}}
 {{ with $thumbnail -}}
-    {{ $img := partial "utilities/GetImage.html" (dict "url" .) -}}
+{{- $res := partial "utilities/GetImage.html" (dict "url" .) -}}
-    {{ with $img -}}
+{{- $img := "" -}}
+{{ with $res }}{{ $img = $res.resource }}{{ end }}
+{{ with $img -}}
         {{ $dim := "1280x640" -}}
         {{ $scaled := (.Fill (printf "%s jpg" $dim)) -}}
         {{- $scaled = $scaled | resources.Copy (replace $img.RelPermalink ".jpg" (printf "-%s.jpg" $dim)) -}}

layouts/partials/list/featured.html

@@ -56,13 +56,13 @@
     {{ else }}
         {{- $thumbnail := (or (and (reflect.IsMap $page.Params.Thumbnail) $page.Params.Thumbnail.url) $page.Params.Thumbnail) -}}
         {{- if $thumbnail }}
-            {{ partial "assets/image.html" (dict "url" $thumbnail "ratio" "16x9" "outerClass" $style "innerClass" "rounded" "title" .Site.Title) }}
+            {{ partial "assets/image.html" (dict "url" $thumbnail "ratio" "16x9" "outerClass" $style "innerClass" "rounded" "title" $page.Site.Title "priority" "high") }}
         {{ end }}
     {{ end }}
 {{- end -}}
 
 <div class="container-fluid p-0 {{ with site.Params.home.feature.color }} bg-{{ . }} bg-opacity-{{ site.Params.style.themeOpacity | default "25" | safeHTML }}{{ end }}">
-    <div class="container-xxl {{ if $breadcrumb }} pb-4 px-4 {{ else }} p-4 {{ end }} px-xxl-0 {{ if site.Params.home.fullCover }} fullcover{{ end }} d-flex flex-column">
+    <div class="container-xxl p-4 px-xxl-0 {{ if site.Params.home.fullCover }} fullcover{{ end }} d-flex flex-column">
         {{ if $breadcrumb }}
             <div>{{ partial "assets/breadcrumb.html" $page }}</div>
         {{ end -}}
@@ -79,7 +79,7 @@
                 <div class="col col-12 col-md-{{ $width }} order-1 order-md-0 my-md-auto">
                     {{ partial "partials/list/featured-body.html" (dict "page" $page "headings" $headings "orientation" $orientation "actions" $actions "align" $align) }}
                 </div>
-                <div class="col col-12 col-md-{{ if gt $width 6 }}{{ sub 12 $width }}{{ else }}{{ $width }}{{ end }} order-0 order-md-1 text-center my-md-auto">
+                <div class="col col-12 col-md-{{ if gt $width 6 }}{{ sub 12 $width }}{{ else }}{{ $width }}{{ end }} order-0 order-md-1 text-center my-md-auto align-self-end">
                     {{ partial "partials/list/featured-illustration.html" (dict "page" $page "style" "pb-4 pb-md-0") }}
                 </div>
             </div>

layouts/partials/single/thumbnail.html

@@ -1,20 +1,24 @@
+{{- $page := .page -}}
+{{- $class := printf "img-wrap" -}}
+{{- with .class }}{{ $class = printf "img-wrap %s" . }}{{ end -}}
+{{- $ratio := .ratio | default "21x9" -}}
 {{- $thumbnail := "" -}}
 {{- $credits := "" -}}
 
-{{- if reflect.IsMap .Params.Thumbnail -}}
+{{- if reflect.IsMap $page.Params.Thumbnail -}}
-    {{- $thumbnail = .Params.Thumbnail.url -}}
+    {{- $thumbnail = $page.Params.Thumbnail.url -}}
     {{- $author := "" -}}
-    {{- if and .Params.Thumbnail.authorURL "text" .Params.Thumbnail.author }}
+    {{- if and $page.Params.Thumbnail.authorURL "text" $page.Params.Thumbnail.author }}
-        {{- $author = partial "utilities/link" (dict "destination" .Params.Thumbnail.authorURL "text" .Params.Thumbnail.author) -}}
+        {{- $author = partial "utilities/link" (dict "destination" $page.Params.Thumbnail.authorURL "text" $page.Params.Thumbnail.author) -}}
-    {{- else if .Params.Thumbnail.author }}
+    {{- else if $page.Params.Thumbnail.author }}
-        {{- $author = .Params.Thumbnail.author -}}
+        {{- $author = $page.Params.Thumbnail.author -}}
     {{- end -}}
 
     {{- $origin := "" -}}
-    {{- if and .Params.Thumbnail.originURL "text" .Params.Thumbnail.origin }}
+    {{- if and $page.Params.Thumbnail.originURL "text" $page.Params.Thumbnail.origin }}
-        {{- $origin = partial "utilities/link" (dict "destination" .Params.Thumbnail.originURL "text" .Params.Thumbnail.origin) -}}
+        {{- $origin = partial "utilities/link" (dict "destination" $page.Params.Thumbnail.originURL "text" $page.Params.Thumbnail.origin) -}}
-    {{- else if .Params.Thumbnail.origin }}
+    {{- else if $page.Params.Thumbnail.origin }}
-        {{- $origin = .Params.Thumbnail.origin -}}
+        {{- $origin = $page.Params.Thumbnail.origin -}}
     {{- end }}
 
     {{- if and $author $origin }}
@@ -23,13 +27,13 @@
         {{ $credits = T "photoShort" $author }}
     {{ end }}
 {{ else }}
-    {{- $thumbnail = .Params.Thumbnail -}}
+    {{- $thumbnail = $page.Params.Thumbnail -}}
-    {{ if or .Params.photoCredits .Params.photoSource }}
+    {{ if or $page.Params.photoCredits $page.Params.photoSource }}
-        {{ warnf "DEPRECATED: frontmatter variables `photoCredits` and `photoSource` have been deprecated in release v0.18: %s" .RelPermalink }}
+        {{ warnf "DEPRECATED: frontmatter variables `photoCredits` and `photoSource` have been deprecated in release v0.18: %s" $page.RelPermalink }}
     {{ end }}
-    {{- if and .Params.photoCredits .Params.PhotoSource }}{{ $credits = printf (T "photoFull") .Params.photoCredits .Params.PhotoSource }}{{ end -}}
+    {{- if and $page.Params.photoCredits $page.Params.PhotoSource }}{{ $credits = printf (T "photoFull") $page.Params.photoCredits $page.Params.PhotoSource }}{{ end -}}
 {{- end -}}
 
 {{ if $thumbnail -}}
-    {{- partial "assets/image.html" (dict "url" $thumbnail "ratio" "21x9" "outerClass" "img-wrap" "innerClass" "rounded" "title" .Params.title "caption" $credits) -}}
+    {{- partial "assets/image.html" (dict "url" $thumbnail "ratio" $ratio "outerClass" $class "innerClass" "rounded" "title" $page.Params.title "caption" $credits "priority" "high") -}}
 {{ end -}}

layouts/partials/utilities/GetBreakpoint.html

@@ -0,0 +1,21 @@
+{{- /* Define main breakpoint */ -}}
+{{ $prev := 0 }}
+{{ $next := 0 }}
+{{ $result := dict }}
+{{- $breakpoints := slice "xs" "sm" "md" "lg" "xl" "xxl" }}
+{{- $breakpoint := site.Params.main.breakpoint | default "md" -}}
+{{- if not (in $breakpoints $breakpoint) -}}
+    {{- errorf "layout [_default/baseof.html] - Invalid value for param 'breakpoint': %s" $breakpoint -}}
+{{ else }}
+    {{ range $index, $item := $breakpoints }}
+        {{ if eq $item $breakpoint }}
+            {{ $prev = sub $index 1 }}
+            {{ $next = add $index 1 }}
+        {{ end }}
+    {{ end }}
+    {{ if lt $prev 0 }}{{ $prev = 0 }}{{ end }}
+    {{ if ge $next (len $breakpoints) }}{{ $next = sub (len $breakpoints) 1 }}{{ end }}
+    {{ $result = dict "prev" (index $breakpoints $prev) "current" $breakpoint "next" (index $breakpoints $next) }}
+{{- end -}}
+
+{{ return $result }}

layouts/partials/utilities/GetIllustration.html

@@ -0,0 +1,21 @@
+{{- $item := .item -}}
+{{- $illustration := "" -}}
+{{- $style := "img-wrap mx-auto mx-md-0" -}}
+{{- $size := .size | default "col-12 col-sm-4 col-lg-12" -}}
+
+{{ if $item.Params.icon }}
+    {{- $icon := (or (and (reflect.IsMap $item.Params.Icon) $item.Params.Icon.url) $item.Params.Icon) -}}
+    {{- $mode := and (reflect.IsMap $item.Params.Icon) $item.Params.Icon.mode -}}
+    {{ if eq (lower (path.Ext $icon)) ".json" }}
+        {{ $illustration = partial "assets/animation.html" (dict "data" $icon "mode" $mode "loop" false "hover" true "class" (printf "mx-auto text-center %s" $size)) }}
+    {{ else }}
+        {{ $illustration = partial "assets/icon.html" (dict "icon" "mode" $mode $icon "wrapper" "mx-auto text-center")}}
+    {{ end }}
+{{ else }}
+    {{- $thumbnail := (or (and (reflect.IsMap $item.Params.Thumbnail) $item.Params.Thumbnail.url) $item.Params.Thumbnail) -}}
+    {{- if $thumbnail }}
+        {{ $illustration = partial "assets/image.html" (dict "url" $thumbnail "ratio" "16x9" "outerClass" $style "innerClass" "rounded" "title" $item.Site.Title) }}
+    {{ end }}
+{{ end }}
+
+{{ return $illustration }}

layouts/partials/utilities/GetImage.html

@@ -10,20 +10,11 @@
 
 {{ $url := .url -}}
 {{ $page := .page -}}
+{{ $mirror := false }}
 
 {{ $supportedMediaTypes := slice "image/png" "image/jpeg" "image/gif" "image/tiff" "image/bmp" "image/webp" -}}
-{{ $img := "" }}
 {{ $remote := hasPrefix (lower $url) "http" }}
-{{ if $remote }}
+{{- $img := partial "utilities/GetResource.html" (dict "url" $url "page" $page) -}}
-    {{ $img = resources.GetRemote $url -}}
-{{ else }}
-    {{ if $page }}
-        {{ $img = $page.Resources.Get $url -}}
-    {{ end }}
-    {{ if not $img }}
-        {{ $img = resources.GetMatch $url }}
-    {{ end }}
-{{ end }}
 
 {{ with $img -}}
     {{ if in $supportedMediaTypes (string $img.MediaType) -}}
@@ -38,6 +29,34 @@
             {{ end -}}
             {{ $img = $img.Content | resources.FromString (printf "/img/%s" $filename) -}}
         {{ end -}}
+
+        <!-- 
+            Rotate the image if needed based on EXIF orientation. EXIF defines the following values:
+            (source: https://sirv.com/help/articles/rotate-photos-to-be-upright/#EXIF_orientation_values)
+            1 = 0 degrees: the correct orientation, no adjustment is required.
+            2 = 0 degrees, mirrored: image has been flipped back-to-front.
+            3 = 180 degrees: image is upside down.
+            4 = 180 degrees, mirrored: image has been flipped back-to-front and is upside down.
+            5 = 90 degrees: image has been flipped back-to-front and is on its side.
+            6 = 90 degrees, mirrored: image is on its side.
+            7 = 270 degrees: image has been flipped back-to-front and is on its far side.
+            8 = 270 degrees, mirrored: image is on its far side.
+        -->
+        {{ with $img.Exif }}
+            {{ $filter := "" }}
+            {{ $orientation := .Tags.Orientation }}
+            {{ if or (eq $orientation 3) (eq $orientation 4) }}
+                {{ $filter = images.Process "r180" }}
+            {{ else if or (eq $orientation 5) (eq $orientation 6) }}
+                {{ $filter = images.Process "r270" }}
+            {{ else if or (eq $orientation 7) (eq $orientation 8) }}
+                {{ $filter = images.Process "r90" }}
+            {{ end }}
+            {{ with $filter }}{{ $img = $img.Filter . }}{{ end }}
+
+            {{- $isMirrored := slice 2 4 5 7 -}}
+            {{- if (in $isMirrored $orientation) }}{{ $mirror = true }}{{ end -}}
+        {{ end }}
     {{ else -}}
         {{ warnf "Image type '%s' is not supported: %s" $img.MediaType $url -}}
         {{ $img = "" -}}
@@ -46,4 +65,4 @@
     {{ warnf "Cannot find image resource: %q" $url -}}
 {{ end -}}
 
-{{ return $img -}}
+{{ return (dict "resource" $img "mirror" $mirror) -}}

layouts/partials/utilities/GetResource.html

@@ -0,0 +1,40 @@
+<!-- 
+    Retrieve a local or remote resource. If the url starts with 'http', the resource is retrieved from an external
+    location. Else, the url is matched with a page resource and site asset (in that order). 
+    
+    This partial supports both relative and absolute paths. Hugo has different methods to retrieve page bundle assets
+    and site assets. Absolute paths are converted to a relative path to make them compatible with Hugo's methods. The
+    prefix of an absolute path is truncated if it matches either with the page bundle folder (starting with "/content/")
+    or the assets folder ("/assets/"). 
+    
+    The partial returns nil if the resource cannot be found. The partial supports the following arguments:
+    "url"           Required path or url of the resource, e.g. "img/example.jpg" or "https://example.com/img.jpg"
+    "page"          Optional page context, used to retrieve a resource from page resources.
+-->
+
+{{ $url := .url -}}
+{{ $page := .page -}}
+{{ if hasPrefix $url "/" }}
+    {{ $pageContext := (path.Join "/content" $page.File.Dir) -}}
+    {{ if hasPrefix $url $pageContext }}
+        {{ $url = strings.TrimPrefix $pageContext $url -}}
+    {{ else if hasPrefix $url "/assets/" }}
+        {{ $url = strings.TrimPrefix "/assets/" $url -}}
+    {{ end }}
+    {{ $url = strings.TrimPrefix "/" $url -}}
+{{ end }}
+
+{{ $res := "" }}
+{{ $remote := hasPrefix (lower $url) "http" }}
+{{ if $remote }}
+    {{ $res = resources.GetRemote $url -}}
+{{ else }}
+    {{ if $page }}
+        {{ $res = $page.Resources.Get $url -}}
+    {{ end }}
+    {{ if not $res }}
+        {{ $res = resources.GetMatch $url }}
+    {{ end }}
+{{ end }}
+
+{{ return $res -}}

layouts/partials/utilities/GetSections.html

@@ -1,8 +1,9 @@
-{{- $page := . -}}
+{{- $page := .page -}}
+{{- $loading := .loading -}}
 
 {{/* Add title for current page */}}
 {{- $items := slice -}}
-{{ $items = $items | append (dict "title" .Title "content" "" )}}
+{{ $items = $items | append (dict "title" $page.Title "content" "" )}}
 
 {{/* Identify page sections */}}
 {{- $sections := slice -}}
@@ -47,7 +48,8 @@
 
     {{- $thumbnail := (or (and (reflect.IsMap $sectionPage.Params.Thumbnail) $sectionPage.Params.Thumbnail.url) $sectionPage.Params.Thumbnail) -}}
     {{- $icon := $sectionPage.Params.Icon -}}
-    {{- $content := $sectionPage.Content -}}
+    {{- $content := "" -}}
+    {{ if not $sectionPage.IsSection }}{{ $content = $sectionPage.Content }}{{ end -}}
     {{- $sectionTitle := strings.FirstUpper $sectionPage.Type -}}
     {{- $moreTitle := "" -}}
     {{- with (index site.Params.sections $section) -}}
@@ -60,12 +62,12 @@
         "section" $section 
         "home" $page.IsHome
         "simple" (eq (len $sections) 1)
-        "nested" (and $page.IsHome (eq $section $page.Section))
         "thumbnail" $thumbnail
         "icon" $icon
         "content" $content
         "moreTitle" $moreTitle
-        "sectionURL" $sectionURL)) " \r\n"
+        "sectionURL" $sectionURL
+        "loading" $loading)) " \r\n"
     -}}
 
     {{ if $sectionContent }}

layouts/partials/utilities/IsInvalidArgs.html

@@ -0,0 +1,76 @@
+<!-- 
+    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
+    Visit gethinode.com/license for more details.
+-->
+
+{{ $error := false }}
+
+{{ $aliases := dict "path" "string" "select" "string" "url" "string" }}
+
+{{ $structure := .structure }}
+{{ if not $structure }}
+    {{- errorf "partial [utilities/ValidateArgs.html] - Missing value for param 'structure'" -}}
+    {{ $error =  true }}
+{{ end }}
+
+{{ $args := .args | default slice }}
+
+{{ $definitions := (index site.Data.structures $structure).arguments }}
+{{ if not $definitions }}
+    {{- errorf "partial [utilities/ValidateArgs.html] - Missing definitions: %s" $structure -}}
+    {{ $error =  true }}
+{{ end }}
+
+{{ if not $error }}
+    {{ range $key, $val := $args }}
+        {{ $def := index $definitions $key }}
+        {{ if and (not $val) $def.default }}{{ $val = $def.default }}{{ end }}
+
+        {{/* validate type */}}
+        {{ $expected := slice | append $def.type }}
+        {{ $extra := slice }}
+        {{ range $expected }}
+            {{ $alias := index $aliases . }}
+            {{ if $alias }}{{ $extra = $extra | append $alias }}{{ end }}
+        {{ end }}
+        {{ if $extra }}{{ $expected = $expected | append $extra }}{{ end }}
+        {{ $actual := printf "%T" $val }}
+        {{ if $val }}
+            {{ if not (in $expected $actual ) }}
+                {{ warnf "[%s] argument '%s': expected type '%s', got '%s'" $structure $key (delimit $expected ", ") $actual }}
+                {{ $error = true }}
+            {{ end }}
+        {{ end }}
+
+        {{/* validate permitted values */}}
+        {{ if and $def.options.values (eq $actual "select") }}
+            {{ if and (not $def.optional) (not (in $def.options.values $val)) }}
+                {{ warnf "[%s] argument '%s': unexpected value '%s'" $structure $key $val }}
+                {{ $error = true }}
+            {{ end }}
+        {{ else if and $def.options.min (in (slice "int" "float" "float64") $actual) }}
+            {{ if lt $val $def.options.min }}
+                {{ warnf "[%s] argument '%s': value '%s' out of range [$d, $d]" $structure $key $val $def.options.min $def.options.max}}
+                {{ $error = true }}
+            {{ end }}
+        {{ else if and $def.options.max (in (slice "int" "float" "float64") $actual) }}
+            {{ if (gt $val $def.options.max) }}
+                {{ warnf "[%s] argument '%s': value '%s' out of range [$d, $d]" $structure $key $val $def.options.min $def.options.max}}
+                {{ $error = true }}
+            {{ end }}
+        {{ end }}
+    {{ end }}
+
+    {{/* validate required arguments */}}
+    {{ range $key, $val := $definitions }}
+        {{ if not $val.optional }}
+            {{ if not (in $args $key )}}
+                {{ warnf "[%s] argument '%s': expected value" $structure $key }}
+                {{ $error = true }}
+            {{ end }}
+        {{ end }}
+    {{ end }}
+{{ end }}
+
+{{ return $error }}

layouts/partials/utilities/bundle.html

@@ -55,8 +55,6 @@
     {{- end -}}
 {{- end -}}
 
-{{/* warnf "FILES: %s" $sorted */}}
-
 {{ $bundle := "" }}
 {{ if gt (len $sorted) 0 }}
     {{ $bundle = $sorted | resources.Concat $filename -}}

layouts/shortcodes/args.html

@@ -0,0 +1,68 @@
+{{ $error := false }}
+
+{{ $structure := "" }}
+{{- if .IsNamedParams }}{{ $structure = .Get "structure" }}{{ else }}{{ $structure = .Get 0 }}{{ end }}
+{{ if not $structure }}
+    {{- errorf "Invalid or missing value for param 'structure': %s" .Position -}}
+    {{ $error =  true }}
+{{ end }}
+
+{{ $definitions := (index site.Data.structures $structure).arguments }}
+{{ if not $definitions }}
+    {{- errorf "Cannot find data structure '%s': %s" $structure .Position -}}
+    {{ $error =  true }}
+{{ end }}
+
+{{ $group := "" }}
+{{- if .IsNamedParams }}{{ $group = .Get "group" }}{{ else }}{{ $group = .Get 1 }}{{ end }}
+
+{{ if not $error }}    
+    {{ $table := printf "| %s | %s | %s | %s | %s |\n| --- | --- | --- | --- | --- |" 
+        (T "name") (T "type") (T "required") (T "default") (T "comment") 
+    }}
+
+    {{ range $key, $val := $definitions }}
+        {{ $skip := false }}
+        {{ $groups := slice | append $val.group }}
+        {{ if and $group $val.group }}
+            {{ $skip = not (in $groups $group )}}
+        {{ end }}
+    
+        {{ if not $skip }}
+            {{ $type := $val.type }}
+            {{ if reflect.IsSlice $val.type }}{{ $type = delimit $val.type ", " }}{{ end }}
+
+            {{ $required := "" }}
+            {{ if not $val.optional }}{{ $required = "yes" }}{{ end }}
+
+            {{ $comment := $val.comment }}
+            {{ if $val.deprecated }}
+                {{ $comment = printf `{{< release version="%s" short="true" size="sm" inline="true" state="deprecated" >}} %s` $val.deprecated $comment }}
+            {{ end }}
+            {{ if $val.release }}
+                {{ $comment = printf `{{< release version="%s" short="true" size="sm" inline="true" >}} %s` $val.release $comment }}
+            {{ end }}
+
+            {{ $min := "" }}
+            {{ $max := "" }}
+            {{ if and $val.options.values (eq $type "select") }}
+                {{ $comment = printf "%s %s: [%s]." $comment (T "supportedValues") (delimit $val.options.values ", ") }}
+            {{ else if $val.options.min (in (slice "int" "float" "float64") $type) }}
+                {{ $min = $val.options.min }}
+            {{ else if $val.options.max (in (slice "int" "float" "float64") $type) }}
+                {{ $max = $val.options.max }}
+            {{ end }}
+            {{ if and $min $max }}
+                {{ $comment = printf "%s %s: [%d, %d]." $comment (T "supportedValues") $min $max }}
+            {{ else if $min }}
+                {{ $comment = printf "%s %s: >=%d." $comment (T "supportedValues") $min }}
+            {{ else if $max }}
+                {{ $comment = printf "%s %s: <=%d." $comment (T "supportedValues") $max }}
+            {{ end }}
+
+            {{ $table = printf "%s\n| %s | %s | %s | %s | %s |" $table $key $type $required (or $val.default "") $comment }}
+        {{ end }}
+    {{ end }}
+
+    {{ partial "assets/table.html" (dict "page" .Page "input" $table "args" slice) }}
+{{ end }}

layouts/shortcodes/card.html

@@ -1,29 +1,35 @@
 <!-- 
-    Displays a Bootstrap card that links to a page. Any inner text is used as description. The shortcode supports the
+    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
-    following arguments:
+    Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
-    "path"          Optional path of the page. If omitted, specify the title, icon, thumbnail, and body as needed. 
+    Visit gethinode.com/license for more details.
-    "title"         Optional title of the card.
-    "class"         Optional class attribute of the card element, e.g. “w-50”.
-    "color"         Optional theme color of the card, either "primary", "secondary", "success", "danger",
-                    "warning", "info", "light", "dark", "white", "black", "body", or "body-tertiary". By default, no
-                    color is specified.
-    "padding"       Optional padding of the content, either "0", "1", "2", "3", "4", "5", or "auto" (default).
-    "gutter"        Gutter between columns in a group, either "0" (default), "1", "2", "3", "4", or "5".
-    "header"        Optional header components of the card, displayed in small caps. Supported values are "full"
-                    (default), "publication", "tags", and "none".
-    "footer"        Optional footer components of the card, displayed in small caps. Supported values are "full",
-                    "publication", "tags", and "none" (default).
-    "orientation"   Optional placecement of the thumbnail, either "stacked" (default), "horizontal", or "none".
-    "thumbnail"     Optional thumbnail image url, displayed on top or the left of the card.
-    "alt"           Optional alternate text for the thumbnail, uses "title" by default.
-    "icon"          Optional Font Awesome icon, displayed on top or the left of the card.
 -->
 
 {{ $error := false }}
 
-{{ $path := or (.Get "path") "" }}
+<!-- Validate and initialize arguments -->
-{{ $page := .Page }}
+{{ if partial "utilities/IsInvalidArgs.html" (dict "structure" "card" "args" .Params) }}
-{{ with $path }}
+    {{ errorf "Invalid arguments: %s" .Position -}}
+    {{ $error = true }}
+{{ end }}
+
+<!-- Initialize arguments and default values -->
+{{- $alt := .Get "alt" -}}
+{{- $class := partial "utilities/GetArgParent" (dict "page" . "arg" "class" "merge" true) -}}
+{{- $color := partial "utilities/GetArgParent" (dict "page" . "arg" "color") -}}
+{{- $description := trim .Inner " \r\n" | .Page.RenderString | safeHTML -}}
+{{- $footer := partial "utilities/GetArgParent" (dict "page" . "arg" "footer") | default "none" -}}
+{{- $gutter := partial "utilities/GetArgParent" (dict "page" . "arg" "gutter") | default "0" -}}
+{{- $header := partial "utilities/GetArgParent" (dict "page" . "arg" "header") | default "full" -}}
+{{- $icon := .Get "icon" -}}
+{{- $orientation := partial "utilities/GetArgParent" (dict "page" . "arg" "orientation") | default "stacked" -}}
+{{- $padding := partial "utilities/GetArgParent" (dict "page" . "arg" "padding") | default "auto" -}}
+{{- $page := .Page -}}
+{{- $path := .Get "path" -}}
+{{- $thumbnail := .Get "thumbnail" -}}
+{{- $title := .Get "title" -}}
+
+<!-- Override arguments -->
+{{ if $path }}
     {{ $page = $.Site.GetPage $path }}
     {{ if not $page }}
         {{ errorf "Invalid or missing value for param 'path': %s" .Position -}}
@@ -31,67 +37,13 @@
     {{ end }}
 {{ end }}
 
-{{- $class := partial "utilities/GetArg" (dict "page" . "arg" "class" "merge" true) -}}
-
-{{- $color := partial "utilities/GetArg" (dict "page" . "arg" "color") -}}
-{{ if $color }}
-    {{ $supportedColors := slice "primary" "secondary" "success" "danger" "warning" "info" "light" "dark" "white" "black" "body" "body-tertiary" -}}
-    {{ if not (in $supportedColors $color) -}}
-        {{ errorf "Invalid value for param 'color': %s" .Position -}}
-        {{ $error = true -}}
-    {{ end -}}
-{{ end -}}
-
-{{- $header := partial "utilities/GetArg" (dict "page" . "arg" "header") | default "full" -}}
-{{ $supportedKeywords := slice "full" "publication" "tags" "none" -}}
-{{ if not (in $supportedKeywords $header) -}}
-    {{ errorf "Invalid value for param 'header': %s" .Position -}}
-{{ end -}}
-
-{{- $footer := partial "utilities/GetArg" (dict "page" . "arg" "footer") | default "none" -}}
-{{ if not (in $supportedKeywords $footer) -}}
-    {{ errorf "Invalid value for param 'footer': %s" .Position -}}
-{{ end -}}
-
-{{- $padding := partial "utilities/GetArg" (dict "page" . "arg" "padding") | default "auto" -}}
-{{ $supportedPaddings := slice "0" "1" "2" "3" "4" "5" "auto" -}}
-{{ if not (in $supportedPaddings $padding) -}}
-    {{ errorf "Invalid value for param 'padding': %s" .Position -}}
-    {{ $error = true -}}
-{{ end -}}
-
-{{- $gutter := partial "utilities/GetArg" (dict "page" . "arg" "gutter") | default "0" -}}
-{{ $supportedGutters:= slice "0" "1" "2" "3" "4" "5" -}}
-{{ if not (in $supportedGutters $gutter) -}}
-    {{ errorf "Invalid value for param 'gutter': %s" .Position -}}
-    {{ $error = true -}}
-{{ end -}}
-
-{{- $orientation := partial "utilities/GetArg" (dict "page" . "arg" "orientation") | default "stacked" -}}
-{{ $supportedOrientations := slice "stacked" "horizontal" "none" -}}
-{{ if not (in $supportedOrientations $orientation) -}}
-    {{ errorf "Invalid value for param 'orientation': %s" .Position -}}
-    {{ $error = true -}}
-{{ end -}}
-
-{{- $layout := partial "utilities/GetArg" (dict "page" . "arg" "layout") | default "rich" -}}
-{{ $supportedLayouts := slice "rich" "minimal" -}}
-{{ if not (in $supportedLayouts $layout) -}}
-    {{ errorf "Invalid value for param 'layout': %s" .Position -}}
-    {{ $error = true -}}
-{{ end -}}
-
-{{ $description := trim .Inner " \r\n" | .Page.RenderString | safeHTML }}
-{{ $title := .Get "title" | default "" -}}
-{{ $alt := .Get "alt" | default "" -}}
-{{ $icon := .Get "icon" | default "" -}}
-{{ $thumbnail := .Get "thumbnail" | default "" -}}
-
 {{ if .Parent }}
     {{ $class = (printf "h-100 %s" $class) }}
 {{ end }}
 
+<!-- Main code -->
 {{ if not $error -}}
+    <!-- Render card -->
     {{- $output := partial "assets/card.html" (dict 
         "path" $path
         "title" $title
@@ -108,6 +60,7 @@
         "alt" $alt
     ) -}}
 
+    <!-- Pass output to parent or current stream -->
     {{ with .Parent }}
         {{ $current := .Scratch.Get "inner" }}
         {{ if $current }}

layouts/shortcodes/image.html

@@ -8,6 +8,10 @@
                     original aspect ratio of the image.
     "portrait":     Optional flag to adjust the ratio from landscape to portrait. The image itself is not rotated, only
                     the crop area is adjusted.
+    "loading":      Optional loading behavior of the image, either "eager" (default) or "lazy". The loading of lazily
+                    loaded images is deferred until the image is within scrolling range of the viewport. This should
+                    reduce the initial loading time of the website. It is recommended to lazily load only those images
+                    that are below the page fold.
     "wrapper":      Optional class attributes of the wrapper element, e.g. "mx-auto".
     "class":        Optional class attribute of the inner img element, e.g. "rounded".
     "title":        Optional alternate text of the image.
@@ -15,38 +19,72 @@
     "mode":         Optional flag indicating if the image should support color modes.
 -->
 
-{{- if isset .Params "src" -}}
+{{- $url := "" -}}
-    {{ $url := .Get "src" | default "" -}}
+{{- $ratio := "" -}}
+{{- $wrapper := "" -}}
+{{- $class := "" -}}
+{{- $title := "" -}}
+{{- $caption := "" -}}
+{{- $mode := false -}}
+{{- $portrait := false -}}
+{{- $loading := "" -}}
+{{- $error := false -}}
+
+{{- if .IsNamedParams -}}
+    {{ $url = .Get "src" | default "" -}}
+    
     {{- $validRatios := slice "1x1" "3x2" "4x3" "16x9" "21x9" -}}
-    {{ $ratio := .Get "ratio" | default "" -}}
+    {{ $ratio = .Get "ratio" | default "" -}}
     {{ if $ratio -}}
         {{ if not (in $validRatios $ratio) -}}
             {{ errorf "Invalid value for param 'ratio': %s" .Position -}}
+            {{ $error = true -}}
         {{ end -}}
     {{ end -}}
     
-    {{- $class := .Get "class" | default "" -}}
+    {{- $class = .Get "class" | default "" -}}
-    {{- $wrapper := .Get "wrapper" | default "" -}}
+    {{- $wrapper = .Get "wrapper" | default "" -}}
-    {{ $title := .Get "title" | default "" -}}
+
-    {{ $caption := .Get "caption" | default "" -}}
+    {{- $loading = .Get "loading" | default "" -}}
+    {{- $validSettings := slice "lazy" "eager" -}}
+    {{- if $loading -}}
+        {{ if not (in $validSettings $loading) -}}
+            {{ errorf "Invalid value for param 'loading': %s" .Position -}}
+            {{ $error = true -}}
+        {{ end -}}
+    {{- end -}}
+    
+    {{ $title = .Get "title" | default "" -}}
+    {{ $caption = .Get "caption" | default "" -}}
+
     {{ $supportedFlags := slice "true" "false" -}}
     {{ $modeParam := "false" -}}
-    {{ $mode := false -}}
     {{ with .Get "mode" }}{{ $modeParam = . }}{{ end -}}
     {{ if in $supportedFlags $modeParam -}}
         {{ if eq $modeParam "true" }}{{ $mode = true }}{{ else }}{{ $mode = false }}{{ end -}}
     {{ else -}}
         {{ errorf "Invalid value for param 'mode': %s" $modeParam -}}
+        {{ $error = true -}}
     {{ end -}}
+
     {{ $portraitParam := "false" -}}
-    {{ $portrait := false -}}
     {{ with .Get "portrait" }}{{ $portraitParam = . }}{{ end -}}
     {{ if in $supportedFlags $portraitParam -}}
         {{ if eq $portraitParam "true" }}{{ $portrait = true }}{{ else }}{{ $portrait = false }}{{ end -}}
     {{ else -}}
         {{ errorf "Invalid value for param 'portrait': %s" $portraitParam -}}
+        {{ $error = true -}}
     {{ end -}}
-    
+{{ else -}}
+    {{ $url = .Get 0 }}
+{{ end -}}
+
+{{ if not $url }}
+    {{ errorf "Missing value for param 'src': %s" .Position -}}
+    {{- $error = true -}}
+{{ end }}
+
+{{- if not $error -}}
     {{- partial "assets/image.html" (dict 
         "url" $url
         "ratio" $ratio
@@ -56,8 +94,7 @@
         "caption" $caption
         "mode" $mode
         "portrait" $portrait
+        "loading" $loading
         "page" .Page)
     -}} 
-{{ else -}}
+{{- end -}}
-    {{ errorf "Missing value for param 'src': %s" .Position -}}
-{{ end -}}

layouts/shortcodes/img.html

@@ -15,8 +15,8 @@
     {{- $src := .Get "src" | default "" -}}
     {{- if $src -}}
         {{- $caption := .Get "caption" | default "" -}}
-        {{- $ratio := partial "utilities/GetArg" (dict "page" . "arg" "ratio") -}}
+        {{- $ratio := partial "utilities/GetArgParent" (dict "page" . "arg" "ratio") -}}
-        {{- $portrait := partial "utilities/GetArg" (dict "page" . "arg" "portrait") | default false -}}
+        {{- $portrait := partial "utilities/GetArgParent" (dict "page" . "arg" "portrait") | default false -}}
         {{- $active := eq .Ordinal 0 -}}
         {{- $output := partial "assets/carousel-item" (dict 
             "page" .Page

layouts/shortcodes/nav-item.html

@@ -22,6 +22,8 @@
         {{- $fade = true -}}
     {{- end -}}
 
+    {{- $type := .Parent.Get "type" -}}
+
     {{- $header := .Get "header" | default "" -}}
     {{- if not $header -}}
         {{- errorf "Missing value for param 'header': %s" .Parent.Position -}}
@@ -58,6 +60,7 @@
         "body" $body
         "show" $show
         "disabled" $disabled
+        "type" $type
         )
     }}
 
@@ -67,4 +70,24 @@
     {{ else }}
         {{ .Parent.Scratch.Set "inner" $output }}
     {{ end }}
+
+    {{ $alternative := partial "assets/nav-item" (dict 
+        "id" $id
+        "parentID" $parent
+        "fade" $fade
+        "header" $header
+        "class" $class
+        "body" $body
+        "show" $show
+        "disabled" $disabled
+        "type" "accordion"
+        )
+    }}
+
+    {{ $current := .Parent.Scratch.Get "alternative" }}
+    {{ if $current }}
+        {{ .Parent.Scratch.Set "alternative" (print $current $alternative) }}
+    {{ else }}
+        {{ .Parent.Scratch.Set "alternative" $alternative }}
+    {{ end }}
 {{ end }}

layouts/shortcodes/nav.html

@@ -1,7 +1,7 @@
 <!-- 
     Displays a tab group of multiple items. Add nav-item inner elements for each tab pane. The shortcode supports the
     following arguments:
-    "type"          Optional type of the tab group, either "tabs", "pills", or "underline".
+    "type"          Optional type of the tab group, either "tabs", "pills", "underline", or "callout".
     "vertical"      Optional flag to show vertical tabs instead of horizontal tabs (default).
     "fade"          Optional flag to make tab panes fade in.
     "class"         Optional class attribute of the tab group, e.g. “nav-fill”.
@@ -15,7 +15,7 @@
 
 {{- $class := .Get "class" | default "" -}}
 {{ $type := .Get "type" | default "" -}}
-{{ $supportedNavTypes := slice "tabs" "pills" "underline" -}}
+{{ $supportedNavTypes := slice "tabs" "pills" "underline" "callout" -}}
 {{ if $type }}
     {{ if not (in $supportedNavTypes $type) -}}
         {{ errorf "Invalid value for param 'type': %s" $type -}}
@@ -71,8 +71,18 @@
 
 {{- $hasContent := gt (len (findRE "data-has-content=\"true\"" $inner)) 0 -}}
 
-{{ if $vertical }}<div class="d-flex align-items-start">{{ end }}
+{{ $alternative := .Scratch.Get "alternative" }}
+{{ if and (eq $type "callout") $alternative }}
+    <div class="d-lg-none">
+        <div id="accordion-{{ $id }}" class="accordion mb-3{{ with $class }} {{ . }}{{ end }} nav-callout">
+            {{- $alternative | safeHTML -}}
+        </div>
+    </div>
+    <div class="d-none d-lg-block">
+{{ end }}
+
 <div class="nav{{ with $type }} nav-{{ . }}{{ end }}{{ with $class }} {{ . }}{{ end }}{{ if $vertical }} flex-column{{ end }}" id="{{ $id }}" role="tablist"{{ if $vertical }} aria-orientation="vertical"{{ end }}>
+    {{ if $vertical }}<div class="row"><div class="col-auto">{{ end }}
     {{- range $index, $item := $items -}}
         {{- $header := partial "utilities/GetVal.html" $item -}}
         {{- $itemDisabled := in $disabled $index -}}
@@ -81,11 +91,13 @@
             {{ $header }}
         </button>
     {{ end -}}
-</div>
+    {{ if $vertical }}</div><div class="col">{{ end }}
-
+        {{- if $hasContent -}}
-{{- if $hasContent -}}
+        <div class="tab-content w-100 {{ if not $vertical }} {{ end }}{{ if eq $type "tabs" }}border border-bottom-0 p-3{{ else if $vertical }}ms-3{{ else }}mt-3{{ end }}">
-    <div class="tab-content {{ if eq $type "tabs" }}border border-top-0 p-3{{ else if $vertical }}ms-3{{ else }}mt-3{{ end }}">
+            {{- $inner | safeHTML -}}
-        {{- $inner | safeHTML -}}
+        </div>
+    {{- end -}}
+    {{ if $vertical }}</div></div>{{ end }}
     </div>
-{{- end -}}
+
-{{ if $vertical }}</div>{{ end }}
+{{ if and (eq $type "callout") $alternative }}</div>{{ end }}

layouts/shortcodes/timeline.html

@@ -50,7 +50,7 @@
     <div class="col-{{ $col }} d-flex justify-content-{{ $direction }} align-items-center">
         <div class="d-flex">
             <div class="d-flex timeline-semi-circle-{{ $direction }} fa-wrapper align-items-center justify-content-center">
-                {{ partial "assets/icon.html" (dict "icon" (printf "%s fa-fluid" $icon)) }}
+                {{ partial "assets/icon.html" (dict "icon" (printf "%s fa-fluid" $icon) "spacing" false) }}
             </div>
             <div class="timeline-connector-{{ $direction }} {{ if eq $direction "start" }} order-first{{ end }}"></div>
         </div>

layouts/shortcodes/youtube.html

@@ -4,7 +4,7 @@
 {{- $id := .Get "id" | default (.Get 0) -}}
 {{- $class := .Get "class" | default (.Get 1) -}}
 {{- $title := .Get "title" | default "YouTube Video" }}
-<div {{ with $class }}class="{{ . }}"{{ else }}style="position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden;"{{ end }}>
+<div class="youtube-embedded {{ $class }}">
-  <iframe src="https://{{ $ytHost }}/embed/{{ $id }}?origin={{ .Site.BaseURL }}{{ with .Get "autoplay" }}{{ if eq . "true" }}&autoplay=1{{ end }}{{ end }}" {{ if not $class }}style="position: absolute; top: 0; left: 0; width: 100%; height: 100%; border:0;" {{ end }}allowfullscreen title="{{ $title }}"></iframe>
+  <iframe src="https://{{ $ytHost }}/embed/{{ $id }}?origin={{ .Site.BaseURL }}{{ with .Get "autoplay" }}{{ if eq . "true" }}&autoplay=1{{ end }}{{ end }}" allowfullscreen title="{{ $title }}"></iframe>
 </div>
 {{ end -}}

layouts/tags/list.html

@@ -1,22 +1,36 @@
 {{ define "main" }}
-    <div class="container-xxl flex-fill px-4 px-xxl-0">
+    {{- $page := . -}}
-        <div class="row row-cols-1 row-cols-sm-3">
+    {{- $layout := $page.Params.layout -}}
-            <div class="col col-md-2 d-none d-md-block"></div>
+    {{- $breakpoint := $.Scratch.Get "breakpoint" -}}
-            <div class="col col-sm-12 col-md-8">
+    {{- $hasSidebar := site.Params.navigation.sidebar | default true -}}
-                <p class="display-4 mt-5">{{ .Name | humanize }}</p>
+
+    <div class="container-xxl flex-fill p-4 px-xxl-0">
+        <div class="row row-cols-1 row-cols-{{ $breakpoint.prev }}-{{ if $hasSidebar }}3{{ else }}2{{ end }}">
+            {{ if $hasSidebar }}<div class="col col-{{ $breakpoint.current }}-2 d-none d-{{ $breakpoint.current }}-block"></div>{{ end }}
+            <div class="col col-{{ $breakpoint.prev }}-12 col-{{ $breakpoint.current }}-8">
+                {{- if ne $layout "featured" -}}
+                    {{ if and (not $page.IsHome) site.Params.navigation.breadcrumb }}
+                        <div>{{ partial "assets/breadcrumb.html" $page }}</div>
+                    {{ end -}}
+                {{- end -}}
+
+                <p class="display-4 mt-5">{{ .Page.Title }}</p>
 
                 {{ if eq .Kind "taxonomy" }}
                     <div class="row mt-5"></div>
                     {{ range $.Site.Taxonomies.tags.ByCount }}
                         <div class="row mt-2">
-                            <div class="d-none d-sm-block col-sm-3 mt-auto text-right">
+                            <div class="col-3 mt-auto text-right">
                                 {{ .Count }} {{ if gt .Count 1 }} {{ T "articles" }} {{ else }} {{ T "article" }} {{ end }}
                             </div>
-                            <div class="col">
+                            <div class="col-9">
-                                <a href="{{ (path.Join .Page.RelPermalink) | relLangURL }}">{{ .Name | .Page.RenderString }}</a>
+                                <a href="{{ (path.Join .Page.RelPermalink) | relLangURL }}">{{ .Page.Title | .Page.RenderString }}</a>
                             </div>
                         </div>
                     {{ end }}
+                    {{ if eq $.Site.Taxonomies.tags 0 }}
+                        <p class="pt-4">{{- T "emptyTags" }}.</p>
+                    {{ end }}
                 {{ else }}
                     {{ $dateFormat := default "Jan 2" (index .Site.Params "date_format") }}
                     {{ $.Scratch.Set "lastYear" ""}}
@@ -24,7 +38,7 @@
                         {{ $year := .Date.Year }}
                         {{ $lastYear := $.Scratch.Get "lastYear"}}
                         <div class="row mt-2">
-                            <div class="d-none d-sm-block col-sm-3 mt-auto text-right">
+                            <div class="d-none d-{{ $breakpoint.prev }}-block col-{{ $breakpoint.prev }}-3 mt-auto text-right">
                                 <time class="post-date" datetime="{{ .Date.Format "2006-01-02T15:04:05Z07:00" | safeHTML }}">
                                     {{ (partial "utilities/date.html" (dict "date" .Date "format" "medium")) }}
                                 </time>
@@ -40,7 +54,7 @@
                     {{ end }}
                 {{ end }}
             </div>
-            <div class="col col-md-2 d-none d-md-block"></div>
+            <div class="col col-{{ $breakpoint.current }}-2 d-none d-{{ $breakpoint.current }}-block"></div>
         </div>
     </div>
 {{ end }}

netlify.toml

@@ -4,12 +4,12 @@
     command = "npm run build:example"
 
 [build.environment]
-    DART_SASS_VERSION = "1.69.0"
+    DART_SASS_VERSION = "1.69.5"
-    HUGO_VERSION = "0.119.0"
+    HUGO_VERSION = "0.121.0"
     HUGO_ENV = "production"
     HUGO_ENABLEGITINFO = "true"
-    NODE_VERSION = "18.18.2"
+    NODE_VERSION = "18.19.0"
-    NPM_VERSION = "9.8.1"
+    NPM_VERSION = "10.2.3"
 # toml-docs-end netlify
 
 [[headers]]

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gethinode/hinode",
-  "version": "0.21.0-beta5",
+  "version": "0.22.0-alpha2",
   "description": "Hinode is a clean documentation and blog theme for Hugo, an open-source static site generator",
   "keywords": [
     "hugo",
@@ -71,27 +71,30 @@
     "@gethinode/netlify-plugin-dartsass": "^0.2.0",
     "@netlify/plugin-lighthouse": "^5.0.0",
     "autoprefixer": "^10.4.16",
-    "cssnano": "^6.0.1",
+    "cssnano": "^6.0.2",
-    "cssnano-preset-advanced": "^6.0.1",
+    "cssnano-preset-advanced": "^6.0.2",
-    "eslint": "^8.51.0",
+    "eslint": "^8.56.0",
     "eslint-config-standard": "^17.1.0",
-    "eslint-plugin-import": "^2.28.1",
+    "eslint-plugin-import": "^2.29.1",
-    "eslint-plugin-n": "^16.2.0",
+    "eslint-plugin-n": "^16.5.0",
     "eslint-plugin-promise": "^6.1.1",
-    "hugo-bin": "^0.115.0",
+    "hugo-bin": "^0.117.1",
-    "markdownlint-cli2": "^0.10.0",
+    "markdownlint-cli2": "^0.11.0",
     "netlify-plugin-hugo-cache-resources": "^0.2.1",
     "npm-run-all": "^4.1.5",
-    "postcss-cli": "^10.1.0",
+    "postcss-cli": "^11.0.0",
     "purgecss-whitelister": "^2.4.0",
     "replace-in-files-cli": "^2.2.0",
     "rimraf": "^5.0.5",
     "shx": "^0.3.4",
     "stylelint": "^15.11.0",
-    "stylelint-config-standard-scss": "^11.0.0"
+    "stylelint-config-standard-scss": "^11.1.0"
   },
   "optionalDependencies": {
-    "fsevents": "*"
+    "@gethinode/netlify-plugin-dartsass": "^0.2.0",
+    "@netlify/plugin-lighthouse": "*",
+    "fsevents": "*",
+    "netlify-plugin-hugo-cache-resources": "^0.2.1"
   },
   "hugo-bin": {
     "buildTags": "extended"

theme.toml

@@ -6,7 +6,7 @@ homepage = "https://gethinode.com"
 demosite = "https://demo.gethinode.com"
 tags = ["blog", "documentation", "minimal", "modern", "customizable", "search", "bootstrap"]
 features = ["security aware", "fast by default", "seo-ready", "development tools", "bootstrap framework", "netlify-ready", "full text search", "page layouts", "versioned documentation"]
-min_version = "0.118.0" # fixes Hugo issue #11406
+min_version = "0.120.0"
 
 [author]
   name = "Mark Dumay"