Merge pull request #1188 from gethinode/develop

Fix bootstrap form validation when purging styles

.eslintignore

@@ -1,6 +0,0 @@
-assets/js/critical/color.js
-assets/js/analytics.js
-assets/js/flexsearch.js
-assets/js/sharing.js
-assets/js/vendor
-node_modules

.github/workflows/lint-build.yml

@@ -43,7 +43,7 @@ jobs:
       matrix:
         os: [macos-latest, windows-latest, ubuntu-latest]
         # See supported Node.js release schedule at https://nodejs.org/en/about/releases/
-        node-version: [18.x, 20.x]
+        node-version: [20.x, 22.x]
 
     runs-on: ${{ matrix.os }}
 

.gitignore

@@ -1,4 +1,4 @@
-/_vendor
+_vendor/
 public/
 resources/
 node_modules/

assets/js/alert.js

@@ -1,3 +1,4 @@
+/* eslint-disable no-undef */
 const alert = document.getElementById('page-alert')
 const closeBtn = document.getElementById('page-alert-btn-close')
 if (alert !== null && closeBtn !== null) {

assets/js/critical/color.js

@@ -61,32 +61,16 @@
   })
 
   window.addEventListener('DOMContentLoaded', () => {
-    setTheme(getTheme())
-    const light = (document.documentElement.getAttribute('data-bs-theme') === 'light')
-
-    document.querySelectorAll('.ball').forEach(ball => {
-      ball.classList.add('notransition');
-    })
-    
     document.querySelectorAll('.navbar-mode-selector').forEach(chk => {
-      chk.checked = light
       chk.addEventListener('change', function () {
+        document.documentElement.setAttribute('data-bs-theme-animate', 'true')
         toggleTheme()
       })
     })
-
-    document.querySelectorAll('.ball').forEach(ball => {
-      ball.offsetHeight; // flush css changes
-      ball.classList.remove('notransition');
-    })
   })
 
-  window.addEventListener('load', () => {
-    const light = (document.documentElement.getAttribute('data-bs-theme') === 'light')
-    document.querySelectorAll('.navbar-mode-selector').forEach(chk => {
-      chk.checked = light
-    })
-  });  
+  // initialize theme directly when script is invoked
+  setTheme(getTheme())
 })()
 
 {{- end -}}

assets/js/critical/languageSelector.js

@@ -0,0 +1,65 @@
+/* eslint-disable */
+{{- if site.Params.main.enableLanguageSelectionStorage -}} 
+
+(() => {
+  'use strict'
+
+  // Function to get the selected language from localStorage
+  function getLanguage () {
+    return localStorage.getItem('selectedLanguage')
+  }
+
+  // Function to set the selected language in localStorage
+  function setLanguage (language) {
+    localStorage.setItem('selectedLanguage', language)
+  }
+  
+  // Function to apply the selected language to the website
+  function applyLanguage (language, href) {
+    if (document.documentElement.lang !== language) {
+      if (href) {
+        if (window.location.pathname !== href) {
+          window.location.href = href
+        }
+      } else {
+        window.location.href = '/' + language + '/'
+      }
+    }
+  }
+
+  // Event listener for language selection
+  document.addEventListener('DOMContentLoaded', () => {
+    const storedLanguage = getLanguage()
+    const languageItems = document.querySelectorAll('#language-selector .dropdown-item')
+
+    if (languageItems.length > 0) {
+      // Redirect if the stored language differs from the active language
+      if ((storedLanguage) && (document.documentElement.lang !== storedLanguage)) {
+        languageItems.forEach(item => {
+          if (item.getAttribute('hreflang') === storedLanguage) {
+            applyLanguage(storedLanguage, item.getAttribute('href'))
+          }
+        })
+      }
+
+      // Update the stored language when the user selects a new one
+      languageItems.forEach(item => {
+        item.addEventListener('click', () => {
+          const selectedLanguage = item.getAttribute('hreflang')
+
+          if (selectedLanguage) {
+            setLanguage(selectedLanguage)
+          }
+        })
+      })
+    }
+    else {
+      // Redirect to the localized homepage
+      const defaultLang = '{{ site.LanguageCode | default site.Language.Lang }}'
+      let language = storedLanguage ? storedLanguage : defaultLang
+      window.location.href = '/' + language + '/'
+    }
+  })
+})()
+{{- end -}} 
+/* eslint-enable */

assets/js/navbar.js

@@ -1,3 +1,4 @@
+const fixed = {{ site.Params.navigation.fixed }}
 const navbar = document.querySelector('.navbar')
 const togglers = document.querySelectorAll('.main-nav-toggler')
 const modeSelectors = document.querySelectorAll('.switch-mode-collapsed')
@@ -11,13 +12,16 @@ function updateNavbar () {
   } else {
     navbar.classList.remove('nav-active')
     const defaultTheme = navbar.getAttribute('data-bs-overlay')
-    navbar.setAttribute('data-bs-theme', defaultTheme)
+
+    if (defaultTheme) {
+      navbar.setAttribute('data-bs-theme', defaultTheme)
+    }
   }
 }
 
 if ((navbar !== null) && (window.performance.getEntriesByType)) {
   if (window.performance.getEntriesByType('navigation')[0].type === 'reload') {
-    updateNavbar()
+    fixed && updateNavbar()
   }
 }
 
@@ -29,7 +33,7 @@ if (navbar !== null && togglers !== null) {
     attributeFilter: ['data-bs-theme']
   }
   const Observer = new MutationObserver((mutationrecords) => {
-    updateNavbar()
+    fixed && updateNavbar()
   })
   Observer.observe(html, config)
 
@@ -40,7 +44,7 @@ if (navbar !== null && togglers !== null) {
 
   // set the navbar background color to opaque when scrolling past a breakpoint
   window.onscroll = () => {
-    updateNavbar()
+    fixed && updateNavbar()
   }
 
   // set the navbar background color to opaque when expanded

assets/js/video.js

@@ -0,0 +1,3 @@
+document.querySelectorAll('[data-video-padding]').forEach(element => {
+  element.style.paddingBottom = element.getAttribute('data-video-padding')
+})

assets/scss/app-dart.scss

@@ -39,6 +39,8 @@
 @import "components/toc.scss";
 @import "components/video.scss";
 @import "common/animation.scss";
+@import "common/masonry.scss";
+@import "common/scrollbar.scss";
 @import "common/styles.scss";
 @import "layouts/reboot.scss";
 @import "layouts/type.scss";

assets/scss/app.scss

@@ -37,6 +37,8 @@
 @import "components/toc.scss";
 @import "components/video.scss";
 @import "common/animation.scss";
+@import "common/masonry.scss";
+@import "common/scrollbar.scss";
 @import "common/styles.scss";
 @import "layouts/reboot.scss";
 @import "layouts/type.scss";

assets/scss/common/_masonry.scss

@@ -0,0 +1,38 @@
+.masonry {
+    --masonry-padding: 4px;
+}
+
+.m-row {
+    display: flex;
+    flex-wrap: wrap;
+    padding: 0 var(--masonry-padding);
+}
+
+.m-col {
+    flex: 100%;
+    max-width: 100%;
+    padding: 0 var(--masonry-padding);
+}
+
+.m-col div {
+    margin-top: calc(2 * var(--masonry-padding));
+    border-radius: 5px;
+}
+
+$utilities: map-merge(
+    $utilities,
+    (
+        "m-col": (
+            property: max-width,
+            responsive: true,
+            class: m-col,
+            values: (
+                1: 100%,
+                2: 50%,
+                3: 33.3%,
+                4: 25%,
+                5: 20%,
+            )
+        )
+    )
+);

assets/scss/common/_scrollbar.scss

@@ -0,0 +1,34 @@
+@mixin scrollbar(
+  $foreground-color: var(--bs-primary),
+  $background-color: var(--bs-tertiary-bg),
+  $size: 10px
+) {
+	// For Safari and Chrome (to force appearance in Chrome)
+	&::-webkit-scrollbar {
+		width: $size;
+		height: $size;
+	}
+
+	&::-webkit-scrollbar-thumb {
+		border-radius: calc($size / 2);
+		background: $foreground-color;
+	}
+
+	&::-webkit-scrollbar-track {
+		border-radius: calc($size / 2);
+		background: $background-color;
+	}
+
+	// Standard version (Firefox, only appears on scroll)
+	@supports (-moz-appearance:none) {
+		scrollbar-color: $foreground-color $background-color;
+	}
+}
+
+.scrollbar-horizontal
+{
+    @include scrollbar;
+
+	overflow-x: scroll;
+	margin: auto;
+}

assets/scss/common/_styles.scss

@@ -1,5 +1,5 @@
 @if $enable-dark-mode {
-    body { 
+    [data-bs-theme-animate="true"] body { 
         transition: background-color 0.5s, color 0.5s; 
     }
 }
@@ -146,6 +146,24 @@ $utilities: map-merge(
     }    
 }
 
+.main-cover {
+    min-height: 100vh;
+}    
+
+@include media-breakpoint-up(xxl) {
+    .main-cover {
+        min-height: calc(min(100vh, 1000px));
+    }    
+}
+
+/* stylelint-disable media-feature-range-notation */
+@media (min-height: 1400px) { 
+    .main-cover {
+        min-height: calc(min(100vh, 1000px));
+    }
+}
+/* stylelint-enable media-feature-range-notation */
+
 $utilities: map-merge(
     $utilities,
     (

assets/scss/components/_blockquote.scss

@@ -1,6 +1,54 @@
 .blockquote {
-    // background: var(--bs-light);
     border-left: 0.3rem solid;
     border-color: $secondary;
     padding: 1rem 1.5rem;
 }
+
+.blockquote-alert {
+    --bs-blockquote-alert-color: $secondary;
+
+    border-left: 0.3rem solid;
+    border-color: var(--bs-blockquote-alert-color);
+    padding: .5rem 1.5rem;
+}
+
+.blockquote-alert > p:nth-of-type(2) {
+    margin-bottom: 0;
+}
+
+.blockquote-alert-heading {
+    font-weight: bold;
+    color: var(--bs-blockquote-alert-color);
+}
+
+.blockquote-alert-caution {
+    --bs-blockquote-alert-color: var(--#{$prefix}danger);
+}
+
+.blockquote-alert-important {
+    --bs-blockquote-alert-color: var(--#{$prefix}primary);
+}
+
+.blockquote-alert-note {
+    --bs-blockquote-alert-color: var(--#{$prefix}info);
+}
+
+.blockquote-alert-tip {
+    --bs-blockquote-alert-color: var(--#{$prefix}success);
+}
+
+.blockquote-alert-warning {
+    --bs-blockquote-alert-color: var(--#{$prefix}warning);
+}
+
+.blockquote-alert a.btn-link {
+    --bs-link-color: var(--bs-blockquote-alert-color);
+    --bs-link-hover-color: color-mix(in srgb, var(--bs-link-color), black 20%);
+
+    color: var(--bs-link-color) !important;
+
+    &:hover,
+    &:focus {
+        color: var(--bs-link-hover-color) !important;
+    }
+}

assets/scss/components/_button.scss

@@ -44,4 +44,7 @@ a.btn {
 
 .btn-link {
     --bs-btn-padding-x: 0;
+    --bs-btn-padding-y: 0;
+
+    margin: 0 !important;
 }

assets/scss/components/_card.scss

@@ -5,11 +5,21 @@
     background-color: var(--#{$prefix}secondary-bg);
 }
 
-.card-img-wrap {
+.card .card-img-wrap {
     overflow: hidden;
     position: relative;
 }
 
+.card .card-img-wrap:has(.card-img-top) {
+  border-top-left-radius: var(--#{$prefix}card-inner-border-radius);
+  border-top-right-radius: var(--#{$prefix}card-inner-border-radius);
+}
+
+.card .card-img-wrap:has(.card-img-bottom) {
+  border-bottom-right-radius: var(--#{$prefix}card-inner-border-radius);
+  border-bottom-left-radius: var(--#{$prefix}card-inner-border-radius);
+}
+
 .card-zoom {
     cursor: pointer;
 }
@@ -97,3 +107,56 @@
 .card-button-link {
     text-decoration: underline if($enable-important-utilities, !important, null);
 }
+
+// support horizontally scrollable card groups
+.card-container-wrapper {
+	position: relative;
+}
+
+div.card-container-wrapper::after {
+	content: "";
+	position: absolute;
+	inset: 0;
+	height: calc(100% - 2rem);
+	background: linear-gradient(
+		90deg, 
+		var(--bs-body-bg) 0%,
+		transparent 1.5rem,
+		transparent calc(100% - 1.5rem),
+		var(--bs-body-bg) 100%
+	);
+	pointer-events: none;
+}
+
+.card-container {
+    padding-left: 1.5rem;
+    padding-right: 1.5rem;
+	gap: 1.5rem;
+    margin-bottom: 2rem;
+	scroll-snap-type: x proximity;
+}
+
+.card-block-1 {
+    width: 80%;
+	scroll-snap-align: center;
+}
+
+.card-block-2 {
+    width: 40%;
+	scroll-snap-align: center;
+}
+
+.card-block-3 {
+    width: 27%;
+	scroll-snap-align: center;
+}
+
+.card-block-4 {
+    width: 20%;
+	scroll-snap-align: center;
+}
+
+.card-block-5 {
+    width: 16%;
+	scroll-snap-align: center;
+}

assets/scss/components/_navbar.scss

@@ -1,11 +1,81 @@
 // stylelint-disable annotation-no-unknown
 
+// adapted from https://www.codeply.com/p/UsTEwDkzNp#
+.checkbox {
+	opacity: 0;
+	position: absolute;
+}
+
+.mode-switch {
+    --#{$prefix}mode-switch-width: 50px;
+}
+
+.mode-switch .label {
+	border-color: var(--#{$prefix}border-color);
+    border-style: solid;
+    border-width: 1px;
+	border-radius: var(--#{$prefix}mode-switch-width);
+	cursor: pointer;
+	display: flex;
+	align-items: center;
+	justify-content: space-between;
+	padding: 5px;
+	position: relative;
+	height: calc(1px + var(--#{$prefix}mode-switch-width) / 2);
+	width: var(--#{$prefix}mode-switch-width);
+    transform: scale(0.9);
+}
+
+.notransition {
+    -webkit-transition: none !important;
+    -moz-transition: none !important;
+    -o-transition: none !important;
+    transition: none !important;
+}
+
+.mode-switch .label .ball {
+    background-color: var(--#{$prefix}border-color);
+	border-radius: 50%;
+	position: absolute;
+	top: 2px;
+	left: 2px;
+	height: calc((var(--#{$prefix}mode-switch-width) / 2) - 5px);
+	width: calc((var(--#{$prefix}mode-switch-width) / 2) - 5px);
+	transition: transform 0.2s linear;
+}
+
+.mode-switch .checkbox:checked + .label .ball {
+	transform: translateX(calc((var(--#{$prefix}mode-switch-width) / 2) - 1px));
+}
+
+@if $enable-dark-mode {
+    [data-bs-theme="light"] .mode-switch .ball {
+        transform: translateX(calc((var(--#{$prefix}mode-switch-width) / 2) - 1px));
+    }
+}
+
+.mode-switch .fa-moon {
+	color: $yellow;
+    transform: scale(0.8);
+}
+
+.mode-switch .fa-sun {
+	color: var(--#{$prefix}bs-body-color);
+    transform: scale(0.8);
+}
+
 // Source: https://jsfiddle.net/njhgr40m/
+
+@if $enable-dark-mode {
+    [data-bs-theme-animate="true"] .navbar {
+        transition: 0.5s ease-in-out;
+    }
+}
+
 .navbar {
     --bs-navbar-expanded-color: var(--bs-body-bg);
     --bs-navbar-toggler-color: var(--bs-navbar-hover-color);
 
-    transition: 0.5s ease-in-out;
     background-color: transparent;
 
     @each $state, $val in $theme-colors {
@@ -22,6 +92,15 @@
     margin: 0 .15rem;
 }
 
+.navbar-title {
+    display: inline-block;
+    white-space: normal;
+    text-align: center !important;
+    vertical-align: middle;
+    padding: 0 $spacer;
+    width: 100% !important;
+}
+
 .navbar-contrast .nav-link.active, .navbar-contrast .nav-link.show, .navbar-contrast .nav-link:hover {
     border-bottom: solid 1px var(--bs-navbar-hover-color);
     margin-bottom: -1px;
@@ -33,6 +112,16 @@
     --bs-navbar-disabled-color: white !important;
     --bs-navbar-active-color: white !important;
     --bs-navbar-toggler-color: white;
+
+    .navbar-title, .mode-switch {
+        --#{$prefix}border-color: white;
+
+        color: white !important;
+    }
+
+    .mode-switch .fa-moon {
+        color: $white;
+    }
 }
 
 .navbar-expanded {
@@ -112,7 +201,7 @@
     background-color: var(--bs-navbar-toggler-color);
 }
 
-.emphasis, .emphasis-dark, .emphasis-light {
+.emphasis {
     background-color: var(--bs-navbar-toggler-color);
 }
 
@@ -133,15 +222,6 @@
     --navbar-offset: #{$navbar-offset-xs};
 }
 
-.navbar-title {
-    display: inline-block;
-    white-space: normal;
-    text-align: center !important;
-    vertical-align: middle;
-    padding: 0 $spacer;
-    width: 100% !important;
-}
-
 .navbar-container {
     width: 100% !important;
 }
@@ -235,60 +315,7 @@
     }
 }
 
-// adapted from https://www.codeply.com/p/UsTEwDkzNp#
-.checkbox {
-	opacity: 0;
-	position: absolute;
-}
-
-.mode-switch {
-    --#{$prefix}mode-switch-width: 50px;
-}
-
-.mode-switch .label {
-	border-color: var(--#{$prefix}border-color);
-    border-style: solid;
-    border-width: 1px;
-	border-radius: var(--#{$prefix}mode-switch-width);
-	cursor: pointer;
-	display: flex;
-	align-items: center;
-	justify-content: space-between;
-	padding: 5px;
-	position: relative;
-	height: calc(1px + var(--#{$prefix}mode-switch-width) / 2);
-	width: var(--#{$prefix}mode-switch-width);
-    transform: scale(0.9);
-}
-
-.notransition {
-    -webkit-transition: none !important;
-    -moz-transition: none !important;
-    -o-transition: none !important;
-    transition: none !important;
-}
-
-.mode-switch .label .ball {
-    background-color: var(--#{$prefix}secondary-bg);
-	border-radius: 50%;
-	position: absolute;
-	top: 2px;
-	left: 2px;
-	height: calc((var(--#{$prefix}mode-switch-width) / 2) - 5px);
-	width: calc((var(--#{$prefix}mode-switch-width) / 2) - 5px);
-	transition: transform 0.2s linear;
-}
-
-.mode-switch .checkbox:checked + .label .ball {
-	transform: translateX(calc((var(--#{$prefix}mode-switch-width) / 2) - 1px));
-}
-
-.mode-switch .fa-moon {
-	color: $yellow;
-    transform: scale(0.8);
-}
-
-.mode-switch .fa-sun {
-	color: var(--#{$prefix}bs-body-color);
-    transform: scale(0.8);
+.navbar-overlay {
+    position: absolute;
+    z-index: $zindex-fixed;
 }

assets/scss/components/_table.scss

@@ -1,3 +1,16 @@
+.datatable-container {
+    border-bottom: none if($enable-important-utilities, !important, null);
+}
+
+.datatable-bottom {
+    padding-top: 0 if($enable-important-utilities, !important, null);
+}
+
+.datatable-sorter {
+    padding-left: 0;
+    padding-right: 1rem;
+}
+
 @if $enable-dark-mode {
     @include color-mode(dark) {
         .table-striped, .table-striped-columns {
@@ -9,5 +22,13 @@
             --bs-table-hover-bg: var(--bs-tertiary-bg);
             --bs-table-striped-color: var(--bs-body-color);
         }
+
+        .datatable-pagination-list-item {
+            &:hover,
+            &:focus,
+            &.datatable-active {
+                color: var(--bs-body-bg) !important;
+            }
+        } 
     }
 }

assets/scss/components/_video.scss

@@ -1,11 +1,11 @@
-.youtube-embedded {
+.video-embedded {
     position: relative;
     padding-bottom: 56.25%;
     height: 0;
     overflow: hidden;
 }
 
-.youtube-embedded > iframe {
+.video-embedded > iframe {
     position: absolute;
     top: 0;
     left: 0;

config/_default/hugo.toml

@@ -1,7 +1,6 @@
 # toml-docs-start main
 title = "Hinode"
 copyright = "Copyright © 2024 Mark Dumay."
-paginate = 9
 enableGitInfo = true
 # toml-docs-end main
 
@@ -49,6 +48,9 @@ home = ["HTML", "RSS", "REDIR"]
 [taxonomies]
   tag = 'tags'
 
+[pagination]
+  pagerSize = 9
+
 [privacy]
   [privacy.vimeo]
     disabled = false
@@ -95,7 +97,7 @@ home = ["HTML", "RSS", "REDIR"]
 [module]
   [module.hugoVersion]
     extended = true
-    min = "0.120.0"
+    min = "0.134.0"
     max = ""
   [[module.mounts]]
     source = "archetypes"
@@ -125,7 +127,7 @@ home = ["HTML", "RSS", "REDIR"]
   [[module.imports]]
     path = "github.com/gethinode/mod-bootstrap"
   [[module.imports]]
-    path = "github.com/gethinode/mod-flexsearch"
+    path = "github.com/gethinode/mod-flexsearch/v2"
   [[module.imports]]
     path = "github.com/gethinode/mod-fontawesome"
   [[module.imports]]
@@ -134,6 +136,8 @@ home = ["HTML", "RSS", "REDIR"]
     path = "github.com/gethinode/mod-leaflet"
   [[module.imports]]
     path = "github.com/gethinode/mod-lottie"
+  [[module.imports]]
+    path = "github.com/gethinode/mod-simple-datatables"
   [[module.imports]]
     path = "github.com/gethinode/mod-utils/v2"
 # toml-docs-end modules

config/_default/markup.toml

@@ -24,9 +24,15 @@ defaultMarkdownHandler = "goldmark"
         table = true
         taskList = true
         typographer = true
+    [goldmark.extensions.passthrough]
+        enable = true
+    [goldmark.extensions.passthrough.delimiters]
+        block = [['\[', '\]'], ['$$', '$$']]
+        inline = [['\(', '\)'], ['$', '$']]
     [goldmark.parser]
         autoHeadingID = true
         autoHeadingIDType = 'github'
+        wrapStandAloneImageWithinParagraph = false
     [goldmark.parser.attribute]
         block = true
     [goldmark.renderer]

config/_default/params.toml

@@ -3,6 +3,7 @@
     separator = "-"
     description = "Hinode is a clean documentation and blog theme for your Hugo site based on Bootstrap 5."
     enableDarkMode = true
+    enableLanguageSelectionStorage = false
     modes = ["light", "dark"]
     canonifyAssetsURLs = false
     endorse = true
@@ -26,11 +27,24 @@
         host = "imgix"
 # toml-docs-end images
 
+# toml-docs-start videos
+[videos]
+    [videos.cloudinary]
+        host = "cloudinary"
+        account = "demo"
+    [videos.vimeo]
+        host = "vimeo"
+    [videos.youtube]
+        host = "youtube"
+# toml-docs-end videos
+
+
 # toml-docs-start debugging
 [debugging]
     showJS = false
     showSCSS = false
     purgeHTMLComments = false
+    includeSVGOrigin = true
 # toml-docs-end debugging
 
 # toml-docs-start docs
@@ -170,16 +184,16 @@
     # linkedIn = ""
     github = "https://github.com/gethinode/hinode"
     section = "blog"
-    [author]
+    [schema.author]
         name = "Mark Dumay"
         # twitter = "https://twitter.com/markdumay"
         linkedin = "https://www.linkedin.com/in/markdumay/"
         github = "https://github.com/markdumay"
-    [logo]
+    [schema.logo]
         url = "img/logo512x512.png"
         width = 512
         height = 512
-    [image]
+    [schema.image]
         url = "img/logo1280x640.png"
         width = 1280
         height = 640

config/_default/server.toml

@@ -14,7 +14,7 @@ for = '/**'
         connect-src 'self'
             https://*.google-analytics.com https://*.analytics.google.com https://*.googletagmanager.com; \
         font-src 'self' https://fonts.gstatic.com; \
-        frame-src 'self' https://www.youtube-nocookie.com https://www.youtube.com; \
+        frame-src 'self' https://player.cloudinary.com https://player.vimeo.com https://www.youtube-nocookie.com https://www.youtube.com; \
         img-src 'self' data: https://*.imgix.net https://*.imagekit.io https://*.cloudinary.com https://i.vimeocdn.com https://i.ytimg.com https://*.google-analytics.com https://*.googletagmanager.com https://tile.openstreetmap.org; \
         manifest-src 'self'; \
         media-src 'self' \
@@ -29,7 +29,6 @@ for = '/**'
         camera=(), \
         magnetometer=(), \
         gyroscope=(), \
-        fullscreen=(), \
         payment=() \
         """
     cache-control = """\

config/postcss.config.js

@@ -10,7 +10,7 @@ const purgecss = require('@fullhuman/postcss-purgecss')({
     return [...(els.tags || []), ...(els.classes || []), ...(els.ids || [])]
   },
   dynamicAttributes: ['data-bs-theme'],
-  safelist: [
+  safelist: ['was-validated',
     ...whitelister([
       './assets/scss/components/_clipboard.scss',
       './assets/scss/components/_command.scss',
@@ -24,9 +24,10 @@ const purgecss = require('@fullhuman/postcss-purgecss')({
       './assets/scss/components/_video.scss',
       './assets/scss/theme/fonts.scss',
       './assets/scss/theme/theme.scss',
-      './_vendor/github.com/gethinode/mod-flexsearch/assets/scss/modules/flexsearch/flexsearch.scss',
+      './_vendor/github.com/gethinode/mod-flexsearch/v2/assets/scss/modules/flexsearch/flexsearch.scss',
       './_vendor/github.com/gethinode/mod-katex/dist/katex.scss',
       './_vendor/github.com/gethinode/mod-leaflet/dist/leaflet.scss',
+      './_vendor/github.com/gethinode/mod-simple-datatables/dist/simple-datatables.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',

data/structures/card-group.yml

@@ -92,17 +92,21 @@ arguments:
     type: bool
     optional: true
     comment: >-
-      Flag to indicate a horizontal line should be added between items on small screens.
+      Flag to indicate a horizontal line should be added between items on small
+      screens.
   wrapper:
     type: string
+    default: p-0
     optional: true
     comment: >-
       Class attributes of the wrapper element, e.g. `p-4 px-xxl-0`.
   responsive:
     type: bool
     optional: true
+    default: true
     comment: >-
-      Flag indicating if the number of columns should be responsive, defaults to `true`.
+      Flag indicating if the number of columns should be responsive, defaults to
+      `true`.
   buttonType:
     type: select
     optional: true
@@ -113,8 +117,50 @@ arguments:
       values:
         - link
         - button
+  scroll:
+    type: bool
+    optional: true
+    comment: >-
+      Enables horizontal scrolling of the cards. By default, the card group
+      wraps any cards beyond the amount of defined columns to a new line. When
+      `scroll` is set to true, a horizontal scroll bar is added instead.
+  spacer:
+    type: bool
+    optional: true
+    comment: >-
+      Inserts a spacer before the card.
+    release: v0.24.16
+    group: partial
   hook:
     type: string
     optional: true
+    default: assets/card.html
     comment: Render hook for the card partial.
     group: partial
+  bento:
+    type: bool
+    optional: true
+    default: false
+    comment: >-
+      Trigger to use a bento-style layout instead of default grid layout.
+    release: v0.27.0
+  valign:
+    type: select
+    optional: true
+    comment: >-
+      Defines the vertical card alignment, only applicable in bento layout.
+    release: v0.27.0
+    options:
+      values:
+        - start
+        - center
+        - end
+  styles:
+    type:
+      - '[]map[string]interface {}'
+    optional: true
+    comment: >-
+      Styles to apply to the individual cards. Supported elements are `ratio`,
+      `orientation`, `portrait`, and `width`. The styles are rotated when the
+      amount of cards exceeds the available amount of styles.
+    release: v0.27.0

data/structures/card.yml

@@ -90,6 +90,19 @@ arguments:
         - publication
         - tags
         - none
+  body:
+    type: select
+    optional: true
+    default: full
+    parent: cascade
+    release: v0.24.16
+    comment: >-
+      Body of the card. 
+    options:
+      values:
+        - full
+        - title
+        - none
   footer:
     type: select
     optional: true
@@ -146,6 +159,16 @@ arguments:
         - 16x9
         - 21x9
     group: partial
+  portrait:
+    type: bool
+    parent: cascade
+    optional: true
+    default: false
+    release: v0.24.16
+    comment: >-
+      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.
   alt:
     type: string
     optional: true
@@ -157,6 +180,12 @@ arguments:
     optional: true
     comment: >-
       Font Awesome icon, displayed on top or the left of the card.
+  iconRounded:
+    type: bool
+    parent: cascade
+    optional: true
+    release: v0.24.8
+    comment: Stack the icon in a round container.
   align:
     type: select
     parent: cascade
@@ -169,6 +198,19 @@ arguments:
         - start
         - end
         - center
+  scroll:
+    type: bool
+    parent: cascade
+    optional: true
+    group: partial
+    comment: >-
+      Enables horizontal scrolling of the cards. By default, the card group
+      wraps any cards beyond the amount of defined columns to a new line. When
+      `scroll` is set to true, a horizontal scroll bar is added instead.
+  wrapper:
+    type: string
+    optional: true
+    comment: Element class of the card wrapper.
   style:
     type: string
     parent: cascade
@@ -186,6 +228,7 @@ arguments:
         - stacked
         - horizontal
         - horizontal-sm
+        - overlay
         - none
   subtle:
     type: bool
@@ -230,6 +273,25 @@ arguments:
       One or more strings separated by commas, indicating the source sizes of an
       image set.
     group: partial
+  anchor:
+    type: select
+    optional: true
+    comment: 
+      Anchor of the thumbnail's crop box, defaults to anchor value set in
+      `imaging` section of the site configuration (usually `Smart`).
+    options:
+      values:
+        - TopLeft
+        - Top
+        - TopRight
+        - Left
+        - Center
+        - Right
+        - BottomLeft
+        - Bottom
+        - BottomRight
+        - Smart
+    release: v0.24.23
 body:
   optional: true
   comment: >-

data/structures/image-adapter.yml

@@ -60,3 +60,20 @@ arguments:
     type: int
     optional: false
     comment: Width of the image in pixels.
+  anchor:
+    type: select
+    optional: true
+    comment: Anchor of the crop box.
+    options:
+      values:
+        - TopLeft
+        - Top
+        - TopRight
+        - Left
+        - Center
+        - Right
+        - BottomLeft
+        - Bottom
+        - BottomRight
+        - Smart
+

data/structures/image.yml

@@ -36,6 +36,7 @@ arguments:
   page:
     type:
       - '*hugolib.pageState'
+      - '*hugolib.pageForRenderHooks'
       - '*hugolib.pageForShortcode'
     optional: true
     comment: Page context, used to match page resources.
@@ -109,7 +110,10 @@ arguments:
       image set.
     group: partial
   title:
-    type: string
+    type:
+      - string
+      - hstring.RenderedString
+      - hstring.HTML
     optional: true
     comment: Alternate text of the image.
   caption:
@@ -138,3 +142,22 @@ arguments:
       Flag to indicate if the image should render a plain image instead of an
       image set. When set, no transformations are applied to the image.
     release: v0.24.0
+  anchor:
+    type: select
+    optional: true
+    comment: 
+      Anchor of the crop box, defaults to anchor value set in `imaging` section
+      of the site configuration (usually `Smart`).
+    options:
+      values:
+        - TopLeft
+        - Top
+        - TopRight
+        - Left
+        - Center
+        - Right
+        - BottomLeft
+        - Bottom
+        - BottomRight
+        - Smart
+    release: v0.24.22

data/structures/link.yml

@@ -10,6 +10,7 @@ arguments:
   page:
     type:
       - '*hugolib.pageState'
+      - '*hugolib.pageForRenderHooks'
       - '*hugolib.pageForShortcode'
     optional: false
     group: partial
@@ -70,11 +71,18 @@ arguments:
     type:
       - string
       - template.HTML
+      - hstring.RenderedString
+      - hstring.HTML
     optional: true
     group: partial
+    comment: Link description.
+  title:
+    type: string
+    optional: true
     comment: Link title.
+    release: v0.26.0
 body:
   type: string
   optional: true
   group: shortcode
-  comment: Link title.
+  comment: Link description.

data/structures/navbar-item.yml

@@ -32,3 +32,8 @@ arguments:
     comment: >-
       Flag to indicate if an external link should open in a new tab, defaults
       to setting `main.externalLinks.tab` in the site's parameters.
+  plain:
+    type: bool
+    optional: true
+    comment: >-
+      Renders the navigation item as plain item, ignoring any children.

data/structures/release.yml

@@ -38,3 +38,12 @@ arguments:
     optional: true
     default: false
     comment: Flag to render the release button inline.
+  type:
+    type: select
+    optional: true
+    default: button
+    comment: Type of the element.
+    options:
+      values:
+        - link
+        - button

data/structures/scripts.yml

@@ -0,0 +1,69 @@
+comment: >-
+  Bundles a JavaScript file for client-side processing. Scripts can be included
+  as critical, core, or optional file.
+arguments:
+  page:
+    type:
+      - '*hugolib.pageState'
+      - '*hugolib.pageForShortcode'
+    optional: false
+    comment: Context of the current page.
+  core:
+    type: bool
+    default: false
+    optional: true
+    comment: >-
+      Trigger to include all core files in the script bundle. Core bundles are
+      loaded asynchronously in each page of the site.
+  filename:
+    type: string
+    default: js/main.bundle.js
+    optional: true
+    comment: >-
+      Path of the target bundle file, relative to the site root.
+  match:
+    type: string
+    default: {js/*.js,js/vendor/**.js}
+    optional: true
+    comment: >-
+      Regular expression that defines the pattern of source files to be included
+      in the bundle. The pattern is relative to the project's `asset` folder.
+  header:
+    type: bool
+    default: false
+    comment: >-
+      Trigger to consider the script as loaded in the page header. When enabled,
+      it includes a script to load Google Analytics adjacent to any bundle
+      input.
+  localize:
+    type: bool
+    default: false
+    optional: true
+    comment: >-
+      Triggers the creation of a language-specific bundle file. The language
+      code is appended as suffix to the base name. For example, the English
+      version of `js/main.bundle.js` becomes `js/main.bundle.en.js`.
+  skipTemplate:
+    type: bool
+    default: false
+    optional: true
+    comment: >-
+      Script source input can contain Go Template magic. As such, Hinode
+      processes all input files with `resources.ExecuteAsTemplate`. However,
+      certain input files may be incompatible. Set `skipTemplate` to true to
+      skip template processing.
+  state:
+    type: select
+    optional: true
+    default: async
+    comment: >-
+      Defines the loading behavior of the script bundle. By default, scripts are
+      processed in the background and loaded when ready (`async`). Set the state
+      to `immediate` to load the script immediately (such as critical scripts).
+      Use 'defer' to load the script in relative order when the DOM is fully
+      built.
+    options:
+      values:
+        - async
+        - defer
+        - immediate

data/structures/table.yml

@@ -1,6 +1,7 @@
 comment: >-
   Makes a markdown table responsive. Responsive tables scroll horizontally to
-  improve their layout on smaller screens.
+  improve their layout on smaller screens. To features `sortable`, `paging`,
+  and `searchable` require the module `simple-datatables`.
 arguments:
   breakpoint:
     type: select
@@ -24,6 +25,21 @@ arguments:
     type: string
     optional: true
     comment: Class attribute of the table element, e.g. `table-striped-columns w-auto`.
+  sortable:
+    type: bool
+    optional: true
+    comment: Toggle the ability to sort the columns.
+    release: v0.24.13
+  paging:
+    type: bool
+    optional: true
+    comment: Whether paging is enabled for the table.
+    release: v0.24.13
+  searchable:
+    type: bool
+    optional: true
+    comment: Toggle the ability to search the dataset.
+    release: v0.24.13
 body:
   type: string
   optional: false

data/structures/video.yml

@@ -0,0 +1,90 @@
+comment: >-
+  Embeds a responsive video player for supported video providers. The video is
+  embedded in a responsive frame.
+arguments:
+  page:
+    type:
+      - '*hugolib.pageState'
+      - '*hugolib.pageForShortcode'
+    optional: false
+    group: partial
+    release: v0.26.5
+    comment: Context of the current page.
+  position:
+    type:
+      - 'text.Position'
+    optional: true
+    group: partial
+    release: v0.26.5
+    comment: Filename and position from which the shortcode was called.
+  host:
+    type: string
+    optional: true
+    default: youtube
+    release: v0.26.5
+    comment: >-
+      Host name of the video provider. It should match one of the registered
+      providers in the site's parameters under `videos`.
+  title:
+    type: string
+    optional: true
+    comment: >-
+      Title of the video. You can also set `autotitle` to retrieve the title
+      programmatically at build time, if supported by the provider.
+  class:
+    type: string
+    optional: true
+    position: 1
+    comment: >-
+      Class attribute of the video wrapper element.
+  id:
+    type: string
+    optional: false
+    position: 0
+    comment: Public ID of the video to be embedded.
+  account:
+    type: string
+    optional: true
+    comment: >-
+      Account name of the video asset, required by some digital asset managers.
+      You can also set the default account name in the site's parameters.
+    release: v0.26.5
+  autoplay:
+    type: bool
+    optional: true
+    default: false
+    comment: >-
+      Flag indicating the video should start playing immediately when loaded, if
+      supported by the browser. The audio will be muted.
+  autotitle:
+    type: bool
+    optional: true
+    default: false
+    release: v0.25.2
+    comment: >-
+      Trigger to retrieve the title from the video metadata, if supported by the
+      provider.
+  ratio:
+    type: select
+    optional: true
+    comment: >-
+      Ratio of the video. If set, determines the padding of the embedded video
+      frame. When not specified, the video dimensions used to calculate the
+      padding are retrieved programmatically.
+    options:
+      values:
+        - 1x1
+        - 3x2
+        - 4x3
+        - 16x9
+        - 21x9
+    release: v0.26.5
+  portrait:
+    type: bool
+    optional: true
+    default: false
+    comment: >-
+      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.
+    release: v0.26.5

data/structures/youtube.yml

@@ -1,26 +0,0 @@
-comment: >-
-  Embeds a responsive video player for YouTube videos. Only the ID of the video
-  is required. In privacy-enhanced mode, YouTube will not store information
-  about visitors on your website unless the user plays the embedded video.
-arguments:
-  title:
-    type: string
-    optional: true
-    comment: >-
-      Title of the video.
-  class:
-    type: string
-    optional: true
-    position: 1
-    comment: >-
-      Class attribute of the video wrapper element.
-  id:
-    type: string
-    optional: false
-    position: 0
-    comment: Identifier of the video to be embedded.
-  autoplay:
-    type: bool
-    optional: true
-    default: false
-    comment: Flag indicating the video should start playing immediately when loaded.

eslint.config.js

@@ -0,0 +1,14 @@
+'use strict'
+
+module.exports = require('neostandard')({
+  ignores: [
+    'assets/js/critical/languageSelector.js',
+    'assets/js/critical/color.js',
+    'assets/js/analytics.js',
+    'assets/js/flexsearch.js',
+    'assets/js/navbar.js',
+    'assets/js/sharing.js',
+    'assets/js/vendor',
+    'node_modules',
+  ]
+})

exampleSite/.gitignore

@@ -1,4 +1,5 @@
-/_vendor
+_vendor/
+exampleSite/public/
 public/
 resources/
 

exampleSite/config/_default/hugo.toml

@@ -1,7 +1,6 @@
 resourcedir = '../resources/'
 title = "Hinode"
 copyright = "Copyright © 2024 Mark Dumay."
-paginate = 9
 enableGitInfo = true
 
 # additional settings
@@ -39,6 +38,9 @@ home = ["HTML", "RSS", "REDIR"]
 [taxonomies]
   tag = 'tags'
 
+[pagination]
+  pagerSize = 9
+
 [privacy]
   [privacy.vimeo]
     disabled = false

exampleSite/config/_default/languages.toml

@@ -22,6 +22,8 @@ reference = "More Projects"
 languageName = "Nederlands"
 contentDir = "content/nl"
 weight = 2
+[nl.params.opengraph]
+locale = "nl_NL"
 [nl.params.head]
 tagline = "Een Hugo Thema"
 [nl.params.social]
@@ -39,6 +41,8 @@ reference = "Meer projecten"
 languageName = "Français"
 contentDir = "content/fr"
 weight = 2
+[fr.params.opengraph]
+locale = "fr_FR"
 [fr.params.head]
 tagline = "Un thème Hugo"
 [fr.params.social]

exampleSite/config/_default/markup.toml

@@ -24,9 +24,15 @@ defaultMarkdownHandler = "goldmark"
         table = true
         taskList = true
         typographer = true
+    [goldmark.extensions.passthrough]
+        enable = true
+    [goldmark.extensions.passthrough.delimiters]
+        block = [['\[', '\]'], ['$$', '$$']]
+        inline = [['\(', '\)'], ['$', '$']]
     [goldmark.parser]
         autoHeadingID = true
         autoHeadingIDType = 'github'
+        wrapStandAloneImageWithinParagraph = false
     [goldmark.parser.attribute]
         block = true
     [goldmark.renderer]

exampleSite/config/_default/params.toml

@@ -2,6 +2,7 @@
     separator = "-"
     description = "Hinode is a clean documentation and blog theme for your Hugo site based on Bootstrap 5."
     enableDarkMode = true
+    enableLanguageSelectionStorage = true
     modes = ["light", "dark"]
     canonifyAssetsURLs = false
     footerBelowFold = false
@@ -17,6 +18,7 @@
     showJS = false
     showSCSS = false
     purgeHTMLComments = true # prevents a Goldmark warning when processing HTML comments (as used by markdownlint)
+    includeSVGOrigin = true
 
 [docs]
     basePath = "/" # TODO: replace
@@ -163,16 +165,16 @@
     # linkedIn = ""
     github = "https://github.com/gethinode/hinode"
     section = "blog"
-    [author]
+    [schema.author]
         name = "Mark Dumay"
         # twitter = "https://twitter.com/markdumay"
         linkedin = "https://www.linkedin.com/in/markdumay/"
         github = "https://github.com/markdumay"
-    [logo]
+    [schema.logo]
         url = "img/logo512x512.png"
         width = 512
         height = 512
-    [image]
+    [schema.image]
         url = "img/logo1280x640.png"
         width = 1280
         height = 640

exampleSite/config/_default/server.toml

@@ -14,7 +14,7 @@ for = '/**'
         connect-src 'self'
             https://*.google-analytics.com https://*.analytics.google.com https://*.googletagmanager.com; \
         font-src 'self' https://fonts.gstatic.com; \
-        frame-src 'self' https://www.youtube-nocookie.com https://www.youtube.com; \
+        frame-src 'self' https://player.cloudinary.com https://player.vimeo.com https://www.youtube-nocookie.com https://www.youtube.com; \
         img-src 'self' data: https://*.imgix.net https://*.imagekit.io https://*.cloudinary.com https://i.vimeocdn.com https://i.ytimg.com https://*.google-analytics.com https://*.googletagmanager.com https://tile.openstreetmap.org; \
         manifest-src 'self'; \
         media-src 'self' \
@@ -29,7 +29,6 @@ for = '/**'
         camera=(), \
         magnetometer=(), \
         gyroscope=(), \
-        fullscreen=(), \
         payment=() \
         """
     cache-control = """\

exampleSite/config/postcss.config.js

@@ -10,7 +10,7 @@ const purgecss = require('@fullhuman/postcss-purgecss')({
     return [...(els.tags || []), ...(els.classes || []), ...(els.ids || [])]
   },
   dynamicAttributes: ['data-bs-theme'],
-  safelist: [
+  safelist: ['was-validated',
     ...whitelister([
       './_vendor/github.com/gethinode/hinode/assets/scss/components/_clipboard.scss',
       './_vendor/github.com/gethinode/hinode/assets/scss/components/_command.scss',
@@ -24,7 +24,7 @@ const purgecss = require('@fullhuman/postcss-purgecss')({
       './_vendor/github.com/gethinode/hinode/assets/scss/components/_video.scss',
       './_vendor/github.com/gethinode/hinode/assets/scss/theme/fonts.scss',
       './_vendor/github.com/gethinode/hinode/assets/scss/theme/theme.scss',
-      './_vendor/github.com/gethinode/mod-flexsearch/assets/scss/modules/flexsearch/flexsearch.scss',
+      './_vendor/github.com/gethinode/mod-flexsearch/v2/assets/scss/modules/flexsearch/flexsearch.scss',
       './_vendor/github.com/gethinode/mod-katex/dist/katex.scss',
       './_vendor/github.com/gethinode/mod-leaflet/dist/leaflet.scss',
       './_vendor/github.com/twbs/bootstrap/scss/_carousel.scss',

exampleSite/content/en/about.md

@@ -27,6 +27,6 @@ Additional features include:
 * Reusable Bootstrap components through configurable shortcodes and partials
 * Versioned documentation, including sidebar navigation and version switcher
 * Responsive image handling for multiple screen sizes and resolutions
-* Optimized search results, scoring 100 points for SEO on [PageSpeed Insights]({{< param "links.pagespeed" >}})
-* Secure by default, scoring A+ on [Mozilla Observatory test]({{< param "links.observatory" >}})
+* Optimized search results, scoring 100 points for SEO on [PageSpeed Insights]({{% param "links.pagespeed" %}})
+* Secure by default, scoring A+ on [Mozilla Observatory test]({{% param "links.observatory" %}})
 {.tickmark}

exampleSite/content/en/blog/bootstrap-elements.md

@@ -12,7 +12,7 @@ thumbnail:
   originURL: https://unsplash.com/photos/QLPWQvHvmII
 ---
 
-Hinode provides several shortcodes that wrap common Bootstrap components. Refer to the [official documentation]({{< param "links.hinode_docs" >}}) for more details.
+Hinode provides several shortcodes that wrap common Bootstrap components. Refer to the [official documentation]({{% param "links.hinode_docs" %}}) for more details.
 
 ## Abbr
 
@@ -121,7 +121,7 @@ As an example, the following shortcode displays a group of three buttons.
 
 ## Card
 
-As an example, the following shortcode displays a stacked card that links to the [about]({{< ref "about" >}}) page. It includes a custom header.
+As an example, the following shortcode displays a stacked card that links to the [about]({{% ref "about" %}}) page. It includes a custom header.
 
 <!-- markdownlint-disable MD037 -->
 {{< example lang="hugo" >}}
@@ -136,7 +136,7 @@ As an example, the following shortcode displays a card group of three elements.
 
 <!-- markdownlint-disable MD037 -->
 {{< example lang="hugo" >}}
-{{</* card-group padding="3" gutter="3" button=true buttonType="link" */>}}
+{{</* card-group padding="3" gutter="3" button=true buttonType="link" cols=2 scroll=true */>}}
     {{</* card title="Bootstrap framework" icon="fab bootstrap" */>}}
         Build fast, responsive sites with Bootstrap 5. Easily customize your site with the source
         Sass files.
@@ -255,14 +255,22 @@ As an example, the following shortcodes show a square check, a brand logo, a cir
 
 ## Image
 
-As an example, the following shortcode displays an image with rounded corners and a 21x9 aspect ratio.
+As an example, the following shortcode displays an image with rounded corners and a 4x3 aspect ratio in portrait mode.
 
 <!-- markdownlint-disable MD037 -->
 {{< example lang="hugo" >}}
-{{</* image src="img/flowers.jpg" ratio="21x9" caption="Figure caption" class="rounded" */>}}
+{{</* image src="img/flowers.jpg" ratio="4x3" caption="Figure caption" class="rounded col-md-6"
+  portrait=true wrapper="text-center" */>}}
 {{< /example >}}
 <!-- markdownlint-enable MD037 -->
 
+The same image, but then using Markdown syntax:
+
+{{< example lang="hugo" >}}
+![Flowers](/img/flowers.jpg "Figure caption")
+{class="rounded col-md-6" ratio="4x3" portrait=true wrapper="text-center"}
+{{< /example >}}
+
 As an example, the following shortcode displays a regular vector image.
 
 <!-- markdownlint-disable MD037 -->
@@ -410,7 +418,7 @@ As an example, the following shortcode displays superscript text.
 
 As an example, the following shortcode displays a responsive table.
 
-<!-- markdownlint-disable MD037 -->
+<!-- markdownlint-disable MD037 MD058 -->
 {{< example lang="markdown" >}}
 {{</* table */>}}
 | #  | Heading | Heading | Heading | Heading | Heading | Heading | Heading | Heading | Heading |
@@ -420,7 +428,7 @@ As an example, the following shortcode displays a responsive table.
 | 3. | cell    | cel     | cel     | cel     | cel     | cel     | cel     | cel     | cel     |
 {{</* /table */>}}
 {{< /example >}}
-<!-- markdownlint-enable MD037 -->
+<!-- markdownlint-enable MD037 MD058 -->
 
 ## Timeline
 
@@ -465,3 +473,33 @@ As an example, the following shortcode displays a tooltip for a colored hyperlin
 {{</* tooltip color="primary" title="Tooltip caption" href="#!" */>}}Tooltip{{</* /tooltip */>}} demonstration
 {{< /example >}}
 <!-- markdownlint-enable MD037 -->
+
+## Video
+
+As an example, the following shortcode displays an Elephants video hosted by Cloudinary.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* video host="cloudinary" account="demo" id="elephants" autoplay=true */>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+## Vimeo
+
+As an example, the following shortcode displays a Vimeo video.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* vimeo id="55073825" autoplay=true autotitle=true */>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+## Youtube
+
+As an example, the following shortcode displays a Hugo quickstart guide.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* youtube id="w7Ft2ymGmfc" autoplay=true autotitle=true */>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->

exampleSite/content/en/blog/components.md

@@ -10,10 +10,10 @@ thumbnail:
   authorURL: https://unsplash.com/@ryoji__iwata
   origin: Unsplash
   originURL: https://unsplash.com/photos/5siQcvSxCP8
-modules: ["katex", "leaflet", "lottie"]
+modules: ["leaflet", "lottie", "simple-datatables"]
 ---
 
-Hinode provides several shortcodes on top of the common [Bootstrap elements]({{< relref "bootstrap-elements" >}}). Refer to the [official documentation]({{< param "links.hinode_docs" >}}) for more details.
+Hinode provides several shortcodes on top of the common [Bootstrap elements]({{% relref "bootstrap-elements" %}}). Refer to the [official documentation]({{% param "links.hinode_docs" %}}) for more details.
 
 ## Animation
 
@@ -25,9 +25,52 @@ As an example, the following shortcode shows an animation that plays on hover.
 {{< /example >}}
 <!-- markdownlint-enable MD037 -->
 
+## Data tables
+
+As an example, the following shortcode displays a responsive table that uses advanced controls.
+
+<!-- markdownlint-disable MD037 MD058 -->
+{{< example lang="markdown" >}}
+{{</* table sortable="true" paging="true" searchable="true" */>}}
+|  #  | Heading |
+|-----|---------|
+|  1. | Item 1  |
+|  2. | Item 2  |
+|  3. | Item 3  |
+|  4. | Item 4  |
+|  5. | Item 5  |
+|  6. | Item 6  |
+|  7. | Item 7  |
+|  8. | Item 8  |
+|  9. | Item 9  |
+| 10. | Item 10  |
+| 11. | Item 11  |
+| 12. | Item 12  |
+| 13. | Item 13  |
+| 14. | Item 14  |
+| 15. | Item 15  |
+| 16. | Item 16  |
+| 17. | Item 17  |
+| 18. | Item 18  |
+| 19. | Item 19  |
+| 20. | Item 20  |
+| 21. | Item 21  |
+| 22. | Item 22  |
+| 23. | Item 23  |
+| 24. | Item 24  |
+| 25. | Item 25  |
+| 26. | Item 26  |
+| 27. | Item 27  |
+| 28. | Item 28  |
+| 29. | Item 29  |
+| 30. | Item 30  |
+{{</* /table */>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
 ## Formula (KaTeX)
 
-As an example, the following markdown renders two formulas using the KaTeX typesetting library.
+As an example, the following markdown renders two formulas using server-side math rendering using KaTeX.
 
 {{< example lang="markdown" >}}
 This is an inline $-b \pm \sqrt{b^2 - 4ac} \over 2a$ formula

exampleSite/content/en/blog/image.md

@@ -14,7 +14,7 @@ As an example, the following shortcode displays an image with rounded corners an
 
 <!-- markdownlint-disable MD037 -->
 {{< example lang="hugo" >}}
-{{</* image src="https://res.cloudinary.com/demo/image/upload/dog.webp"
+{{</* image src="https://res.cloudinary.com/demo/dog.webp"
     ratio="21x9" caption="Cloudinary image" class="rounded" plain=true */>}}
 {{< /example >}}
 <!-- markdownlint-enable MD037 -->
@@ -26,7 +26,7 @@ As an example, the following shortcode displays an image with rounded corners an
 <!-- markdownlint-disable MD037 -->
 {{< example lang="hugo" >}}
 {{</* image src="https://ik.imagekit.io/demo/default-image.jpg"
-    ratio="21x9" caption="ImageKit.io image" class="rounded" */>}}
+    ratio="21x9" caption="ImageKit.io image" class="rounded" anchor="Center" */>}}
 {{< /example >}}
 <!-- markdownlint-enable MD037 -->
 
@@ -37,6 +37,6 @@ As an example, the following shortcode displays an image with rounded corners an
 <!-- markdownlint-disable MD037 -->
 {{< example lang="hugo" >}}
 {{</* image src="https://assets.imgix.net/examples/bluehat.jpg"
-    ratio="21x9" caption="imgix image" class="rounded" */>}}
+    ratio="21x9" caption="imgix image" class="rounded" anchor="Top" */>}}
 {{< /example >}}
 <!-- markdownlint-enable MD037 -->

exampleSite/content/fr/about.md

@@ -28,6 +28,6 @@ Les fonctionnalités supplémentaires incluent:
 - Composants bootstrap réutilisables à travers des codes et partiels configurables
 - Documentation versionnée, incluant une navigation latérale et un sélecteur de version.
 - Gestion d'images adaptatives pour plusieurs tailles d'écran et résolutions.
-- Résultats de recherche optimisés, obtenant un score de 100 points pour le référencement (SEO) sur [PageSpeed Insights]({{< param "links.pagespeed" >}}).
-- Sécurisé par défaut, obtenant un score A+ au test [Mozilla Observatory]({{< param "links.observatory" >}})
+- Résultats de recherche optimisés, obtenant un score de 100 points pour le référencement (SEO) sur [PageSpeed Insights]({{% param "links.pagespeed" %}}).
+- Sécurisé par défaut, obtenant un score A+ au test [Mozilla Observatory]({{% param "links.observatory" %}})
 {.tickmark}

exampleSite/content/fr/blog/bootstrap-elements.md

@@ -13,7 +13,7 @@ thumbnail:
   originURL: https://unsplash.com/photos/QLPWQvHvmII
 ---
 
-Hinode propose plusieurs shortcodes qui enveloppent des composants Bootstrap courants. Consultez la [documentation officielle]({{< param "links.hinode_docs" >}}) pour plus de détails.
+Hinode propose plusieurs shortcodes qui enveloppent des composants Bootstrap courants. Consultez la [documentation officielle]({{% param "links.hinode_docs" %}}) pour plus de détails.
 
 ## Abbr
 
@@ -121,7 +121,7 @@ En-tête 6 {{</* badge title="Nouveau" */>}}
 
 ## Carte
 
-À titre d'exemple, le shortcode suivant affiche une carte empilée qui renvoie à la page [à propos]({{< ref "about" >}}). Elle inclut un en-tête personnalisé.
+À titre d'exemple, le shortcode suivant affiche une carte empilée qui renvoie à la page [à propos]({{% ref "about" %}}). Elle inclut un en-tête personnalisé.
 
 <!-- markdownlint-disable MD037 -->
 {{< example lang="hugo" >}}

exampleSite/content/fr/blog/components.md

@@ -14,7 +14,7 @@ thumbnail:
 modules: ["katex", "leaflet", "lottie"]
 ---
 
-Hinode propose plusieurs shortcodes en plus des [éléments Bootstrap]({{< relref "bootstrap-elements" >}}) courants. Consultez la [documentation officielle]({{< param "links.hinode_docs" >}}) pour plus de détails.
+Hinode propose plusieurs shortcodes en plus des [éléments Bootstrap]({{% relref "bootstrap-elements" %}}) courants. Consultez la [documentation officielle]({{% param "links.hinode_docs" %}}) pour plus de détails.
 
 ## Animation
 

exampleSite/content/nl/about.md

@@ -29,6 +29,6 @@ Overige functies:
 * Herbruikbare Bootstrap componenten via shortcodes en partials
 * Versiebeheer van documentatiepagina's, inclusief secundaire navigatie en selectie van versies
 * Optimalisering van foto's voor meerdere schermafmetingen en resoluties
-* Optimale zoekresultaten, met 100 punten voor SEO volgens [PageSpeed Insights]({{< param "links.pagespeed" >}})
-* Veilige communicatie, met een score van A+ volgens [Mozilla Observatory]({{< param "links.observatory" >}})
+* Optimale zoekresultaten, met 100 punten voor SEO volgens [PageSpeed Insights]({{% param "links.pagespeed" %}})
+* Veilige communicatie, met een score van A+ volgens [Mozilla Observatory]({{% param "links.observatory" %}})
 {.tickmark}

exampleSite/hugo_stats.json

@@ -3,8 +3,8 @@
     "tags": [
       "a",
       "abbr",
+      "annotation",
       "body",
-      "br",
       "button",
       "code",
       "div",
@@ -15,18 +15,28 @@
       "form",
       "h2",
       "h3",
-      "h5",
       "head",
       "hr",
       "html",
       "i",
+      "iframe",
       "img",
       "input",
       "label",
       "li",
       "link",
       "mark",
+      "math",
       "meta",
+      "mfrac",
+      "mi",
+      "mn",
+      "mo",
+      "mrow",
+      "mspace",
+      "msqrt",
+      "msub",
+      "msup",
       "nav",
       "noscript",
       "ol",
@@ -34,12 +44,14 @@
       "path",
       "pre",
       "script",
+      "semantics",
       "small",
       "span",
       "strong",
       "sub",
       "sup",
       "svg",
+      "symbol",
       "table",
       "tbody",
       "td",
@@ -103,11 +115,14 @@
       "btn-sm",
       "btn-social",
       "card",
+      "card-block-2",
       "card-body",
       "card-body-link",
       "card-body-margin",
       "card-button",
       "card-button-link",
+      "card-container",
+      "card-container-wrapper",
       "card-emphasize",
       "card-icon",
       "card-img-bg",
@@ -134,22 +149,24 @@
       "col-3",
       "col-4",
       "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-6",
       "col-md-8",
       "col-md-9",
       "col-md-auto",
       "col-sm-12",
       "col-sm-3",
       "col-sm-6",
+      "col-sm-9",
+      "col-xl-10",
+      "col-xl-2",
       "collapse",
       "collapsed",
       "container",
@@ -170,6 +187,7 @@
       "d-none-light",
       "d-sm-block",
       "d-sm-none",
+      "data-table",
       "display-1",
       "display-4",
       "dropdown",
@@ -179,7 +197,6 @@
       "dropdown-menu-end",
       "dropdown-toggle",
       "emphasis",
-      "emphasis-dark",
       "end-0",
       "fa",
       "fa-10x",
@@ -225,12 +242,15 @@
       "flex-fill",
       "flex-grow-1",
       "flex-md-grow-0",
+      "flex-nowrap",
+      "flex-row",
       "font-monospace",
       "footer",
       "form-control",
       "fs-3",
       "fs-5",
       "fs-6",
+      "fs-lg-5",
       "fs-md-5",
       "fw-30",
       "fw-bold",
@@ -259,6 +279,7 @@
       "justify-content-center",
       "justify-content-end",
       "justify-content-start",
+      "katex",
       "label",
       "lead",
       "leaflet-map",
@@ -291,6 +312,7 @@
       "mt-4",
       "mt-5",
       "mt-auto",
+      "mt-md-0",
       "multi-docs-collapse-15",
       "multi-file-collapse-1",
       "mx-auto",
@@ -320,11 +342,6 @@
       "navbar-toggler",
       "next",
       "no-js",
-      "offcanvas",
-      "offcanvas-body",
-      "offcanvas-header",
-      "offcanvas-start",
-      "offcanvas-title",
       "order-0",
       "order-1",
       "order-first",
@@ -381,6 +398,7 @@
       "row-cols-md-3",
       "row-cols-sm-2",
       "row-cols-sm-3",
+      "scrollbar-horizontal",
       "search",
       "search-input",
       "search-suggestions",
@@ -455,6 +473,7 @@
       "top-bar",
       "translate-middle",
       "translate-middle-y",
+      "video-embedded",
       "visually-hidden",
       "vr",
       "w-100",
@@ -496,10 +515,42 @@
       "collapse",
       "collapse-1",
       "command-prompt",
+      "custom-activity",
+      "data-tables",
       "docs",
       "documentation",
       "example",
       "exemple",
+      "fa-face-frown",
+      "fa-square-check",
+      "fab-bootstrap",
+      "fab-docker",
+      "fab-facebook",
+      "fab-github",
+      "fab-linkedin",
+      "fab-medium",
+      "fab-whatsapp",
+      "fab-x-twitter",
+      "fas-angle-left",
+      "fas-angle-right",
+      "fas-angles-left",
+      "fas-angles-right",
+      "fas-arrow-left",
+      "fas-arrow-right",
+      "fas-circle-check",
+      "fas-code",
+      "fas-ellipsis",
+      "fas-globe",
+      "fas-heart",
+      "fas-house",
+      "fas-link",
+      "fas-magnifying-glass",
+      "fas-moon",
+      "fas-rocket",
+      "fas-share-nodes",
+      "fas-sort",
+      "fas-sun",
+      "fas-up-right-from-square",
       "fichier",
       "fil-dariane",
       "file",
@@ -516,6 +567,7 @@
       "indicateur-de-chargement",
       "infobulle",
       "invite-de-commandes",
+      "language-selector",
       "leaflet-map-0",
       "lien",
       "link",
@@ -537,8 +589,6 @@
       "navbar-sample-collapse",
       "navigation",
       "notification",
-      "offcanvas-label",
-      "offcanvass-sidebar",
       "persona",
       "projecten",
       "projects",
@@ -558,7 +608,10 @@
       "toast-example-2",
       "toast-message-email-4",
       "toc-collapse",
-      "tooltip"
+      "tooltip",
+      "video",
+      "vimeo",
+      "youtube"
     ]
   }
 }

go.mod

@@ -4,13 +4,14 @@ go 1.19
 
 require (
 	github.com/airbnb/lottie-web v5.12.2+incompatible // indirect
-	github.com/gethinode/mod-bootstrap v1.3.0 // indirect
-	github.com/gethinode/mod-flexsearch v1.12.0 // indirect
-	github.com/gethinode/mod-fontawesome v1.9.0 // indirect
-	github.com/gethinode/mod-katex v1.1.0 // indirect
-	github.com/gethinode/mod-leaflet v1.1.0 // indirect
-	github.com/gethinode/mod-lottie v1.5.4 // indirect
-	github.com/gethinode/mod-utils/v2 v2.3.8 // indirect
-	github.com/nextapps-de/flexsearch v0.0.0-20240110101704-4c3966709f85 // indirect
+	github.com/gethinode/mod-bootstrap v1.3.1 // indirect
+	github.com/gethinode/mod-flexsearch/v2 v2.0.1 // indirect
+	github.com/gethinode/mod-fontawesome v1.10.0 // indirect
+	github.com/gethinode/mod-katex v1.1.2 // indirect
+	github.com/gethinode/mod-leaflet v1.1.1 // indirect
+	github.com/gethinode/mod-lottie v1.5.8 // indirect
+	github.com/gethinode/mod-simple-datatables v1.0.10 // indirect
+	github.com/gethinode/mod-utils/v2 v2.7.0 // indirect
+	github.com/nextapps-de/flexsearch v0.0.0-20240501124520-961c3ae84a87 // indirect
 	github.com/twbs/bootstrap v5.3.3+incompatible // indirect
 )

go.sum

@@ -22,6 +22,8 @@ github.com/gethinode/mod-bootstrap v1.2.8 h1:kIKSO6qqE8xA0KQC5s6kkEv5UDc8oT17Hal
 github.com/gethinode/mod-bootstrap v1.2.8/go.mod h1:CL9IDot6nbXIWJYE/KxfsTdYYEJIGL17BXbAYPn+wVQ=
 github.com/gethinode/mod-bootstrap v1.3.0 h1:UxNmXgXo7gA8C8z1ar47+tSccmKYpaYBBN+txB0pwBk=
 github.com/gethinode/mod-bootstrap v1.3.0/go.mod h1:CL9IDot6nbXIWJYE/KxfsTdYYEJIGL17BXbAYPn+wVQ=
+github.com/gethinode/mod-bootstrap v1.3.1 h1:ZUX72St0WZ5tyXpEPBJlayX/dmCH3cGErzsozkUKCok=
+github.com/gethinode/mod-bootstrap v1.3.1/go.mod h1:CL9IDot6nbXIWJYE/KxfsTdYYEJIGL17BXbAYPn+wVQ=
 github.com/gethinode/mod-flexsearch v1.0.1 h1:FJkRsUzSnQTXl3MWCigT4E6vfff870UWTnkGqaDGIhA=
 github.com/gethinode/mod-flexsearch v1.0.1/go.mod h1:TXbGbWsvmhBdsTzRt887mcpFfr4ORpzG3+h/l4W3YM4=
 github.com/gethinode/mod-flexsearch v1.1.0 h1:7BCMyQDlYlskNXuazt8Jg/jg9WREexu2xVkYqThkAX4=
@@ -68,6 +70,10 @@ github.com/gethinode/mod-flexsearch v1.11.3 h1:ykxpUg8M4vr1C4QzxJOPGt+1ZmPAD/gOC
 github.com/gethinode/mod-flexsearch v1.11.3/go.mod h1:L8hrnpupx27cez2ObMX8gWnhbW6qss4HGH1Ea4UaBRQ=
 github.com/gethinode/mod-flexsearch v1.12.0 h1:zg1IHvc8VO9WEtQuQnuG6HeWFNByvyqC9JYWDtpsP6s=
 github.com/gethinode/mod-flexsearch v1.12.0/go.mod h1:L8hrnpupx27cez2ObMX8gWnhbW6qss4HGH1Ea4UaBRQ=
+github.com/gethinode/mod-flexsearch v1.12.1 h1:clkGUWaNPe9Dt/66Apy7oH9NwVQfnD6OpGSLffeC9sY=
+github.com/gethinode/mod-flexsearch v1.12.1/go.mod h1:L8hrnpupx27cez2ObMX8gWnhbW6qss4HGH1Ea4UaBRQ=
+github.com/gethinode/mod-flexsearch/v2 v2.0.1 h1:5unGUSb1tX1LBtKygnLfdt7CnVJuFKSt6VXiKRxdojc=
+github.com/gethinode/mod-flexsearch/v2 v2.0.1/go.mod h1:d7MMkVlz0l6cEk76e0mkveEsDxGfu5Sv+HUIhoGguhE=
 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=
@@ -108,6 +114,10 @@ github.com/gethinode/mod-fontawesome v1.8.2 h1:LAzLytyh9c9gLzBWMju6Gtp3uEojhBQEY
 github.com/gethinode/mod-fontawesome v1.8.2/go.mod h1:xBKsZH3WJtMOItZVlp9SbO51uaBy6IbvUZSKpNu3b6Y=
 github.com/gethinode/mod-fontawesome v1.9.0 h1:xqUB8AnezMHAt8lye4ksqvmHSVPCOkiHsHGUbqNoeP0=
 github.com/gethinode/mod-fontawesome v1.9.0/go.mod h1:xBKsZH3WJtMOItZVlp9SbO51uaBy6IbvUZSKpNu3b6Y=
+github.com/gethinode/mod-fontawesome v1.9.1 h1:cQk84vriqffM4fuUUoM9j3SSD+3ppeW2j4ta7AiToMU=
+github.com/gethinode/mod-fontawesome v1.9.1/go.mod h1:xBKsZH3WJtMOItZVlp9SbO51uaBy6IbvUZSKpNu3b6Y=
+github.com/gethinode/mod-fontawesome v1.10.0 h1:Izs2AKc+YVBa1TywcH54OKLTNCUMXRoFIqOs+n0FgOo=
+github.com/gethinode/mod-fontawesome v1.10.0/go.mod h1:xBKsZH3WJtMOItZVlp9SbO51uaBy6IbvUZSKpNu3b6Y=
 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=
@@ -128,6 +138,10 @@ github.com/gethinode/mod-katex v1.0.9 h1:cCJoR28tZwkDvXps17o9Jwfe3aQQAZ3Rxk0jCNR
 github.com/gethinode/mod-katex v1.0.9/go.mod h1:byAfpI3wuqNJIooTGVEGc1cjBhhCy4+CcK1H6495MYg=
 github.com/gethinode/mod-katex v1.1.0 h1:PxST3HPUt6F2X/xKakTVeTkwWqCtEr53K1vYEOyQu3I=
 github.com/gethinode/mod-katex v1.1.0/go.mod h1:byAfpI3wuqNJIooTGVEGc1cjBhhCy4+CcK1H6495MYg=
+github.com/gethinode/mod-katex v1.1.1 h1:z8+mfVI6UTWcfpQMVPIzxQzt6Lp9BcmXxSOILQ84qFg=
+github.com/gethinode/mod-katex v1.1.1/go.mod h1:byAfpI3wuqNJIooTGVEGc1cjBhhCy4+CcK1H6495MYg=
+github.com/gethinode/mod-katex v1.1.2 h1:TbeVIWeG5TqldlVxpM1upOWj11RljXy4fhpOQIwOnS4=
+github.com/gethinode/mod-katex v1.1.2/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=
@@ -146,6 +160,8 @@ github.com/gethinode/mod-leaflet v1.0.1 h1:L4Coe6HTD9O0Txs1S8AtVg+6/TEneSF9i6fJK
 github.com/gethinode/mod-leaflet v1.0.1/go.mod h1:Ei0x9WiL7Dbi4JeG6yI1CE63bT1QJ8sKi67Jea1wFSE=
 github.com/gethinode/mod-leaflet v1.1.0 h1:FXzPCic5XmUluxQ6e7LYUhhLnxuQOBwry8qjG9k30UY=
 github.com/gethinode/mod-leaflet v1.1.0/go.mod h1:Ei0x9WiL7Dbi4JeG6yI1CE63bT1QJ8sKi67Jea1wFSE=
+github.com/gethinode/mod-leaflet v1.1.1 h1:AIHR4k8SjmeoZxtjLgSS6/N3jKeZNZGdZTgu/7MwP4c=
+github.com/gethinode/mod-leaflet v1.1.1/go.mod h1:Ei0x9WiL7Dbi4JeG6yI1CE63bT1QJ8sKi67Jea1wFSE=
 github.com/gethinode/mod-lottie v1.0.0 h1:1CUZMcgN5FAyjjyuP3qkaOQ6M5sv6HUAbosW4sIT5VE=
 github.com/gethinode/mod-lottie v1.0.0/go.mod h1:erRCgSL2FCfKHI0jQbSpM+g0jXl7SjKVJrh7kWGteKs=
 github.com/gethinode/mod-lottie v1.0.1 h1:+IE7xtnSVQpJS56oBJq9RWKZeFEfxrOZAqE3BSrS/u0=
@@ -182,6 +198,32 @@ github.com/gethinode/mod-lottie v1.5.3 h1:fvCjCoZoCEhY2aou30oEsEo6N4tVSI0ijFyXS3
 github.com/gethinode/mod-lottie v1.5.3/go.mod h1:XHVMuPsuJIm9/Eb2ql4jsT49/BQqMlBiirQoty4uHAo=
 github.com/gethinode/mod-lottie v1.5.4 h1:+xbamSsjcnP2tyzGl0CA1enma7gkAp67wenmuP0XELY=
 github.com/gethinode/mod-lottie v1.5.4/go.mod h1:gALqz48aYpoDLxJOI3LzIpdy0Eq/lOBNtlcOxABa9tg=
+github.com/gethinode/mod-lottie v1.5.5 h1:uEJKsz+ovsZtbGkMhPONcIhtG6M3RjYiK+iVoScLOVo=
+github.com/gethinode/mod-lottie v1.5.5/go.mod h1:VTvBxD8VokICwnEqM0VUZFZHBYxLf4/grDFQyEh1DL0=
+github.com/gethinode/mod-lottie v1.5.6 h1:dxz5nmD0XXEt/DAOc1s5fIPynj5bhzDL32EEwLFCSmk=
+github.com/gethinode/mod-lottie v1.5.6/go.mod h1:VTvBxD8VokICwnEqM0VUZFZHBYxLf4/grDFQyEh1DL0=
+github.com/gethinode/mod-lottie v1.5.7 h1:hcf04kmKv7xrI2byxtgHwkScYIHfP9aquInHNZP+qbk=
+github.com/gethinode/mod-lottie v1.5.7/go.mod h1:rhWg+MSSnWmqHKNEViE/9/78RjQD6uWWFASgjvFjgyo=
+github.com/gethinode/mod-lottie v1.5.8 h1:glg5HcjOBkFt5MoF7p24NN+RzctExPQUDXvdhPx9u6I=
+github.com/gethinode/mod-lottie v1.5.8/go.mod h1:Z/FlAcCJWYI1Z9tQnL0yRN4lqhyZl9CqYpfJUPVDaGc=
+github.com/gethinode/mod-simple-datatables v1.0.0 h1:Dj4WGw12OkaimwkCpLn5Jhmd49dvNJW9O2P/W9F+HlQ=
+github.com/gethinode/mod-simple-datatables v1.0.0/go.mod h1:K8T7fIdb8pMOB+OSW4A5lz5IW99+HyzcTgx764fvOGw=
+github.com/gethinode/mod-simple-datatables v1.0.2 h1:zhqxHet3iLQWYCBbGROALpOY9zQlptMycFkz1Tto5bA=
+github.com/gethinode/mod-simple-datatables v1.0.2/go.mod h1:mmrcvAJU2i3SMU56VmQ5PW43uDXBcsJKcZwCHrvl3Kc=
+github.com/gethinode/mod-simple-datatables v1.0.3 h1:JL2nBlEHWMmkE7EZrpfpmzka47dklJUh23/xKJkOQoI=
+github.com/gethinode/mod-simple-datatables v1.0.3/go.mod h1:mmrcvAJU2i3SMU56VmQ5PW43uDXBcsJKcZwCHrvl3Kc=
+github.com/gethinode/mod-simple-datatables v1.0.5 h1:2Aa4k1Bd1WEYHbskFQj+1X35BB7abB8RXHE7Uk2N4pg=
+github.com/gethinode/mod-simple-datatables v1.0.5/go.mod h1:mmrcvAJU2i3SMU56VmQ5PW43uDXBcsJKcZwCHrvl3Kc=
+github.com/gethinode/mod-simple-datatables v1.0.6 h1:voKiwLAfC7kfD+atv7ah0sOf8OcPRyxEB/Q92gx1d00=
+github.com/gethinode/mod-simple-datatables v1.0.6/go.mod h1:Y7AzIYAWpzDKLvH96eqBA/Gs3jompWCgxadLuoKZ/rc=
+github.com/gethinode/mod-simple-datatables v1.0.7 h1:pfxWhgmn/njJcynNIDnUyeOBW0tsy2E4TP21sEYsqRs=
+github.com/gethinode/mod-simple-datatables v1.0.7/go.mod h1:Y7AzIYAWpzDKLvH96eqBA/Gs3jompWCgxadLuoKZ/rc=
+github.com/gethinode/mod-simple-datatables v1.0.8 h1:J8hA+SXdTLaRNZwN70ZEyADn+VgNoAaxVDMXsMPTZBg=
+github.com/gethinode/mod-simple-datatables v1.0.8/go.mod h1:RsTHWAt1J9/m7kzhYNSJB7CDyk+8DrG+46/aFrP6KJw=
+github.com/gethinode/mod-simple-datatables v1.0.9 h1:8OnpY/axFkgxJ598DHW4nDtxsCYmgTakAG4ZC2wRS3A=
+github.com/gethinode/mod-simple-datatables v1.0.9/go.mod h1:rgQWdDZ6lTR9+08dGY1zBDLZI/UneKPufakAK20+lmI=
+github.com/gethinode/mod-simple-datatables v1.0.10 h1:/nYy4oCgooUJhTBgLdQzMnJEjolkD+dp2nkfLNT9Klg=
+github.com/gethinode/mod-simple-datatables v1.0.10/go.mod h1:rgQWdDZ6lTR9+08dGY1zBDLZI/UneKPufakAK20+lmI=
 github.com/gethinode/mod-utils v1.0.0 h1:cqHm2xS5uDiJzRm1KfHaNbq6uMVDKLhQa8/BuTZ1nhY=
 github.com/gethinode/mod-utils v1.0.0/go.mod h1:ONJm3pHCq7nvaPNjusLZNCeCbhOhSBH4HVKHwK1FdYE=
 github.com/gethinode/mod-utils v1.0.1 h1:jhZGlGFHHL1f5HXbBMXfiZ2gCz4TVafAzjnRPTIBSEE=
@@ -224,12 +266,28 @@ github.com/gethinode/mod-utils/v2 v2.3.7 h1:FFsUPO7NBp9Bhjovf0Ki5hnDGfeMKV/3RNz1
 github.com/gethinode/mod-utils/v2 v2.3.7/go.mod h1:GTYeknoLujNjfDxI+V9Dcug26CYJSTJ0B/U2dagw9oY=
 github.com/gethinode/mod-utils/v2 v2.3.8 h1:zAiDRCb3SsP9z6PUkCaiRLHOpqFhVf0xVhVOoTZNmAI=
 github.com/gethinode/mod-utils/v2 v2.3.8/go.mod h1:GTYeknoLujNjfDxI+V9Dcug26CYJSTJ0B/U2dagw9oY=
+github.com/gethinode/mod-utils/v2 v2.3.9 h1:Z9uAr6S0wunlkfKHa2D/U83fBV6Ivtf+7sjBAcrddrg=
+github.com/gethinode/mod-utils/v2 v2.3.9/go.mod h1:GTYeknoLujNjfDxI+V9Dcug26CYJSTJ0B/U2dagw9oY=
+github.com/gethinode/mod-utils/v2 v2.3.10 h1:+coUXdgAbLEE8Tvb3Rfk/1Nr6oDVreXI2sil0pa/n2Q=
+github.com/gethinode/mod-utils/v2 v2.3.10/go.mod h1:GTYeknoLujNjfDxI+V9Dcug26CYJSTJ0B/U2dagw9oY=
+github.com/gethinode/mod-utils/v2 v2.4.0 h1:mmG4hWaeA4krAg933pibH+TrjFmPHkAi/DUbe3SM38I=
+github.com/gethinode/mod-utils/v2 v2.4.0/go.mod h1:GTYeknoLujNjfDxI+V9Dcug26CYJSTJ0B/U2dagw9oY=
+github.com/gethinode/mod-utils/v2 v2.5.0 h1:9QboNU9KTpmJDS9JBjxavbknLVBJilocqo5KhC2FdME=
+github.com/gethinode/mod-utils/v2 v2.5.0/go.mod h1:GTYeknoLujNjfDxI+V9Dcug26CYJSTJ0B/U2dagw9oY=
+github.com/gethinode/mod-utils/v2 v2.5.2 h1:URGTpJo0dN4/oF2yL6o2d2pkcSlG1F0hgIF9UqpIs/E=
+github.com/gethinode/mod-utils/v2 v2.5.2/go.mod h1:GTYeknoLujNjfDxI+V9Dcug26CYJSTJ0B/U2dagw9oY=
+github.com/gethinode/mod-utils/v2 v2.6.0 h1:r7l/E6fbPZHnjFyJY4T/xzekd7Xp3czNVCMgKoKR8wc=
+github.com/gethinode/mod-utils/v2 v2.6.0/go.mod h1:GTYeknoLujNjfDxI+V9Dcug26CYJSTJ0B/U2dagw9oY=
+github.com/gethinode/mod-utils/v2 v2.7.0 h1:5CKygjsc7X4dFtb90ihWyDVvUp2iqoJE8C7M+jeWYus=
+github.com/gethinode/mod-utils/v2 v2.7.0/go.mod h1:GTYeknoLujNjfDxI+V9Dcug26CYJSTJ0B/U2dagw9oY=
 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/nextapps-de/flexsearch v0.0.0-20240108021025-afd75f742f22 h1:re7L8FxbXQpnX8BgzkdUnDpsUmloGNyLmiy2ZCln8pg=
 github.com/nextapps-de/flexsearch v0.0.0-20240108021025-afd75f742f22/go.mod h1:5GdMfPAXzbA2gXBqTjC6l27kioSYzHlqDMh0+wyx7sU=
 github.com/nextapps-de/flexsearch v0.0.0-20240110101704-4c3966709f85 h1:H6xa5YyCHr78M+qqCApM4Kvz/eMA7pfGskYmfkEBRCA=
 github.com/nextapps-de/flexsearch v0.0.0-20240110101704-4c3966709f85/go.mod h1:5GdMfPAXzbA2gXBqTjC6l27kioSYzHlqDMh0+wyx7sU=
+github.com/nextapps-de/flexsearch v0.0.0-20240501124520-961c3ae84a87 h1:6PNbL0/LxO8Xl8MZSe5uvCidYNpFTz9nlWTqj2qdlzA=
+github.com/nextapps-de/flexsearch v0.0.0-20240501124520-961c3ae84a87/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=
 github.com/twbs/bootstrap v5.3.3+incompatible h1:goFoqinzdHfkeegpFP7pvhbd0g+A3O2hbU3XCjuNrEQ=

hugo_stats.json

@@ -24,8 +24,10 @@
       "span",
       "strong",
       "svg",
+      "symbol",
       "title",
-      "ul"
+      "ul",
+      "use"
     ],
     "classes": [
       "active",
@@ -108,7 +110,9 @@
       "ms-auto",
       "ms-md-3",
       "mt-3",
+      "mt-4",
       "mt-5",
+      "mt-md-0",
       "mx-auto",
       "mx-md-0",
       "my-auto",
@@ -169,6 +173,14 @@
       "top-bar"
     ],
     "ids": [
+      "fa-face-frown",
+      "fab-github",
+      "fab-linkedin",
+      "fab-medium",
+      "fas-book-open",
+      "fas-ellipsis",
+      "fas-moon",
+      "fas-sun",
       "navbar-0-collapse",
       "navbar-mode",
       "navbar-mode-checkbox",

i18n/de.yaml

@@ -23,12 +23,28 @@
   translation: "Artikel"
 - id: more
   translation: "Weitere {{ . }}"
+- id: emptyList
+  translation: "Keine weiteren Artikel gefunden"
+- id: emptyTags
+  translation: "Keine Schlagworte gefunden"
+- id: readMore
+  translation: "Weiterlesen"
+
+# Languages
+- id: lang_de
+  translation: "Deutsch"
+- id: lang_en
+  translation: "Englisch"
+- id: lang_nl
+  translation: "Niederländisch"
+- id: lang_fr
+  translation: "Französisch"
 
 # Sharing
 - id: shareLink
   translation: "Diese Seite teilen per {{ . }}"
 - id: shareSystem
-  translation: "Betriebssystem"
+  translation: "System"
 - id: copyToClipboard
   translation: "In die Zwischenablage kopieren"
 - id: copiedToClipboard
@@ -52,7 +68,7 @@
 
 # Navigation
 - id: colorMode
-  translation: "Thema umschalten"
+  translation: "Modus umschalten"
 - id: colorLight
   translation: "Light"
 - id: colorDark
@@ -76,7 +92,7 @@
 
 # Sidebar
 - id: toggleSidebar
-  translation: "Menünavigation anzuzeigen oder auszublenden"
+  translation: "Menünavigation anzeigen oder ausblenden"
 
 # Feature
 - id: addedFeature
@@ -110,6 +126,32 @@
 
 # Comments
 - id: show
-  translation: "Zeige"
+  translation: "Anzeigen"
 - id: comments
   translation: "Kommentare"
+
+# Arguments
+- id: name
+  translation: "Name"
+- id: type
+  translation: "Typ"
+- id: required
+  translation: "Erforderlich"
+- id: default
+  translation: "Standard"
+- id: comment
+  translation: "Kommentar"
+- id: supportedValues
+  translation: "Unterstützte Werte"
+
+# Alerts
+- id: caution
+  translation: Vorsicht
+- id: important
+  translation: Wichtig
+- id: note
+  translation: Hinweis
+- id: tip
+  translation: Tipp
+- id: warning
+  translation: Warnung

i18n/en.yaml

@@ -149,3 +149,15 @@
   translation: "Comment"
 - id: supportedValues
   translation: "Supported values"
+
+# Alerts
+- id: caution
+  translation: Caution
+- id: important
+  translation: Important
+- id: note
+  translation: Note
+- id: tip
+  translation: Tip
+- id: warning
+  translation: Warning

i18n/nl.yaml

@@ -148,3 +148,15 @@
   translation: "Toelichting"
 - id: supportedValues
   translation: "Toegestane waarden"
+
+# Alerts
+- id: caution
+  translation: Voorzichtig
+- id: important
+  translation: Belangrijk
+- id: note
+  translation: Opmerking
+- id: tip
+  translation: Tip
+- id: warning
+  translation: Waarschuwing

layouts/_default/_markup/render-blockquote.html

@@ -0,0 +1,31 @@
+{{/* Adapted from https://gohugo.io/render-hooks/blockquotes/#alerts */}}
+
+{{ $icons := dict
+    "caution" "fa hand"
+    "important" "fas exclamation"
+    "note" "fas circle-info"
+    "tip" "fa lightbulb"
+    "warning" "fas triangle-exclamation"
+}}
+
+{{ if eq .Type "alert" }}
+    {{ $alert := .AlertType }}
+    {{ $icon := (index $icons $alert) }}
+
+    <blockquote class="blockquote-alert blockquote-alert-{{ $alert }}">
+        <p class="blockquote-alert-heading">
+            {{ with $icon }} 
+                {{ partial "assets/icon.html" (dict "icon" (printf "%s fa-fw" .)) }}
+                {{ or (i18n $alert) (title $alert) }}
+            {{ else }}
+                {{ title $alert }}
+                {{ warnf "Unsupported alert type: '%s'. See %s" $alert $.Position }}
+            {{ end }}
+        </p>
+    {{ trim .Text "\n\r" | safeHTML }}
+    </blockquote>
+{{ else }}
+    <blockquote class="blockquote">
+        {{ trim .Text "\n\r" | safeHTML }}
+    </blockquote>
+{{ end }}

layouts/_default/_markup/render-codeblock-math.html

@@ -0,0 +1,11 @@
+{{ with transform.ToMath .Inner (dict "displayMode" true) }}
+    {{ with .Err }}
+        {{ errorf "Failed to render KaTeX: %q. See %s" . $.Position }}
+    {{ else }}
+        {{ if $.Attributes.class }}
+            <div class="{{ $.Attributes.class }}">{{ . }}</div>
+        {{ else }}
+            {{ . }}
+        {{ end }}
+    {{ end }}
+{{ end }}

layouts/_default/_markup/render-image.html

@@ -0,0 +1,15 @@
+{{ partial "assets/image.html" (dict 
+    "url" .Destination
+    "page" .Page
+    "caption" .Title
+    "title" .Text 
+    "anchor" .Attributes.anchor
+    "class" .Attributes.class
+    "figclass" .Attributes.figclass
+    "loading" .Attributes.loading
+    "mode" .Attributes.mode
+    "plain" .Attributes.plain
+    "portrait" .Attributes.portrait
+    "ratio"  .Attributes.ratio
+    "wrapper" .Attributes.wrapper
+) }}

layouts/_default/_markup/render-link.html

@@ -0,0 +1,15 @@
+{{ if gt (findRE `^HAHAHUGO` .Destination 1) 0 }}
+    {{ errorf "Invalid markdown link destination, use '%s' syntax when using shortcodes as input. See '%s'" 
+        ("{{% %}}" | htmlUnescape)
+        .Page.File.Path
+    }}
+{{ else if not .Destination }}
+    {{ errorf "Missing markdown link destination,  see '%s'" .Page.File.Path }}
+{{ else }}
+    {{ partial "assets/link.html" (dict 
+        "destination" .Destination
+        "page" .Page
+        "text" .Text 
+        "title" .Title
+    ) }}
+{{- end }}

layouts/_default/_markup/render-passthrough.html

@@ -0,0 +1,13 @@
+{{ $opts := dict }}
+
+{{ if eq .Type "block" }}
+    {{ $opts = dict "displayMode" true }}
+{{ end }}
+
+{{ with transform.ToMath .Inner $opts }}
+    {{ with .Err }}
+        {{ errorf "Failed to render KaTeX: %q. See %s" . $.Position }}
+    {{ else }}
+        {{ . }}
+    {{ end }}
+{{ end }}

layouts/_default/_markup/render-table.html

@@ -0,0 +1,40 @@
+{{/* Adapted from https://gohugo.io/render-hooks/tables/ */}}
+
+<!-- Ensure presence of `.table` class attribute to trigger Bootstrap styling -->
+{{ $attr := .Attributes }}
+{{ $class := split $attr.class " " }}
+{{ if not (in $class "table") }}
+    {{ $attr = merge $attr (dict "class" (trim (delimit ($class | append "table") " ") " ")) }}
+{{ end }}
+
+{{ $align := dict "left" "start" "center" "center" "right" "end" }}
+
+<table
+  {{- range $k, $v := $attr }}
+    {{- if $v }}
+      {{- printf " %s=%q" $k $v | safeHTMLAttr }}
+    {{- end }}
+  {{- end }}>
+  <thead>
+    {{- range .THead }}
+      <tr>
+        {{- range . }}
+          <th {{ with .Alignment }}class="text-{{ index $align . }}"{{ end }}>
+            {{- .Text -}}
+          </th>
+        {{- end }}
+      </tr>
+    {{- end }}
+  </thead>
+  <tbody>
+    {{- range .TBody }}
+      <tr>
+        {{- range . }}
+          <td {{ with .Alignment }}class="text-{{ index $align . }}"{{ end }}>
+            {{- .Text -}}
+          </td>
+        {{- end }}
+      </tr>
+    {{- end }}
+  </tbody>
+</table>

layouts/_default/baseof.html

@@ -14,7 +14,7 @@
 {{- end -}}
 
 {{- /* Initialize module configuration */ -}}
-{{- $modules := partial "utilities/InitModules.html" (dict "page" .) -}}
+{{- $modules := partialCached "utilities/InitModules.html" . -}}
 {{- $.Scratch.Set "modules" $modules -}}
 
 {{- $fullCover := or (or (and .IsHome .Site.Params.home.fullCover) .Page.Params.fullCover) .Site.Params.main.footerBelowFold }}
@@ -27,7 +27,7 @@
 {{- $.Scratch.Set "sections" $sections -}}
 
 {{- /* Define main breakpoint */ -}}
-{{- $.Scratch.Set "breakpoint" (partial "utilities/GetBreakpoint.html") }}
+{{- $.Scratch.Set "breakpoint" (partialCached "utilities/GetBreakpoint.html" .) }}
 
 {{- /* Define base URL */ -}}
 {{ $lang := site.LanguageCode | default site.Language.Lang }}
@@ -36,11 +36,11 @@
 <!doctype html>
 <html lang="{{ .Site.Language.Lang }}" class="no-js">
     <head>
+        {{- partial "footer/scripts.html" (dict "filename" "js/critical.bundle.js" "match" "js/critical/**.js" "header" true "page" .) -}}
         {{ block "head" . }}{{ end -}}
     </head>
 
     <body>
-        {{- partial "footer/scripts.html" (dict "filename" "js/critical.bundle.js" "match" "js/critical/**.js" "header" true "page" .) -}}
         <div class="d-flex flex-column min-vh-100">
             <div class="d-flex flex-column {{ if $fullCover }} fullscreen{{ end }}{{ if .IsHome }} {{ .Site.Params.home.style }}{{ end }}">
                 {{- partial "assets/navbar.html" (dict
@@ -73,6 +73,7 @@
         {{ end }}
 
         {{- partial "footer/toast-container.html" . -}}
+        {{- partial "assets/symbols.html" . -}}
         {{- partialCached "footer/scripts.html" (dict "header" false "page" . "core" true) }}
         {{- partial "footer/optional-scripts.html" . -}}
     </body>

layouts/_default/single.html

@@ -1,6 +1,8 @@
 {{ define "main" -}}
     {{- $breakpoint := $.Scratch.Get "breakpoint" -}}
-    {{ $sidebar := .Render "single/sidebar" }}
+    {{- $hasSidebar := .Site.Params.navigation.sidebar | default true -}}
+    {{ $sidebar := "" }}
+    {{ if $hasSidebar }}{{ $sidebar = .Render "single/sidebar" }}{{ end }}
     {{ $toc := .Render "single/panel-toc" }}
 
     {{ with $sidebar }}
@@ -16,7 +18,7 @@
     {{ end }}
 
     <div class="container-xxl flex-fill p-4 px-xxl-0">
-        {{ if $sidebar -}}
+        {{ if $hasSidebar -}}
             <div class="row row-cols-1 row-cols-{{ $breakpoint.current }}-2 row-cols-{{ $breakpoint.next }}-3">
                 <div class="col col-{{ $breakpoint.next }}-2 d-none d-{{ $breakpoint.next }}-block sidebar-overflow sticky-top pt-5">
                     {{ $sidebar | safeHTML }}

layouts/_default/single/header.html

@@ -14,14 +14,16 @@
 
 {{ with .Title }}<p class="display-4 mt-5">{{ . }}</p>{{ end }}
 {{ if ne $metadata "none" }}
-    {{ $lastmodstr := (partial "utilities/date.html" (dict "date" .Lastmod "format" "long")) -}}
-    {{ $datestr := (partial "utilities/date.html" (dict "date" .Date "format" "long")) -}}
     <small class="text-body-secondary text-uppercase">
-        {{ $datestr | i18n "postedOnDate" -}}
-        {{ if eq $metadata "full" }}
-            {{ if ne $datestr $lastmodstr -}}&nbsp;({{ $lastmodstr | i18n "lastModified" }}){{ end }}
+        {{ if .Date }}
+            {{ $lastmodstr := (partial "utilities/date.html" (dict "date" .Lastmod "format" "long")) -}}
+            {{ $datestr := (partial "utilities/date.html" (dict "date" .Date "format" "long")) -}}
+            {{ $datestr | i18n "postedOnDate" -}}
+            {{ if eq $metadata "full" }}
+                {{ if ne $datestr $lastmodstr -}}&nbsp;({{ $lastmodstr | i18n "lastModified" }}){{ end }}
+            {{ end }}
+            &bull;
         {{ end }}
-        &bull;
         {{ .ReadingTime | lang.FormatNumber 0 }}&nbsp;{{ i18n "minutesShort" }} {{ i18n "read" }} &bull;
         {{ .WordCount | lang.FormatNumber 0 }}&nbsp;{{ i18n "words" }}
     </small>

layouts/_default/single/sidebar.html

@@ -1,7 +1,5 @@
 {{- $menu := .Scratch.Get "sidebar" -}}
 {{- $version := .Scratch.Get "version" -}}
-{{ $sidebar := "" }}
-{{- $hasSidebar := .Site.Params.navigation.sidebar | default true -}}
-{{ if and $menu $hasSidebar  }}
+{{ if $menu  }}
     {{ partial "assets/sidebar.html" (dict "page" . "menu" $menu "version" $version) }}
-{{ end }}
+{{ end -}}

layouts/alias.html

@@ -7,6 +7,10 @@
     <meta name="robots" content="noindex">
     <meta charset="utf-8">
     <noscript><meta http-equiv="refresh" content="0; url={{ .Permalink }}"></noscript>
-    <script src='{{ partial "utilities/GetStaticURL" (dict "url" "js/alias.js") }}'></script>
+    {{ if site.Params.main.enableLanguageSelectionStorage }} 
+      {{- partial "footer/scripts.html" (dict "filename" "js/critical.bundle.js" "match" "js/critical/**.js" "header" true "page" page) -}}
+    {{ else }}
+      <script src='{{ partial "utilities/GetStaticURL" (dict "url" "js/alias.js") }}'></script>
+    {{ end }}
   </head>
 </html>

layouts/partials/assets/adapters/cloudinary.html

@@ -6,6 +6,19 @@
 
 {{ $error := false }}
 
+{{ $anchorMap := dict
+    "TopLeft" "north_west"
+    "Top" "north"
+    "TopRight" "north_east"
+    "Left" "west"
+    "Center" "center"
+    "Right" "east"
+    "BottomLeft" "south_west"
+    "Bottom" "south"
+    "BottomRight" "south_east"
+    "Smart" "auto"
+}}
+
 <!-- Validate arguments -->
 {{ if partial "utilities/IsInvalidArgs.html" (dict "structure" "image-adapter" "args" . "group" "partial") }}
     {{ errorf "partial [assets/adapter/cloudinary.html] - Invalid arguments" -}}
@@ -20,24 +33,38 @@
 {{ $transform := .transform }}
 {{ $height := .height }}
 {{ $width := .width }}
+{{ $anchor := "" }}
+{{ with .anchor }}{{ $anchor = index $anchorMap . }}{{ end }}
 {{ if eq $transform "fill" }}{{ $transform = "c_fill" }}{{ else }}{{ $transform = "c_fit" }}{{ end }}
 {{ $element := "" }}
 
 <!-- Split path between upload dir and sub dir -->
-{{ $newdir := urls.JoinPath (index (split $dir "upload") 0) "upload" }}
-{{ $file = urls.JoinPath (index (split $dir "upload") 1) $file }}
-{{ $dir = $newdir }}
+{{ $dir = path.Clean (trim .dir "/") }}
+{{ $api := "image/upload" }}
+
+<!-- Define the account, optional API segment, and directory -->
+{{ $elements := split $dir "/" }}
+{{ $account := index $elements 0 }}
+{{ $operation := "" }}
+{{ if and (in (slice "image" "video") (index $elements 1)) (eq (index $elements 2) "upload") }}
+    {{ $api = delimit (slice | append (index $elements 1) | append (index $elements 2)) "/" }}
+    {{ $dir = delimit (after 3 $elements) "/" }}
+{{ else }}
+    {{ $dir = delimit (after 1 $elements) "/" }}
+{{ end }}
 
 <!-- Generate image URL -->
 {{ if not $error }}
-    {{ $operation := "" }}
     {{ if $format }}
         {{ $operation = printf "%s,h_%d,w_%d" $transform $height $width }}
         {{ $file = printf "%s.%s" (strings.TrimSuffix (path.Ext $file) $file) $format }}
     {{ else }}
         {{ $operation = printf "f_auto,%s,h_%d,w_%d" $transform $height $width }}
     {{ end }}
-    {{- $element = urls.JoinPath (slice "https://" $host $dir $operation $file) -}}
+    {{ with $anchor }}
+        {{ $operation = printf "%s,g_%s" $operation . }}
+    {{ end }}
+    {{- $element = partial "utilities/URLJoin.html" (dict "elements" (slice "https://" $host $account $api $operation $dir $file)) -}}
 {{ end }}
 
 {{ return $element }}

layouts/partials/assets/adapters/hugo.html

@@ -20,11 +20,12 @@
 {{ $transform := .transform }}
 {{ $height := .height }}
 {{ $width := .width }}
+{{ $anchor := .anchor | default "" }}
 {{ $element := "" }}
 {{ $absoluteURL := .absoluteURL }}
-{{ $url := urls.JoinPath $dir $file }}
+{{ $url := partial "utilities/URLJoin.html" (dict "elements" (slice $dir $file)) }}
 {{ if $host }}
-    {{ $url = urls.JoinPath "https://" $host $url }}
+    {{ $url = partial "utilities/URLJoin.html" (dict "elements" (slice "https://" $host $url)) }}
 {{ end }}
 
 <!-- Initialize image if needed, do not raise additional warnings -->
@@ -46,13 +47,20 @@
 {{ if not $error }}
     {{ $scaled := "" }}
     {{ if eq $transform "fill" }}
-        {{- $scaled = $img.Fill (printf "%dx%d %s" $width $height $format) -}}
+        {{- $scaled = $img.Fill (printf "%dx%d %s %s" $width $height $anchor $format) -}}
     {{ else }}
         {{- $scaled = $img.Fit (printf "%dx%d %s" $width $height $format) -}}
     {{ end }}
 
     {{- $clean := path.Ext $img.RelPermalink -}}
-    {{- $scaled = $scaled | resources.Copy (replace $img.RelPermalink $clean (printf "-%dx%d.%s" $width $height $format)) -}}
+    {{ $destination := "" }}
+    {{ if $anchor }}
+        {{ $destination = printf "-%dx%d-%s.%s" $width $height (lower $anchor) $format }}
+    {{ else }}
+        {{ $destination = printf "-%dx%d.%s" $width $height $format }}
+    {{ end }}
+
+    {{- $scaled = $scaled | resources.Copy (replace $img.RelPermalink $clean $destination) -}}
     {{- if $absoluteURL -}}
         {{- $element = $scaled.Permalink -}}
     {{- else -}}

layouts/partials/assets/adapters/imagekit-rewrite.html

@@ -22,9 +22,9 @@
 {{ with $container }}{{ $dir = strings.TrimPrefix (printf "/%s" .) $dir }}{{ end }}
 
 {{ if ne $host "ik.imagekit.io" }}
-    {{ $element = urls.JoinPath (slice "https://ik.imagekit.io" $account $dir $file) }}
+    {{ $element = partial "utilities/URLJoin.html" (dict "elements" (slice "https://ik.imagekit.io" $account $dir $file)) }}
 {{ else }}
-    {{ $element = urls.JoinPath (slice "https://" $host $dir $file) }}
+    {{ $element = partial "utilities/URLJoin.html" (dict "elements" (slice "https://" $host $dir $file)) }}
 {{ end }}
 
 {{ return $element }}

layouts/partials/assets/adapters/imagekit.html

@@ -6,6 +6,19 @@
 
 {{ $error := false }}
 
+{{ $anchorMap := dict
+    "TopLeft" "top_left"
+    "Top" "top"
+    "TopRight" "top_right"
+    "Left" "left"
+    "Center" "center"
+    "Right" "right"
+    "BottomLeft" "bottom_left"
+    "Bottom" "bottom"
+    "BottomRight" "bottom_right"
+    "Smart" "auto"
+}}
+
 <!-- Validate arguments -->
 {{ if partial "utilities/IsInvalidArgs.html" (dict "structure" "image-adapter" "args" . "group" "partial") }}
     {{ errorf "partial [assets/adapter/imagekit.html] - Invalid arguments" -}}
@@ -20,6 +33,8 @@
 {{ $transform := .transform }}
 {{ $height := .height }}
 {{ $width := .width }}
+{{ $anchor := "" }}
+{{ with .anchor }}{{ $anchor = index $anchorMap . }}{{ end }}
 {{ if eq $transform "fill" }}{{ $transform = "c-maintain_ratio" }}{{ else }}{{ $transform = "c-at_max" }}{{ end }}
 {{ $element := "" }}
 
@@ -31,7 +46,7 @@
 
 <!-- Split path between end point and image path -->
 {{ $newdir := printf "/%s" (index (split $dir "/") 1) }}
-{{ $file = urls.JoinPath (strings.TrimPrefix $newdir $dir) $file }}
+{{ $file = partial "utilities/URLJoin.html" (dict "elements" (slice (strings.TrimPrefix $newdir $dir) $file)) }}
 {{ $dir = $newdir }}
 
 <!-- Generate image URL -->
@@ -42,7 +57,10 @@
     {{ else }}
         {{ $operation = printf "tr:f-auto,%s,h-%d,w-%d" $transform $height $width }}
     {{ end }}
-    {{- $element = urls.JoinPath (slice "https://" $host $dir $operation $file) -}}
+    {{ with $anchor }}
+        {{ $operation = printf "%s,fo-%s" $operation . }}
+    {{ end }}
+    {{- $element = partial "utilities/URLJoin.html" (dict "elements" (slice "https://" $host $dir $operation $file)) -}}
 {{ end }}
 
 {{ return $element }}

layouts/partials/assets/adapters/imgix.html

@@ -6,6 +6,19 @@
 
 {{ $error := false }}
 
+{{ $anchorMap := dict
+    "TopLeft" "top,left"
+    "Top" "top"
+    "TopRight" "top,right"
+    "Left" "left"
+    "Center" "center"
+    "Right" "right"
+    "BottomLeft" "bottom,left"
+    "Bottom" "bottom"
+    "BottomRight" "bottom,right"
+    "Smart" "faces,edges,center"
+}}
+
 <!-- Validate arguments -->
 {{ if partial "utilities/IsInvalidArgs.html" (dict "structure" "image-adapter" "args" . "group" "partial") }}
     {{ errorf "partial [assets/adapter/imgix.html] - Invalid arguments" -}}
@@ -20,6 +33,8 @@
 {{ $transform := .transform }}
 {{ $height := .height }}
 {{ $width := .width }}
+{{ $anchor := "" }}
+{{ with .anchor }}{{ $anchor = index $anchorMap . }}{{ end }}
 {{ if eq $transform "fill" }}{{ $transform = "crop" }}{{ else }}{{ $transform = "max" }}{{ end }}
 {{ $element := "" }}
 
@@ -37,7 +52,10 @@
     {{ else }}
         {{ $operation = printf "f_auto&fit=%s&h=%d&w=%d" $transform $height $width }}
     {{ end }}
-    {{- $element = printf "%s?%s" (urls.JoinPath (slice "https://" $host $dir $file)) $operation -}}
+    {{ with $anchor }}
+        {{ $operation = printf "%s&crop=%s" $operation . }}
+    {{ end }}
+    {{- $element = printf "%s?%s" (partial "utilities/URLJoin.html" (dict "elements" (slice "https://" $host $dir $file))) $operation -}}
 {{ end }}
 
 {{ return $element }}

layouts/partials/assets/button.html

@@ -95,10 +95,10 @@
         {{- end -}}
         role="button"
         >
-        <div class="d-flex justify-content-{{ $justify }}">
-            <div class="my-auto">{{ $title | safeHTML }}</div>
-            {{- with $icon }}<div class="align-self-center{{ if $title }}{{ if eq $order "first" }} order-first pe-1{{ else }} ps-1{{ end }}{{ end }}">{{ partial "assets/icon.html" (dict "icon" $icon "spacing" false) }}</div>{{ end }}
-        </div>
+        <span class="d-flex justify-content-{{ $justify }}">
+            <span class="my-auto">{{ $title | safeHTML }}</span>
+            {{- with $icon }}<span class="align-self-center{{ if $title }}{{ if eq $order "first" }} order-first pe-1{{ else }} ps-1{{ end }}{{ end }}">{{ partial "assets/icon.html" (dict "icon" $icon "spacing" false) }}</span>{{ end }}
+        </span>
 
         {{- with $badge }}
             <span class="position-absolute top-0 start-100 translate-middle badge rounded-pill bg-danger">

layouts/partials/assets/card-group.html

@@ -4,163 +4,175 @@
     Visit gethinode.com/license for more details.
 -->
 
-<!-- Validate arguments -->
-{{ if partial "utilities/IsInvalidArgs.html" (dict "structure" "card-group" "child" "card" "args" .) }}
-    {{- errorf "partial [assets/card-group.html] - Invalid arguments" -}}
-{{ end }}
-
-<!-- Initialize arguments and default values -->
-{{- $page := .page -}}
-{{- $breakpoint := partial "utilities/GetBreakpoint.html" -}}
-{{ $pages := .list }}
-{{ $cards := .cards }}
-{{- $paginate := .paginate | default false -}}
-{{- $moreURL := .href -}}
-{{- $moreTitle := .hrefTitle -}}
-{{- $gutter := .gutter | default 4 -}}
-{{- $separator := .separator | default false -}}
-{{- $class := .class -}}
-{{- $color := .color -}}
-{{- $padding := .padding -}}
-{{- $header := .header -}}
-{{- $footer := .footer -}}
-{{- $orientation := .orientation -}}
-{{- $ratio := .ratio -}}
-{{- $wrapper := .wrapper | default "p-0" -}}
-{{- $style := .style -}}
-{{- $align := .align -}}
-{{- $subtle := .subtle }}
-{{- $loading := .loading -}}
-{{- $button := .button -}}
-{{- $buttonLabel := .buttonLabel -}}
-{{- $buttonType := .buttonType -}}
-{{- $hook := .hook | default "assets/card.html" }}
-
-<!-- Override arguments -->
-{{ $isPages := in (slice "page.Pages" "resource.Resources") (printf "%T" $pages) }}
-{{ $paginator := "" }}
-{{ if and $isPages $paginate }}
-    {{ with .pagination }}
-        {{ $paginator = $page.Paginate $pages . }}
-    {{ else }}
-        {{ $paginator = $page.Paginate $pages }}
+<!-- Define inline partials -->
+{{ define "partials/assets/style.html" }}
+	{{ $style := "" }}
+    {{ if gt (len .styles) 0 }}
+        {{ $def := index .styles (mod .index (len .styles)) }}
+        {{ $style = index $def .key }}
     {{ end }}
-    {{ $pages = first $paginator.PageSize (after (mul (sub $paginator.PageNumber 1) $paginator.PageSize) $pages) }}
+    {{ return ($style | default .default ) }}
 {{ end }}
 
-{{ $list := slice }}
+<!-- Initialize arguments -->
+{{ $args := partial "utilities/InitArgs.html" (dict "structure" "card-group" "child" "card" "args" .) }}
+{{ if $args.err }}
+    {{ partial "utilities/LogErr.html" (dict 
+        "partial" "assets/card-group.html" 
+        "msg" "Invalid arguments"
+        "details" $args.errmsg
+        "file" page.File
+    )}}
+{{ end }}
+
+<!-- Initialize local variables -->
+{{ $list := $args.list }}
+{{- $class := $args.class -}}
+{{- $orientation := $args.orientation -}}
+{{ $cardWrapper := "" }}
+
+{{- $breakpoint := partial "utilities/GetBreakpoint.html" -}}
+{{ $colsMap := dict
+    "auto" ""
+    "1" "row-cols-1"
+    "2" (printf "row-cols-1 row-cols-%s-1 row-cols-%s-2" $breakpoint.prev $breakpoint.current)
+    "3" (printf "row-cols-1 row-cols-%s-2 row-cols-%s-3" $breakpoint.prev $breakpoint.current)
+    "4" (printf "row-cols-1 row-cols-%s-2 row-cols-%s-4" $breakpoint.prev $breakpoint.current)
+    "5" (printf "row-cols-1 row-cols-%s-3 row-cols-%s-5" $breakpoint.prev $breakpoint.current)
+}}
+{{ $sizesMap := dict
+    "auto" "100vw"
+    "1" "100vw"
+    "2" (printf "(min-width: %s) 50vw, 100vw" $breakpoint.currentSize)
+    "3" (printf "(min-width: %s) 33.3vw, (min-width: %s) 50vw, 100vw" $breakpoint.currentSize $breakpoint.prevSize)
+    "4" (printf "(min-width: %s) 25vw, (min-width: %s) 50vw, 100vw" $breakpoint.currentSize $breakpoint.prevSize)
+    "5" (printf "(min-width: %s) 20vw, (min-width: %s) 33.3vw, 100vw" $breakpoint.currentSize $breakpoint.prevSize)
+}}
+
+<!-- Apply optional pagination -->
+{{ $isPages := in (slice "page.Pages" "resource.Resources") (printf "%T" $list) }}
+{{ $paginator := "" }}
+{{ if and $isPages $args.paginate }}
+    {{ with $args.pagination }}
+        {{ $paginator = $args.page.Paginate $list . }}
+    {{ else }}
+        {{ $paginator = $args.page.Paginate $list }}
+    {{ end }}
+    {{ $list = first $paginator.PagerSize (after (mul (sub $paginator.PageNumber 1) $paginator.PagerSize) $list) }}
+{{ end }}
+
+<!-- Initialize list elements -->
+{{ $elements := slice }}
 {{ if $isPages }}
-    {{ range $index, $element := $pages }}
+    {{ range $index, $element := $list }}
         {{ $params := dict }}
         <!-- regular page -->
         {{- if and $element.RelPermalink $element.File -}}
             {{- $params = merge $params (dict "path" $element.File.Path) -}}
         <!-- headless page -->
         {{- else -}}
-            {{- $thumbnail := (or (and (reflect.IsMap $element.Params.Thumbnail) $element.Params.Thumbnail.url) $element.Params.Thumbnail) -}}
+            {{- $thumbnail := "" -}}
+            {{ if reflect.IsMap $element.Params.Thumbnail }}{{ $thumbnail = $element.Params.Thumbnail.url }}{{ else }}{{ $thumbnail = $element.Params.Thumbnail }}{{ end }}
+            {{- $anchor := (or (and (reflect.IsMap $element.Params.Thumbnail) $element.Params.Thumbnail.anchor) "") -}}
             {{- $params = merge $params (dict
                 "title" $element.Title
                 "href" $element.RelPermalink
                 "description" (partial "utilities/GetDescription.html" (dict "page" $element "raw" true))
                 "thumbnail" $thumbnail
+                "anchor" $anchor
                 "icon" $element.Params.icon
             ) -}}
         {{- end -}}
 
-        {{- $list = $list | append $params }}
+        {{- $elements = $elements | append $params }}
     {{ end }}
-{{ else if $pages }}
-    {{ $list = $list | append $pages }}
+{{ else if $list }}
+    {{ $elements = $elements | append $list }}
 {{ end }}
 
-{{- $count := len $list -}}
+<!-- Limit list to max elements -->
+{{- $count := len $elements -}}
 {{- $max := $count -}}
-{{- $max = math.Min (.max | default $count) $count -}}
-{{- $responsive := .responsive | default true -}}
-{{- $cols := string .cols | default "3" -}}
-
-{{- $sizes := "100vw" }}
-{{- $colGrid := "" -}}
-{{- if eq $cols "1" }}
-    {{ $colGrid = "row-cols-1" -}}
-{{- 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 -}}
-    {{ $sizes = printf "(min-width: %s) 50vw, 100vw" $breakpoint.currentSize }}
-{{- 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 -}}
-    {{ $sizes = printf "(min-width: %s) 33.3vw, (min-width: %s) 50vw, 100vw" $breakpoint.currentSize $breakpoint.prevSize }}
-{{- 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 -}}
-    {{ $sizes = printf "(min-width: %s) 25vw, (min-width: %s) 50vw, 100vw" $breakpoint.currentSize $breakpoint.prevSize }}
-{{- 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 -}}
-    {{ $sizes = printf "(min-width: %s) 20vw, (min-width: %s) 33.3vw, 100vw" $breakpoint.currentSize $breakpoint.prevSize }}
-{{ end -}}
-
-{{- if not $paginate -}}
-    {{- $list = first $max $list -}}
+{{- $max = math.Min ($args.max | default $count) $count -}}
+{{- if not $args.paginate -}}
+    {{- $elements = first $max $elements -}}
 {{- end -}}
 
-{{- if and (eq $cols "1") (eq $orientation "horizontal") }}{{ $orientation = "horizontal-sm" }}{{ end -}}
+{{/* Initialize grid and layout */}}
+{{- $sizes := "100vw" }}
+{{- $colGrid := "" -}}
+{{ if not $args.scroll }}
+    {{ $colGrid = index $colsMap $args.cols }}
+    {{ if $args.responsive }}{{ $sizes = index $sizesMap $args.cols }}{{ end }}
+{{ else }}
+    {{ if in (slice "2" "3" "4" "5") $args.cols }}
+        {{ $sizes = replace (printf "%.1fvw" (div 100.0 (int $args.cols))) ".0" "" }}
+    {{ end }}
+{{ end }}
+
+{{- if and (eq $args.cols "1") (eq $orientation "horizontal") }}{{ $orientation = "horizontal-sm" }}{{ end -}}
+
+{{ if not $args.spacer }}
+    {{ $class = printf "%s h-100" $class }}
+{{ end }}
 
 <!-- Main code -->
-<div class="container-fluid {{ $wrapper }}">
-    <div class="row {{ $colGrid }} g-{{ $gutter }}">
-        {{ range $index, $element := $list }}
-            {{- $params := (dict
-                "class" (printf "h-100 %s" $class)
-                "color" $color
-                "footer" $footer
-                "header" $header
-                "loading" $loading
-                "sizes" $sizes
-                "orientation" $orientation
-                "padding" $padding
-                "ratio" $ratio
-                "subtle" $subtle
-                "style" $style
-                "align" $align
-                "button" $button
-                "buttonLabel" $buttonLabel
-                "buttonType" $buttonType
-            ) -}}
-            {{- $params = merge $params $element }}
+<div class="{{ $args.wrapper }}">
+    <div class="container-fluid {{ if $args.scroll }}card-container-wrapper{{ end }} p-0">
+        <div class="row g-{{ $args.gutter }} {{ if $args.scroll }}d-flex flex-row flex-nowrap card-container scrollbar-horizontal pb-4 w-100 {{ end }}
+        {{ if $args.bento }}{{ with $args.valign }}align-items-{{ . }}{{ end }}{{ else }}{{ $colGrid }}{{ end }}">
+            {{ range $index, $element := $elements }}
+                {{- $params := (dict
+                    "class" (printf " %s" $class)
+                    "color" $args.color
+                    "footer" $args.footer
+                    "body" $args.body
+                    "header" $args.header
+                    "loading" $args.loading
+                    "sizes" $sizes
+                    "orientation" (partial "assets/style.html" (dict "styles" $args.styles "index" $index "key" "orientation" "default" $orientation))
+                    "padding" $args.padding
+                    "ratio" (partial "assets/style.html" (dict "styles" $args.styles "index" $index "key" "ratio" "default" $args.ratio))
+                    "portrait" (partial "assets/style.html" (dict "styles" $args.styles "index" $index "key" "portrait" "default" $args.portrait))
+                    "subtle" $args.subtle
+                    "style" $args.style
+                    "align" $args.align
+                    "button" $args.button
+                    "buttonLabel" $args.buttonLabel
+                    "buttonType" $args.buttonType
+                    "iconRounded" $args.iconRounded
+                ) -}}
+                {{- $params = merge $element $params }}
 
-            <div class="col">
-                {{- partial $hook $params -}}
-            </div>
-            {{- if and (lt $index (sub $max 1)) $separator -}}
-                <div class="col d-block d-sm-none">
-                    <hr>
+                {{ if $args.scroll }}
+                    {{ $width := (partial "assets/style.html" (dict "styles" $args.styles "index" $index "key" "width" "default" "3")) }}
+                    {{ $size := $args.cols }}
+                    {{ if and (gt $args.cols 1) (eq $width "6") }}{{ $size = sub (int $args.cols) 1 }}{{ end }}
+                    {{ $cardWrapper = printf "card-block card-block-%d" (int $size) }}
+                {{ end }}
+
+                <!--add col-$width -->
+                <div class="{{ with $cardWrapper }}{{ . }}{{ else }}col{{ end }}">
+                    {{ if $args.spacer }}<div class="spacer"></div>{{ end }}
+                    {{- partial $args.hook $params -}}
                 </div>
+                {{- if and (lt $index (sub $max 1)) $args.separator -}}
+                    <div class="col d-block d-sm-none">
+                        <hr>
+                    </div>
+                {{- end -}}
             {{- end -}}
-        {{- end -}}
-        {{if $cards }}{{- print $cards | safeHTML }}{{ end }}
+            {{ if $args.cards }}{{- print $args.cards | safeHTML }}{{ end }}
+        </div>
     </div>
 
     {{ if $paginator }}
         {{- if gt $paginator.TotalPages 1 -}}
-            <div class="pt-3">{{ partial "assets/pagination.html" (dict "page" $page "format" "terse") }}</div>
+            <div class="pt-3">{{ partial "assets/pagination.html" (dict "page" $args.page "format" "terse") }}</div>
         {{- end -}} 
     {{ else }}
-        {{ if and (gt $count $max) $moreTitle }}
-            <a class="btn btn-outline-primary mt-4" href="{{ $moreURL| safeURL }}" role="button">{{ $moreTitle }}</a>
+        {{ if and (gt $count $max) $args.hrefTitle }}
+            <a class="btn btn-outline-primary mt-4" href="{{ $args.href| safeURL }}" role="button">{{ $args.hrefTitle }}</a>
         {{ end }}
     {{ end }}
 </div>

layouts/partials/assets/card.html

@@ -11,15 +11,18 @@
 
 <!-- Initialize arguments and default values -->
 {{- $alt := .alt -}}
+{{- $wrapper := .wrapper -}}
 {{- $class := .class -}}
 {{- $color := .color -}}
 {{- $description := .description -}}
+{{- $body := .body | default "full" -}}
 {{- $footer := .footer | default "none" -}}
 {{- $gutter := .gutter | default "0" -}}
 {{- $header := .header | default "full" -}}
 {{- $href := .href -}}
 {{- $icon := .icon -}}
 {{- $iconStyle := "" -}}
+{{- $iconRounded := .iconRounded | default false -}}
 {{- $align := .align | default "start" -}}
 {{- $style := .style | default "" -}}
 {{- $sizes := .sizes | default "100vw" -}}
@@ -27,7 +30,9 @@
 {{- $orientation := .orientation | default "stacked" -}}
 {{- $padding := (string .padding) | default "auto" -}}
 {{- $ratio := .ratio -}}
+{{- $portrait := .portrait | default false -}}
 {{- $thumbnail := .thumbnail -}}
+{{- $anchor := .anchor | default "" -}}
 {{- $title := .title -}}
 {{- $subtle := .subtle -}}
 {{- $button := .button -}}
@@ -46,17 +51,27 @@
 <!-- Override arguments -->
 {{- $page := "" }}
 {{- if .path }}
-    {{- $page = site.GetPage .path }}
+    {{ $page = partial "utilities/GetPage.html" (dict "url" .path "page" page) }}
     {{- if not $page }}
-        {{- errorf "partial [assets/card.html] - Cannot find page: %s" .path -}}
+        {{ if page.File }}
+            {{- errorf "partial [assets/card.html] - Cannot find target page '%s', see '%s'" .path page.File.Path -}}
+        {{ else }}
+            {{- errorf "partial [assets/card.html] - Cannot find target page '%s'" .path -}}
+        {{ end }}
     {{- end }}
 {{- end }}
 {{- with $page -}}
     {{- if not $title }}{{ $title = .Title }}{{ end -}}
     {{- if not $href }}{{ $href = .RelPermalink  }}{{ end -}}
     {{- if not $description }}{{ $description = partial "utilities/GetDescription.html" (dict "page" .) }}{{ end -}}
-    {{- if not $thumbnail }}{{ $thumbnail = (or (and (reflect.IsMap .Params.Thumbnail) .Params.Thumbnail.url) .Params.Thumbnail) }}{{ end -}}
+    {{- if and (not $thumbnail) (not $icon) }}
+        {{ if reflect.IsMap .Params.Thumbnail }}{{ $thumbnail = .Params.Thumbnail.url }}{{ else }}{{ $thumbnail = .Params.Thumbnail }}{{ end }}
+    {{ end -}}
+    {{ if not $ratio }}
+        {{- if and (reflect.IsMap .Params.Thumbnail) .Params.Thumbnail.ratio }}{{ $ratio = .Params.Thumbnail.ratio }}{{ end -}}
+    {{ end }}
     {{- if not $icon }}{{ $icon = .Params.icon }}{{ end -}}
+    {{- if not $anchor }}{{ $anchor = (or (and (reflect.IsMap .Params.Thumbnail) .Params.Thumbnail.anchor) "") }}{{ end -}}
 {{- end -}}
 
 {{ if (hasPrefix $orientation "horizontal") }}
@@ -67,6 +82,8 @@
 {{ end }}
 
 {{- if eq $orientation "none" }}{{ $thumbnail = "" }}{{ $icon = "" }}{{ end -}}
+{{- if eq $body "title" }}{{ $description = "" }}{{ end -}}
+{{- if eq $body "none" }}{{ $title = "" }}{{ $description = "" }}{{ end -}}
 
 <!-- Inline partial to render the card's body -->
 {{- define "partials/card-body.html" -}}
@@ -78,7 +95,7 @@
     
     {{- if $href -}}
         <a href="{{ $href }}" class="{{ if $color }}link-bg-{{ $color }}{{ else }}card-body-link{{ end }} stretched-link">
-                <p class="card-title fs-5 fw-bold">{{ $title }}</p>
+                <p class="card-title fs-lg-5 fs-6 fw-bold">{{ $title }}</p>
             {{ with $description }}
                 <div class="card-text {{ if $color }}link-bg-{{ $color }}{{ else }}card-body-link{{ end }}">
                 {{ . | safeHTML }}
@@ -87,7 +104,7 @@
         </a>
     {{- else -}}
         <div>
-            {{ with $title }}<p class="card-title fs-5 fw-bold">{{ . }}</p>{{ end -}}
+            {{ with $title }}<p class="card-title fs-lg-5 fs-6 fw-bold">{{ . }}</p>{{ end -}}
             {{ with $description }}<div class="card-text">{{ . | safeHTML }}</div>{{ end -}}
         </div>
     {{- end -}}
@@ -106,7 +123,7 @@
 
     <p class="card-text"><small class="{{ if $color }}text-bg-{{ $color }}{{ else }}text-body-secondary{{ end }} text-uppercase">
         {{- if in (slice "full" "publication") $keywords -}}
-            {{- partial "utilities/date.html" (dict "date" $page.Date "format" "long") -}}&nbsp;&bull;
+            {{ with $page.Date }}{{ partial "utilities/date.html" (dict "date" . "format" "long") }}&nbsp;&bull;{{ end -}}
             {{ $page.ReadingTime | lang.FormatNumber 0 }} {{ i18n "minutesShort" }} {{ i18n "read" -}}
         {{- end -}}
 
@@ -125,29 +142,62 @@
 {{- end -}}
 
 <!-- Main code -->
-{{ if ne $gutter "0" }}<div class="g-{{ $gutter }}">{{ end }}
+{{ if or (ne $gutter "0") ($wrapper) }}<div class="g-{{ $gutter }} {{ $wrapper }}">{{ end }}
+
+{{ $stack := "fa-2x" }}
 
 {{- if hasPrefix $orientation "horizontal" -}}
+    {{ $col1 := "" }}
+    {{ $col2 := "" }}
+
+    {{ if $thumbnail }}
+        {{ if eq $orientation "horizontal-sm" }}
+            {{ $stack = "fa-1x" }}
+            {{ $col1 = "col-4 col-md-2" }}
+            {{ $col2 = "col-8 col-md-10" }}
+        {{ else }}
+            {{ $col1 = "col-4" }}
+            {{ $col2 = "col-8" }}
+        {{ end }}
+    {{ else if $icon }}
+        {{ if eq $orientation "horizontal-sm" }}
+            {{ $stack = "fa-1x" }}
+            {{ $col1 = "col-2 col-sm-3 col-md-4 col-xl-2" }}
+            {{ $col2 = "col-10 col-sm-9 col-md-8 col-xl-10" }}
+        {{ else }}
+            {{ $col1 = "col-4" }}
+            {{ $col2 = "col-8" }}
+        {{ end }}
+
+    {{ end }}
+
     <!-- Render horizontal card -->
     <div class="card {{ $colorStyle }} {{ $class }}">
-        <div class="row g-0 row-cols-1 h-100{{ if $button }} pb-5{{ end }}">
-            <div class="{{ if eq $orientation "horizontal-sm" }}col-4 col-md-2{{ else }}col-4{{ end }}">
-                {{- if $thumbnail -}}
-                    {{- partial $hook (dict "url" $thumbnail "ratio" (or $ratio "1x1") "sizes" $sizes "wrapper" "h-100 card-img-wrap" "class" "rounded-start card-img-h100 card-img-bg" "title" $title "loading" $loading) -}}
-                {{- else if $icon -}}
-                    <div class="card-icon p-{{ $padding }} h-100 fa-wrapper d-flex align-items-{{ $align}} justify-content-center {{ $iconStyle }}">
-                        {{- partial "assets/icon.html" (dict "icon" (printf "%s %s" $icon $style)) -}}
+        <div class="row g-0 row-cols-2 h-100{{ if $button }} pb-5{{ end }}">
+            {{- if $thumbnail -}}
+                <div class="{{ $col1 }}">
+                    {{- partial $hook (dict "url" $thumbnail "ratio" (or $ratio "1x1") "portrait" $portrait "sizes" $sizes "anchor" $anchor "wrapper" "h-100 card-img-wrap" "class" "rounded-start card-img-h100 card-img-bg" "title" $title "loading" $loading) -}}
+                </div>
+            {{- else if $icon -}}
+                <div class="{{ $col1 }} p-{{ $padding }}">
+                    <div class="card-icon {{ if $iconRounded }}fa-stack {{ $stack }} mx-auto{{ else }}fa-wrapper h-100 {{ end }} d-flex align-items-{{ $align}} justify-content-center {{ $iconStyle }}">
+                        {{ if $iconRounded }}
+                            {{- partial "assets/icon.html" (dict "icon" "fas circle fa-stack-2x") -}}
+                            {{- partial "assets/icon.html" (dict "icon" (printf "%s fa-stack-1x fa-inverse" $icon)) -}}
+                        {{ else }}
+                            {{- partial "assets/icon.html" (dict "icon" (printf "%s %s" $icon $style)) -}}
+                        {{ end }}
                     </div>
-                {{- end -}}
-            </div>
-            <div class="{{ if eq $orientation "horizontal-sm" }}col-8 col-md-10{{ else }}col-8{{ end }}">
+                </div>
+            {{- end -}}
+            <div class="{{ $col2 }}">
                 <div class="card-body d-flex p-{{ $padding }} flex-column h-100 flex-fill">
                     {{ if $page }}<div>{{ partial "card-caption.html" (dict "page" $page "keywords" $header "color" $color) }}</div>{{ end }}
                     <div class="flex-fill">
                         {{- partial "card-body.html" (dict "title" $title "href" $href "color" $color "description" $description "button" $button) -}}
                     </div>
                     {{ if $page }}<div>{{ partial "card-caption.html" (dict "page" $page "keywords" $footer "color" $color) }}</div>{{ end }}
-                    {{ if $button }}
+                    {{ if and $href $button }}
                         {{ $label := (or $buttonLabel $title) | default (T "readMore") }}
                         {{ $buttonClass := "card-button mb-n4" }}
                         {{ if eq $buttonType "link" }}{{ $buttonClass = "card-button card-button-link mb-n4" }}{{ end }}
@@ -169,15 +219,22 @@
     </div>
 {{- else -}}
     <!-- Render stacked / default card -->
+    {{ $overlay := eq $orientation "overlay" }}
     <div class="card {{ $colorStyle }} {{ $class }} text-{{ $align }}">
         {{- if $thumbnail -}}
-            {{- partial $hook (dict "url" $thumbnail "ratio" (or $ratio "16x9") "sizes" $sizes "wrapper" "card-img-wrap" "class" "card-img-top card-img-bg" "title" (or $alt $title) "loading" $loading) -}}
+            {{- partial $hook (dict "url" $thumbnail "ratio" (or $ratio "16x9") "portrait" $portrait "anchor" $anchor "sizes" $sizes "wrapper" "card-img-wrap" "class" "card-img-top card-img-bg" "title" (or $alt $title) "loading" $loading) -}}
         {{- else if $icon -}}
-            <div class="card-icon p-{{ $padding }} {{ $iconStyle }} text-{{ $align }}">
-                {{- partial "assets/icon.html" (dict "icon" (printf "%s %s" $icon $style)) -}}
+            <div class="card-icon p-{{ $padding }} {{ $iconStyle }} text-{{ $align }} {{ if $iconRounded }}fa-stack {{ $stack }}{{ end }} w-100">
+                {{ if $iconRounded }}
+                    {{- partial "assets/icon.html" (dict "icon" (printf "fas circle fa-stack-2x %s")) -}}
+                    {{- partial "assets/icon.html" (dict "icon" (printf "%s fa-stack-1x fa-inverse" $icon)) -}}
+                {{ else }}
+                    {{- partial "assets/icon.html" (dict "icon" (printf "%s %s" $icon $style)) -}}
+                {{ end }}
             </div>
         {{- end -}}
-        <div class="card-body d-flex flex-column p-{{ $padding }}">
+        <div class="card-body d-flex flex-column p-{{ $padding }} {{ if $overlay }}card-img-overlay card-overlay-gradient p-4{{ end }}" {{ if $overlay }}data-bs-theme="dark"{{ end }}>
+            {{ if $overlay }}<div class="flex-grow-1"></div>{{ end }}
             {{ if $page }}{{- partial "card-caption.html" (dict "page" $page "keywords" $header "color" $color) -}}{{ end }}
             {{- partial "card-body.html" (dict "title" $title "href" $href "color" $color "description" $description) -}}
             {{ if $page }}{{- partial "card-caption.html" (dict "page" $page "keywords" $footer "color" $color) -}}{{ end }}
@@ -204,4 +261,4 @@
     </div>
 {{- end -}}
 
-{{ if ne $gutter "0" }}</div>{{ end }}
+{{ if or (ne $gutter "0") ($wrapper) }}</div>{{ end }}

layouts/partials/assets/helpers/image-definition.html

@@ -15,15 +15,16 @@
 {{- $mode := .mode -}}
 {{- $modes := .modes -}}
 {{- $plain := .plain | default false }}
+{{- $anchor := .anchor }}
 
 <!-- Split url into base and anchor when applicable (only relevant for vector images) -->
-{{- $anchor := "" -}}
+{{- $fileAnchor := "" -}}
 {{- $segments := split $url "#" -}}
 {{- if gt (len $segments) 2 -}}
     {{- errorf "Invalid path or url: %q" $url -}}
 {{- else if eq (len $segments) 2 }}
     {{- $url = index $segments 0 -}}
-    {{- $anchor = index $segments 1 -}}
+    {{- $fileAnchor = index $segments 1 -}}
 {{- end -}}
 
 <!-- Obtain fallback URL and imageset definition -->
@@ -31,13 +32,16 @@
     "page" $page
     "url" .url
     "ratio" $ratio
+    "portrait" $portrait
     "plain" $plain 
     "imageset" true
+    "anchor" $anchor
 ) }}
 {{ $fallbackURL := index $target "target" }}
 {{ $imgset := index $target "set" }}
 {{ $height := index $target "height" }}
 {{ $width := index $target "width" }}
+{{ $data := index $target "data" }}
 
 <!-- Add color modes -->
 {{- range $none := $modes -}}
@@ -49,24 +53,33 @@
 <!-- Generate image definition -->
 {{- if $caption -}}
     <figure {{ with $wrapper }}class="{{ . }}"{{ end }}>
+{{ else }}
+    {{ with $wrapper }}<div class="{{ . }}">{{ end }}
+{{ end }}
+
+{{ if $data }}
+    {{- if site.Params.debugging.includeSVGOrigin }}
+        {{ printf "<!-- <svg src=\"%s\"> -->" $.url | safeHTML }}
+    {{ end -}}
+    {{- $data = replace $data "<svg" (printf "<svg class=\"%s\"" $class) -}}
+    {{- $data | safeHTML -}}
+{{- else if not $fileAnchor -}}
+    <img class="img-fluid {{ $class }}"
+        src="{{ $fallbackURL }}"
+        {{ if $lazy }}loading="lazy"{{ end }}
+        {{ with $priority }}fetchpriority="{{ . }}"{{ end }}
+        {{ with $imgset -}}srcset="{{ . }}" sizes="{{ $sizes }}"{{- end }}
+        {{ with $height }}height="{{ . }}"{{ end }}
+        {{ with $width }}width="{{ . }}"{{ end }}
+        {{ with (or $title $caption) }}alt="{{ . }}"{{ end }}>
+{{- else }}
+    <svg class="{{ $class }}">
+        <use href="{{ $fallbackURL }}#{{ $fileAnchor }}"></use>
+    </svg>
 {{ end }}
-<div class="{{ if not $caption }}{{ $wrapper }}{{ end }}">        
-    {{- if not $anchor -}}
-        <img class="img-fluid {{ $class }}"
-            src="{{ $fallbackURL }}"
-            {{ if $lazy }}loading="lazy"{{ end }}
-            {{ with $priority }}fetchpriority="{{ . }}"{{ end }}
-            {{ with $imgset -}}srcset="{{ . }}" sizes="{{ $sizes }}"{{- end }}
-            {{ with $height }}height="{{ . }}"{{ end }}
-            {{ with $width }}width="{{ . }}"{{ end }}
-            {{ with (or $title $caption) }}alt="{{ . }}"{{ end }}>
-    {{- else }}
-        <svg class="{{ $class }}">
-            <use href="{{ $fallbackURL }}#{{ $anchor }}"></use>
-        </svg>
-    {{ end }}
-</div>
 {{- if $caption -}}
         <figcaption class="figure-caption{{ with $figclass }} {{ . }}{{ end }}">{{ $caption | safeHTML }}</figcaption>
     </figure>
+{{ else if $wrapper }}
+    </div>
 {{- end -}}

layouts/partials/assets/helpers/image-dimension.html

@@ -2,12 +2,14 @@
 {{- $page := .page -}}
 {{- $url := .url -}}
 {{- $ratio := .ratio -}}
+{{- $portrait := .portrait -}}
 {{- $height := .height -}}
 {{- $width := .width -}}
 {{- $plain := .plain | default false }}
 {{- $targetURL := "" -}}
 {{- $set := "" -}}
 {{- $imageset := .imageset | default false }}
+{{- $anchor := .anchor | default "" -}}
 
 <!-- Split url into base and anchor when applicable (only relevant for vector images) -->
 {{- $segments := split $url "#" -}}
@@ -45,6 +47,7 @@
 {{ $dims := slice }}
 {{- $res := "" -}}
 {{- $img := "" -}}
+{{- $data := "" -}}
 {{ $transform := "" }}
 {{- if hasSuffix $url "svg" -}}
     {{- $res = partial "utilities/GetResource.html" (dict "url" $url "page" $page) -}}
@@ -53,8 +56,16 @@
             {{ warnf "Cannot find vector image resource: %q" $url -}}
         {{ else }}
             {{ $width := string (partial "utilities/GetWidth.html" (dict "path" $url "height" 500)) }}
-            {{ $dims = $dims | append (printf "%sx500" $width) }}
+            {{ if $width }}
+                {{ $dims = $dims | append (printf "%sx500" $width) }}
+            {{ else }}
+                {{ $dims = $dims | append "500" }}
+            {{ end }}
         {{ end }}
+    {{ else if eq (string $res.MediaType) "image/svg+xml" }}
+        {{ $data = $res.Content }}
+    {{ else }}
+        {{ warnf "Unsupported media type '%s': %q" (string $res.MediaType) $url -}}
     {{ end }}
 {{ else if $ratio }}
     {{ $transform = "fill" }}
@@ -80,10 +91,27 @@
 
 <!-- Derive image width and height -->
 {{ if not $plain }}
-    {{ with $dims }}
-        {{ range $dim := (. | last 1) }}
-            {{ $width = (int (index (split $dim "x") 0)) }}
-            {{ $height = (int (index (split $dim "x") 1)) }}
+    {{ if $portrait }}
+        {{ with $dims }}
+            {{ $newDims := slice }}
+            {{ range $dim := . }}
+                {{ $width = (int (index (split $dim "x") 1)) }}
+                {{ $height = (int (index (split $dim "x") 0)) }}
+                {{- $newDims = $newDims | append (printf "%dx%d" (int $width) $height ) -}}
+            {{ end }}
+            {{ $dims = $newDims }}
+        {{ end }}
+
+        {{ $newWidth := $height }}
+        {{ $newHeight := $width }}
+        {{ $width = $newWidth }}
+        {{ $height = $newHeight }}
+    {{ else  }}
+        {{ with $dims }}
+            {{ range $dim := (. | last 1) }}
+                {{ $width = (int (index (split $dim "x") 0)) }}
+                {{ $height = (int (index (split $dim "x") 1)) }}
+            {{ end }}
         {{ end }}
     {{ end }}
 {{ end }}
@@ -96,14 +124,22 @@
         "url" $url
         "img" $img
         "dims" ($dims | last 1)
+        "anchor" $anchor
         "transform" $transform
         "hook" $hook
-        "format" "jpg"
+        "format" "png"
         "includeWidth" false
     )}}
     {{ if $imageset }}
-        {{- $set = partial "assets/helpers/image-set.html" (dict "url" $url "img" $img "dims" $dims "transform" $transform "hook" $hook) -}}
+        {{- $set = partial "assets/helpers/image-set.html" (dict 
+            "url" $url
+            "img" $img
+            "dims" $dims
+            "anchor" $anchor
+            "transform" $transform
+            "hook" $hook
+        ) -}}
     {{ end }}
 {{ end }}
 
-{{ return (dict "target" $targetURL "set" $set "height" $height "width" $width) }}
+{{ return (dict "target" $targetURL "set" $set "height" $height "width" $width "data" $data) }}

layouts/partials/assets/helpers/image-set.html

@@ -7,6 +7,7 @@
 {{ $transform := .transform }}
 {{ $format := .format }}
 {{ $includeWidth := .includeWidth | default true }}
+{{ $anchor := .anchor | default "" }}
 
 {{ $host := (urls.Parse $url).Hostname }}
 {{ $dir := (urls.Parse $url).Path }}
@@ -35,6 +36,7 @@
         "width" $width
         "height" $height
         "format" $format
+        "anchor" $anchor
     )}}
     {{ if $includeWidth }}
         {{ $imgset = $imgset | append (printf "%s %dw" $element $width) }}

layouts/partials/assets/image.html

@@ -27,6 +27,7 @@
 {{- if eq $priority "auto" }}{{ $priority = "" }}{{ end -}}
 {{- $sizes := .sizes | default "100vw" -}}
 {{- $plain := .plain | default false -}}
+{{- $anchor := .anchor | default "" -}}
 
 {{- $absoluteURL := site.Params.main.canonifyAssetsURLs | default false -}}
 {{- $url := .url -}}
@@ -49,6 +50,7 @@
     "sizes" $sizes
     "absoluteURL" $absoluteURL
     "plain" $plain
+    "anchor" $anchor
     )
 -}}
 

layouts/partials/assets/link.html

@@ -14,6 +14,7 @@
 
 <!-- Initialize arguments -->
 {{ $destination := strings.TrimPrefix (strings.TrimSuffix "/" site.BaseURL) .destination }}
+{{ if not $destination }}{{ $destination = "/" }}{{ end }}
 
 {{- $target := "" -}}
 {{- $rel := "" -}}
@@ -22,9 +23,11 @@
 {{- $cue := .cue | default site.Params.main.externalLinks.cue -}}
 {{- $tab := .tab | default site.Params.main.externalLinks.tab -}}
 {{- $isExternal := or (ne (urls.Parse (absURL $destination)).Host (urls.Parse site.BaseURL).Host) $external -}}
+{{- $isLocal := hasPrefix $destination "#" -}}
 {{- $page := .page -}}
 {{- $anchor := "" -}}
 {{- $text := .text -}}
+{{- $title := .title -}}
 {{- $class := .class -}}
 
 <!-- Main code -->
@@ -53,24 +56,50 @@
         {{ end }}
     {{ end }}
 
-    {{ $ref := partial "utilities/GetPage.html" (dict "url" $destination "page" $page) }}
-    {{- if not $ref -}}
-        {{- errorf "partial [assets/link.html] - Cannot find page: %s" $destination -}}
-        {{- $error = true -}}
-    {{- else -}}
-        {{- $destination = $ref.RelPermalink -}}
-        {{- with $anchor }}{{ $destination = printf "%s#%s" (strings.TrimSuffix "/" $destination) . -}}{{ end -}}
+    {{ if not $isLocal }}
+        {{ $ref := partial "utilities/GetPage.html" (dict "url" $destination "page" $page) }}
+        {{- if not $ref -}}
+            {{ $pageContext := "" }}
+            {{ with $page.File }}{{ $pageContext = path.Join "/content" .Dir }}{{ end }}
+            {{ $isPageRes := fileExists (path.Join $pageContext $destination) }}
+            {{ $isStatic := fileExists (path.Join "static" $destination) }}
+            {{ if and (not $isPageRes) (not $isStatic) }}
+                {{- errorf "partial [assets/link.html] - Cannot find page or asset: '%s' at '%s'" $destination $page.File.Path -}}
+                {{- $error = true -}}
+            {{ else if $isPageRes }}
+                {{ $destination = partial "utilities/URLJoin.html" (dict "elements" (slice "/" (strings.TrimPrefix "/content" $pageContext) $destination)) }}
+            {{ else if $isStatic }}
+                {{ $destination = partial "utilities/URLJoin.html" (dict "base" "/" "path" $destination) }}
+            {{ end }}
+            {{- with $anchor }}{{ $destination = printf "%s#%s" (strings.TrimSuffix "/" $destination) . -}}{{ end -}}
+        {{ end }}
+        
+        {{- if and $ref (not $error) -}}
+            {{- $destination = $ref.RelPermalink -}}
+            {{- with $anchor }}{{ $destination = printf "%s#%s" (strings.TrimSuffix "/" $destination) . -}}{{ end -}}
+        {{- end -}}
+
         {{- if not $text -}}
-            {{- if $anchor -}}
-                {{- $text = $anchor -}}
-            {{- else -}}
-                {{- $text = $ref.LinkTitle -}}
-            {{- end -}}
+            {{ if $anchor }}{{ $text = $anchor }}{{ else }}{{ $text = $ref.LinkTitle }}{{ end }}
         {{ end -}}
-        {{- if not $case }}{{ $text = lower $text }}{{ end -}}
-    {{- end -}}
+    {{ else }}
+        {{ with $anchor }}
+            {{ $destination = printf "#%s" . }}
+            {{ if not $text }}{{ $text = . }}{{ end }}
+        {{ end }}
+    {{ end }}
+
+    {{- if not $case }}{{ $text = lower $text }}{{ end -}}
 {{- end -}}
 
 {{ if not $error -}}
-    <a {{ with $class }}class="{{ . }}" {{ end }}href="{{ $destination | safeURL }}"{{ with $target }} target="{{ . }}"{{ end }}{{ with $rel }} rel="{{ . }}"{{ end }}>{{ $text }}</a>
-{{- end }}
+    <a 
+        {{- with $destination }} href="{{ . | safeURL }}"{{ end -}}
+        {{ with $class }} class="{{ . }}" {{ end -}}
+        {{ with $target }} target="{{ . }}"{{ end -}}
+        {{ with $rel }} rel="{{ . }}"{{ end -}}
+        {{ with $title }} title="{{ . }}"{{ end -}}
+    >
+        {{- $text | safeHTML -}}
+    </a>
+{{- end -}}

layouts/partials/assets/list.html

@@ -47,7 +47,8 @@
     <div class="d-none d-md-block p-0">
         {{- range $index, $item := $list -}}
             {{- $odd := eq (mod $index 2) 1 -}}
-            {{- $thumbnail := (or (and (reflect.IsMap $item.Params.Thumbnail) $item.Params.Thumbnail.url) $item.Params.Thumbnail) -}}
+            {{- $thumbnail := "" -}}
+            {{ if reflect.IsMap $item.Params.Thumbnail }}{{ $thumbnail = $item.Params.Thumbnail.url }}{{ else }}{{ $thumbnail = $item.Params.Thumbnail }}{{ end }}
             <div class="container ratio-section d-flex flex-column">
                 <div class="row pt-5 pb-5 align-items-center flex-fill row-cols-2">
                     <div class="col-6{{ if $odd }} order-last{{ end }}">
@@ -69,7 +70,8 @@
     <div class="d-md-none">
         {{- range $index, $item := $list -}}
             {{- $odd := eq (mod $index 2) 1 -}}
-            {{- $thumbnail := (or (and (reflect.IsMap $item.Params.Thumbnail) $item.Params.Thumbnail.url) $item.Params.Thumbnail) -}}
+            {{- $thumbnail := "" -}}
+            {{ if reflect.IsMap $item.Params.Thumbnail }}{{ $thumbnail = $item.Params.Thumbnail.url }}{{ else }}{{ $thumbnail = $item.Params.Thumbnail }}{{ end }}
             <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">

layouts/partials/assets/nav.html

@@ -66,7 +66,8 @@
                 {{ $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) -}}
+                {{- $thumbnail := "" -}}
+                {{ if reflect.IsMap $item.Params.Thumbnail }}{{ $thumbnail = $item.Params.Thumbnail.url }}{{ else }}{{ $thumbnail = $item.Params.Thumbnail }}{{ end }}
                 <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  

layouts/partials/assets/navbar-item.html

@@ -16,6 +16,7 @@
 {{- $page := .page -}}
 {{- $menu := .menu -}}
 {{- $parent := .parent -}}
+{{- $plain := .plain | default false -}}
 {{- $class := .class -}}
 {{- $cue := .cue | default site.Params.main.externalLinks.cue -}}
 {{- $tab := .tab | default site.Params.main.externalLinks.tab -}}
@@ -23,11 +24,12 @@
 {{- $menuURL := "" -}}
 {{ if or (strings.HasPrefix $menu.PageRef "http") (strings.HasPrefix $menu.URL "http") }}
     {{ $menuURL = or $menu.PageRef $menu.URL }}
-{{ else }}
-    {{- $menuURL = urls.JoinPath $baseURL ((or $menu.PageRef $menu.URL) | relLangURL) -}}
+{{ else if (or $menu.PageRef $menu.URL) }}
+    {{- $menuURL = partial "utilities/URLJoin.html" (dict "base" $baseURL "path" ((or $menu.PageRef $menu.URL) | relLangURL)) -}}
 {{ end }}
 {{- $pageURL := $page.RelPermalink -}}
 {{- $isActive := or (and (hasPrefix $pageURL $menuURL) (ne $menuURL ("/" | relLangURL))) (eq $pageURL $menuURL) -}}
+{{ if not $menu.PageRef }}{{ $isActive = false }}{{ end }}
 {{- $isAlias := $menu.Params.alias -}}
 {{- $isIcon := $menu.Params.icon -}}
 
@@ -46,6 +48,11 @@
     {{- if $cue -}}
         {{ $suffix = partial "assets/icon.html" (dict "icon" "fas up-right-from-square fa-2xs") }}
     {{- end -}}
+{{ else if $menuURL }}
+    {{ $ref := partial "utilities/GetPage.html" (dict "url" $url.Path "page" $page) }}
+    {{- if not $ref -}}
+        {{- warnf "partial [assets/navbar-item.html] - Cannot find page of menu item '%s': %s" $menu.Name $url -}}
+    {{ end }}
 {{ end -}}
 
 {{- $mainNav := urlize (lower $menu.Name) -}}
@@ -56,7 +63,7 @@
     {{- $mainNav = urlize (lower $parent.Name) -}}
     {{- $childNav = urlize (lower $menu.Name) -}}
     {{- $anchorClass = "dropdown-item" -}}
-{{- else if $menu.HasChildren -}}
+{{- else if and (not $plain) $menu.HasChildren -}}
     {{- $anchorClass = "nav-link dropdown-toggle" -}}
     {{- $button = " role=\"button\" data-bs-toggle=\"dropdown\" aria-expanded=\"false\"" -}}
 {{- else -}}
@@ -70,20 +77,29 @@
 
 <!-- Main code -->
 {{ if not $error }}
-    <a class="{{ $anchorClass }}{{ if $isActive }} active{{ end }}{{ with $class }} {{. }}{{ end }}" 
-        {{ if $isIcon }}aria-label="{{ $menu.Name }}"{{ end }}
-        data-nav="main" data-nav-main="{{ $mainNav }}"{{ with $childNav }} data-nav-child="{{ . }}"{{ end }} 
-        href="{{ $menuURL }}{{ $params | safeHTMLAttr }}"{{ with $externalHref }} {{ . | safeHTMLAttr }}{{ end }} {{ $button | safeHTMLAttr }}>
-        
-        {{- with $menu.Pre }}
-            {{ if hasPrefix . "<i" }}
-                {{ . | safeHTML }}
-            {{ else }}
-                {{ partial "assets/icon.html" (dict "icon" (string .) )}}
-            {{ end }}
-        {{ end -}}
-        <span {{ if $isActive }} class="active"{{ end }}>{{ if not $isIcon }}{{ $menu.Name }}{{ end }}</span>
-        {{- with $menu.Post }}{{ . }}{{ end -}}
-        {{- if not $isIcon }}&nbsp;{{ $suffix }}{{ end -}}
-    </a>
+    {{ if $menu.Params.button }}
+        {{ partial "assets/button.html" (dict 
+            "title" $menu.Name
+            "icon" $menu.Pre
+            "href" $menuURL
+            "size" "sm"
+        )}}
+    {{ else }}
+        <a class="{{ $anchorClass }}{{ if $isActive }} active{{ end }}{{ with $class }} {{ . }}{{ end }}" 
+            {{ if $isIcon }}aria-label="{{ $menu.Name }}"{{ end }}
+            data-nav="main" data-nav-main="{{ $mainNav }}"{{ with $childNav }} data-nav-child="{{ . }}"{{ end }} 
+            {{ if $menuURL }} href="{{ $menuURL }}{{ $params | safeHTMLAttr }}"{{ with $externalHref }} {{ . | safeHTMLAttr }}{{ end }}{{ end }} {{ $button | safeHTMLAttr }}>
+            
+            {{- with $menu.Pre }}
+                {{ if hasPrefix . "<i" }}
+                    {{ . | safeHTML }}
+                {{ else }}
+                    {{ partial "assets/icon.html" (dict "icon" (string .) )}}
+                {{ end }}
+            {{ end -}}
+            <span {{ if $isActive }} class="active"{{ end }}>{{ if or (not $isIcon) $plain }}{{ $menu.Name }}{{ end }}</span>
+            {{- with $menu.Post }}{{ . }}{{ end -}}
+            {{- if not $isIcon }}&nbsp;{{ $suffix }}{{ end -}}
+        </a>
+    {{ end }}
 {{ end }}

layouts/partials/assets/navbar.html

@@ -51,7 +51,7 @@
                 {{- end -}}
                 {{ if $item.url }}
                     <li>
-                        {{- $url := (urls.JoinPath $baseURL $item.url) | relLangURL -}}
+                        {{- $url := partial "utilities/URLJoin.html" (dict "base" $baseURL "path" $item.url) | relLangURL -}}
                         <a class="pe-5 dropdown-item{{ if $collapsed }} switch-mode-collapsed{{ end }}{{ if $active }} active{{ end }}{{ if $disabled }} disabled{{ end }}" href="{{ $url }}">{{ $item.label }}
                             {{ if $item.latest }}&nbsp;({{ T "latest" }}){{ end }}
                             {{ if $active }}
@@ -67,7 +67,7 @@
             {{- if site.Params.docs.overview -}}
                 {{ if gt (len $list) 0 }}<li><hr class="dropdown-divider"></li>{{ end }}
                 <li>
-                    {{- $url := (urls.JoinPath $baseURL site.Params.docs.overview) | relLangURL -}}
+                    {{- $url := partial "utilities/URLJoin.html" (dict "base" $baseURL "path" site.Params.docs.overview) | relLangURL -}}
                     <a class="dropdown-item{{ if $collapsed }} switch-mode-collapsed{{ end }}" href="{{ $url }}">{{ T "allVersions" }}</a>
                 </li>
             {{- end -}}
@@ -107,7 +107,7 @@
     {{- $enableVersions = gt (len $list ) 1 -}}
 {{ end }}
 
-{{- $enableLanguage := or $page.IsTranslated site.IsMultiLingual -}}
+{{- $enableLanguage := or $page.IsTranslated hugo.IsMultilingual -}}
 {{- $horizontal := default false site.Params.navigation.horizontal -}}
 
 {{- $logo := .logo | default site.Params.navigation.logo -}}
@@ -142,9 +142,9 @@
     {{- end -}}
 {{- end -}}
 
-{{ if $logo }}{{ $logo = urls.JoinPath $baseURL $logo }}{{ end }}
-{{ if $logoLight }}{{ $logoLight = urls.JoinPath $baseURL $logoLight }}{{ end }}
-{{ if $logoDark }}{{ $logoDark = urls.JoinPath $baseURL $logoDark }}{{ end }}
+{{ if $logo }}{{ $logo = partial "utilities/URLJoin.html" (dict "base" $baseURL "path" $logo) }}{{ end }}
+{{ if $logoLight }}{{ $logoLight = partial "utilities/URLJoin.html" (dict "base" $baseURL "path" $logoLight) }}{{ end }}
+{{ if $logoDark }}{{ $logoDark = partial "utilities/URLJoin.html" (dict "base" $baseURL "path" $logoDark) }}{{ end }}
 
 {{- $title := site.Title -}}
 {{- if .title -}}
@@ -154,18 +154,18 @@
 
 {{- $pre := .Pre -}}
 {{- $post := .Post -}}
-
-{{- $theme := "light" -}}
-{{- if in (slice "primary" "secondary" "success" "danger" "black") $color }}{{ $theme = "dark" }}{{ end -}}
-{{- if in (slice "body" "body-tertiary") $color }}{{ $theme = "" }}{{ end -}}
-{{- if not $color }}{{ $theme = "" }}{{ end -}}
 {{- $class := .class -}}
 
 {{- $contrast := false -}}
 {{- if in (slice "primary" "secondary" "success" "danger") $color }}{{ $contrast = true }}{{ end -}}
 
+{{- $flex := false }}
+{{ if gt (where $menus "Params.spacing" true | len) 0 }}
+    {{ $flex = true }}
+{{ end }}
+
 <!-- Main code -->
-<div class="container-fluid {{ if $fixed }}fixed-top{{ end }} p-0{{ with $class }} {{ . }}{{ end }}">
+<div class="container-fluid {{ if $fixed }}fixed-top{{ else if $overlay }}navbar-overlay{{ end }} p-0{{ with $class }} {{ . }}{{ end }}">
     {{- partial "assets/page-alert.html" (dict "page" $page) -}}
     <nav class="navbar p-4
         {{- if not $overlay }}{{ with $color }} bg-{{ . }}{{ end }}{{ end -}}
@@ -173,9 +173,9 @@
         {{ if $contrast }} navbar-contrast{{ end }}"
         {{ if $overlay }}
         data-bs-theme="{{ $overlayMode }}"
-        data-bs-overlay="{{ $overlayMode }}"
-        {{ else }}{{ with $theme }}data-bs-theme="{{ . }}"{{ end }}{{ end }}
-        {{ if $overlay }}data-navbar-color="{{ $color }}"{{ end }}
+        {{ if $fixed }}data-bs-overlay="{{ $overlayMode }}"{{ end }}
+        {{ if $color }}data-navbar-color="{{ $color }}"{{ end }}
+        {{ end }}        
         >
         <div class="container-xxl p-0">
             <div class="d-flex navbar-container justify-content-center">
@@ -213,35 +213,41 @@
                 <div class="d-flex align-items-center">
                     <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>
-                        <span class="toggler-icon middle-bar emphasis{{ with $theme }}-{{ . }}{{ end }}"></span>
-                        <span class="toggler-icon bottom-bar emphasis{{ with $theme }}-{{ . }}{{ end }}"></span>
+                        <span class="toggler-icon top-bar emphasis"></span>
+                        <span class="toggler-icon middle-bar emphasis"></span>
+                        <span class="toggler-icon bottom-bar emphasis"></span>
                     </button>
                 </div>
             </div>
     
             <div class="navbar-collapse collapse" id="{{ $id }}-collapse">
                 <!-- Insert search input -->
-                {{- if and $search (not $searchModal)  }}{{ partial "assets/search-input.html" }}{{ end -}}
+                {{- if and $search (not $searchModal) }}
+                    {{ partial "assets/search-input.html" (dict "class" (printf "mt-4 mt-%s-0" $size)) }}
+                {{ end -}}
                 
                 <!-- Render top-menu items (maximum depth of 2) -->
-                <ul class="navbar-nav ms-auto">
+                <ul class="navbar-nav {{ if $flex }}d-flex w-100{{ else }}ms-auto{{ end }}">
                     {{- range $menu := $menus -}}
-                        <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">
-                                    {{- range .Children -}}
-                                        <li>{{- partial "assets/navbar-item.html" (dict "menu" . "parent" $menu "page" $page) -}}</li>
-                                    {{- end -}}
-                                </ul>
-                            {{- end -}}
-                        </li>
+                        {{ if $menu.Params.spacing }}
+                            <li class="nav-item flex-grow-1"></li>
+                        {{ else }}
+                            <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">
+                                        {{- range .Children -}}
+                                            <li>{{- partial "assets/navbar-item.html" (dict "menu" . "parent" $menu "page" $page) -}}</li>
+                                        {{- end -}}
+                                    </ul>
+                                {{- end -}}
+                            </li>
+                        {{- end -}}
                     {{- end -}}
     
                     <!-- Insert divider if applicable -->
                     {{- if and $menus (or $enableLanguage $enableVersions) -}}
-                        <li class="nav-item py-2 py-md-1 col-12 col-md-auto d-none d-{{ $size }}-block">
+                        <li class="nav-item py-2 py-md-1 col-12 col-md-auto d-none d-{{ $size }}-block me-auto">
                             <div class="vr d-none d-md-flex h-100 mx-md-2"></div>
                         </li>
                         <li><hr class="dropdown-divider-bg"></li>
@@ -256,21 +262,21 @@
                     <!-- Insert language switcher if applicable -->
                     {{- if $enableLanguage -}}
                         {{- $currentLang := $page.Language.Lang -}}
-                        <li class="nav-item dropdown">
+                        <li class="nav-item dropdown me-auto">
                             <a class="nav-link dropdown-toggle d-{{ $size }}-none" href="#!" role="button" data-bs-toggle="dropdown" aria-label="{{ T "languageSwitcherLabel" }}" aria-expanded="false">
                                 {{- partial "assets/icon.html" (dict "icon" "fas globe fa-fw" "spacing" false) }}&nbsp;{{ T "languageSwitcherLabel" }}
                             </a>
                             <a class="nav-link dropdown-toggle d-none d-{{ $size }}-block" href="#!" role="button" data-bs-toggle="dropdown" aria-label="{{ T "languageSwitcherLabel" }}" aria-expanded="false">
                                 {{- partial "assets/icon.html" (dict "icon" "fas globe fa-fw" "spacing" false) }}
                             </a>
-                            <ul class="dropdown-menu dropdown-menu-end ">
+                            <ul class="dropdown-menu dropdown-menu-end " id="language-selector">
                                 {{- if $page.IsTranslated -}}
                                     {{- range $page.AllTranslations -}}
-                                        <li><a class="dropdown-item {{ if eq .Language.Lang $currentLang }}active{{ end }}" href="{{ .RelPermalink }}">{{ .Language.LanguageName  }}</a></li>
+                                        <li><a class="dropdown-item {{ if eq .Language.Lang $currentLang }}active{{ end }}" hreflang="{{.Language.Lang}}" href="{{ .RelPermalink }}">{{ .Language.LanguageName  }}</a></li>
                                     {{- end -}}
                                 {{- else -}}
                                     {{- range site.Languages -}}
-                                        <li><a class="dropdown-item" href="{{ urls.JoinPath $baseURL .Lang }}">{{ default .Lang .LanguageName }}</a></li>
+                                        <li><a class="dropdown-item" href="{{ partial "utilities/URLJoin.html" (dict "base" $baseURL "path" .Lang) }}" hreflang="{{.Lang}}">{{ default .Lang .LanguageName }}</a></li>
                                     {{- end -}}
                                 {{- end -}}
                             </ul>
@@ -284,7 +290,7 @@
 
                     <!-- Insert modal search button -->
                     {{- if $searchModal }}
-                        <li class="nav-item py-2 py-md-1 col-12 col-md-auto d-none d-{{ $size }}-block">
+                        <li class="nav-item py-2 py-md-1 col-12 col-md-auto d-none d-{{ $size }}-block me-auto">
                             <div class="vr d-none d-md-flex h-100 mx-md-2"></div>
                         </li>
                         <li><hr class="dropdown-divider-bg"></li>

layouts/partials/assets/persona.html

@@ -32,7 +32,9 @@
     {{- if not $title }}{{ $title = .Title }}{{ end -}}
     {{- if not $href }}{{ $href = .RelPermalink  }}{{ end -}}
     {{- if not $content }}{{ $content = .Content }}{{ end -}}
-    {{- if not $thumbnail }}{{ $thumbnail = (or (and (reflect.IsMap .Params.Thumbnail) .Params.Thumbnail.url) .Params.Thumbnail) }}{{ end -}}
+    {{- if not $thumbnail }}
+        {{ if reflect.IsMap .Params.Thumbnail }}{{ $thumbnail = .Params.Thumbnail.url }}{{ else }}{{ $thumbnail = .Params.Thumbnail }}{{ end }}
+    {{ end -}}
 {{- end -}}
 
 {{- $class := .class -}}

layouts/partials/assets/section-list.html

@@ -64,11 +64,11 @@
     {{- with index . "layout" }}{{ $layout = . }}{{ end -}}
     {{- with index . "pane" }}{{ $pane = . }}{{ end -}}
     {{- with index . "type" }}{{ $type = . }}{{ end -}}
-    {{- with index . "vertical" }}{{ $vertical = partial "utilities/CastBool.html" . }}{{ end -}}
+    {{- if (isset . "vertical") }}{{ $vertical = partial "utilities/CastBool.html" (index . "vertical") }}{{ end -}}
     {{- with index . "width" }}{{ $width = . }}{{ end -}}
     {{- with index . "kind" }}{{ $kind = . }}{{ end -}}
     {{- with index . "ratio" }}{{ $ratio = . }}{{ end -}}
-    {{- with index . "wrap" }}{{ $wrap = partial "utilities/CastBool.html" . }}{{ end -}}
+    {{- if (isset . "wrap") }}{{ $wrap = partial "utilities/CastBool.html" (index . "wrap") }}{{ end -}}
 {{- end -}}
 
 {{ if isset $page.Params "nested" }}
@@ -143,7 +143,7 @@
 
     <div class="container-fluid {{ with $background }} bg-{{ . }}{{ end }} p-0">
         <div class="container-xxl {{ $wrapper }}">
-            {{- partial "assets/section-header.html" (dict  "title" $title "description" $description "content" $content) -}}
+            {{- partial "assets/section-header.html" (dict "title" $title "description" $description "content" $content) -}}
             {{ if eq $layout "card" }}
                 {{- $partial = "assets/card-group.html" -}}
                 {{- $params = merge $params (dict 

layouts/partials/assets/sidebar.html

@@ -26,8 +26,8 @@
     {{- $group := .group -}}
     {{- $data := .menu -}}
 
-    {{- $doc_slug := urls.JoinPath  $baseURL ($group.title | urlize) -}}
-    {{- $href := or $group.link (partial "utilities/GetStaticURL" (dict "url" $doc_slug)) -}}
+    {{- $doc_slug := partial "utilities/URLJoin.html" (dict "base" $baseURL "path" ($group.title | urlize)) -}}
+    {{- $href := or $group.link $doc_slug -}}
     {{- $collapsed := strings.HasPrefix $page.RelPermalink $href -}}
 
     <li class="mb-1">
@@ -78,10 +78,10 @@
         {{ if hasPrefix . "http" }}
             {{ $href = . }}
         {{ else }}
-            {{- $href = (partial "utilities/GetStaticURL" (dict "url" (urls.JoinPath $baseURL .))) -}}
+            {{- $href = partial "utilities/URLJoin.html" (dict "base" $baseURL "path" .) -}}
         {{ end }}
     {{ else }}
-        {{- $href =  partial "utilities/GetStaticURL" (dict "url" (urls.JoinPath $baseURL ($title | urlize))) -}}
+        {{- $href = partial "utilities/URLJoin.html" (dict "base" $baseURL "path" ($title | urlize)) -}}
     {{ end }}
     {{- $active := eq (strings.TrimSuffix "/" $page.RelPermalink) (strings.TrimSuffix "/" $href) -}}
 
@@ -121,7 +121,8 @@
     <nav class="sidebar flex-shrink-0 ps-1 pt-3" aria-label="{{ (strings.FirstUpper $section) }} navigation">
         {{- $sectionBreak := false -}}
         {{- $level := 0 -}}
-        {{- $baseURL := relLangURL (path.Join $section $version) }}
+        {{ $baseURL := $page.Scratch.Get "baseURL" | default "/" -}}
+        {{ $baseURL = partial "utilities/URLJoin.html" (dict "elements" (slice "/" (strings.TrimPrefix $baseURL (urls.JoinPath $section $version | relLangURL)))) }}
 
         <ul class="list-unstyled ps-0">
         {{- range $index, $item := $data -}}

layouts/partials/assets/table.html

@@ -7,6 +7,9 @@
 {{ $page := .page }}
 {{ $input := .input }}
 {{ $args := .args }}
+{{ $sortable := .sortable | default false }}
+{{ $paging := .paging | default false }}
+{{ $searchable := .searchable | default false }}
 
 {{- $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 -}}
@@ -18,14 +21,20 @@
     {{ $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 -}}
+{{ if or $sortable $paging $searchable }}{{ $class = trim (printf "%s data-table" $class) " " }}{{ end }}
+{{- $input := $input | $page.RenderString }}
+{{ $regex := `<table\s*class="(.+?)"` }}
+{{ $current := (index (index (findRESubmatch $regex $input) 0) 1) }}
+{{ $target := delimit (((split $current " ") | append "table" | append $class) | uniq) " " }}
+
+{{ $attributes := "" }}
+{{ if $sortable }}{{ $attributes = printf "%s data-table-sortable=true" $attributes }}{{ end }}
+{{ if $paging }}{{ $attributes = printf "%s data-table-paging=true" $attributes }}{{ end }}
+{{ if $searchable }}{{ $attributes = printf "%s data-table-searchable=true" $attributes }}{{ end }}
+
+{{- $new := printf `<table class="%s" %s` $target (trim $attributes " ") -}}
+{{ $input := replaceRE $regex $new $input 1 -}}
 {{- with $responsive }}<div class="{{ delimit . " " }}">{{ end -}}
 {{ $input | safeHTML }}
 {{- with $responsive }}</div>{{ end -}}

layouts/partials/assets/video.html

@@ -0,0 +1,148 @@
+<!-- 
+    Copyright © 2024 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.
+
+    This source code adapts the original embedded shortcode as maintained by the Hugo repository. It introduces the
+    following modifications:
+     - Isolated the styles to comply with the Content Security Policy
+     - Added validation of shortcode arguments
+     - Added support to retrieve the title from the video metadata
+     - Adjusted autoplay configuration
+     - Modified the layout
+    
+    The original source code is available on:
+    https://github.com/gohugoio/hugo/tpl/tplimpl/embedded/templates/shortcodes/youtube.html
+    https://github.com/gohugoio/hugo/tpl/tplimpl/embedded/templates/shortcodes/vimeo.html
+    Copyright 2022 The Hugo Authors. Licensed under the Apache License, Version 2.0.
+-->
+
+{{ $error := false }}
+
+<!-- Validate arguments -->
+{{ if partial "utilities/IsInvalidArgs.html" (dict "structure" "video" "args" . "group" "partial") }}
+    {{- errorf "partial [assets/video.html] - Invalid arguments" -}}
+    {{ $error = true }}
+{{ end }}
+
+<!-- Initialize arguments -->
+{{- $page := .page -}}
+{{- $position := .position -}}
+{{- $host := .host -}}
+{{- $title := .title -}}
+{{- $class := .class -}}
+{{- $account := .account -}}
+{{- $id := .id -}}
+{{- $autoplay := .autoplay -}}
+{{- $autotitle := .autotitle -}}
+{{- $ratio := .ratio -}}
+{{- $pc := "" -}}
+{{- if eq $host "youtube" }}
+    {{- $pc = $page.Site.Config.Privacy.YouTube -}}
+{{- else if eq $host "vimeo" }}
+    {{- $pc = $page.Site.Config.Privacy.Vimeo -}}
+{{- end -}}
+
+{{ if and (eq $host "youtube") ($pc.Disable) }}
+    {{- errorf "partial [assets/video.html] - YouTube video disabled in site's privacy settings" -}}
+    {{ $error = true }}
+{{ else if and (eq $host "vimeo") ($pc.Disable) }}
+    {{- errorf "partial [assets/video.html] - Vimeo video disabled in site's privacy settings" -}}
+    {{ $error = true }}
+{{ end }}
+
+{{ if not $account }}
+    {{ with index $page.Site.Params.videos $host }}
+        {{ with index . "account" }}{{ $account = . }}{{ end }}
+    {{ end }}
+{{ end }}
+
+{{ $origin := $position }}
+{{ if not $origin }}{{ with $page.File }}{{ $origin = .Path }}{{ end }}{{ end }}
+
+<!-- Main code -->
+{{ if not $error -}}
+    {{ if eq $host "youtube" }}
+        {{- $host := cond $pc.PrivacyEnhanced  "www.youtube-nocookie.com" "www.youtube.com" -}}
+        {{ $url := printf "https://%s/embed/%s?origin=%s" $host $id $page.Site.BaseURL }}
+        {{ $api := printf "https://www.youtube.com/oembed?format=json&url=%s" (printf "https://www.youtube.com/watch?v=%s" $id) }}
+        {{ $padding := "56.25%" }}
+
+        {{ with resources.GetRemote $api }}
+            {{ with .Err }}
+                {{ errorf "Unable to parse video metadata '%q': %s\n  %s" $api $origin . }}
+            {{ else }}
+                {{ $data := . | transform.Unmarshal }}
+                {{ if $autotitle }}{{ with $data.title }}{{ $title = . }}{{ end }}{{ end }}
+                {{ $padding = printf "%.2f%%" (mul (div $data.height $data.width) 100) }}
+            {{ end }}
+        {{ else }}
+            {{ errorf "Unable to get video metadata '%q': %s" $api $origin }}
+        {{ end }}
+
+        <div class="video-embedded {{ $class }}" data-video-padding="{{ $padding }}">
+            <iframe src="{{ $url }}{{ if $autoplay }}&autoplay=1&mute=1{{ end }}"
+                allowfullscreen title="{{ $title }}" {{ if $autoplay }}allow="autoplay"{{ end }}>
+            </iframe>
+        </div>
+    {{ else if eq $host "vimeo" }}
+        {{ $url := printf "https://player.vimeo.com/video/%s" $id }}
+        {{ $params := "" }}
+        {{ if $autoplay }}{{ $params = print $params "&autoplay=1&muted=1" }}{{ end }}
+        {{ if $pc.EnableDNT }}{{ $params = print $params "&dnt=1" }}{{ end }}
+        {{ $params = strings.TrimPrefix "&" $params }}
+        {{ with $params }}{{ $url = printf "%s?%s" $url . }}{{ end }}
+        {{ $padding := "56.25%" }}
+
+        {{- $dnt := cond $pc.EnableDNT 1 0 -}}
+        {{- $query := querify "url" $url "dnt" $dnt -}}
+        {{- $api := printf "https://vimeo.com/api/oembed.json?%s" $query -}}
+        {{- with resources.GetRemote $api -}}
+            {{ with .Err }}
+                {{ errorf "Unable to parse video metadata '%q': %s\n  %s" $api $origin . }}
+            {{ else }}
+                {{ $data := . | transform.Unmarshal }}
+                {{ if $autotitle }}{{ with $data.title }}{{ $title = . }}{{ end }}{{ end }}
+                {{ $padding = printf "%.2f%%" (mul (div $data.height $data.width) 100) }}
+            {{ end }}
+        {{- end -}}
+
+        <div class="video-embedded {{ $class }}" data-video-padding="{{ $padding }}">
+            <iframe src="{{ $url | safeHTMLAttr }}" title="{{ $title }}" webkitallowfullscreen mozallowfullscreen allowfullscreen>
+            </iframe>
+        </div>
+    {{ else if eq $host "cloudinary" }}
+        {{ if not $account }}
+            {{ errorf "Missing account name for Cloudinary video '%s': %s" $id $origin }}
+        {{ end }}
+
+        {{ $url := printf "https://player.cloudinary.com/embed/?cloud_name=%s&public_id=%s" $account $id }}
+        {{ $params := "&controls=true" }}
+        {{ if $autoplay }}{{ $params = print $params "&autoplay=true&muted=true" }}{{ end }}
+        {{ with $params }}{{ $url = print $url . }}{{ end }}
+        {{ $padding := "56.25%" }}
+
+        {{ $thumbnail := partial "utilities/URLJoin.html" (dict "base" (path.Dir $id) "path" (printf "%s.jpg" (path.BaseName $id))) }}
+        {{ $metadata := partial "assets/helpers/image-dimension.html" (dict 
+            "page" $page
+            "url" (printf "https://res.cloudinary.com/%s/video/upload/%s" $account (path.Clean $thumbnail))
+            "ratio" $ratio
+            "imageset" false
+        ) }}
+        {{ $height := index $metadata "height" }}
+        {{ $width := index $metadata "width" }}
+        {{ if and $height $width }}
+            {{ $padding := printf "%.2f%%" (mul (div (float $height) $width) 100) }}
+            {{ if not $title }}{{ $title = printf "Cloudinary video '%s'" (path.BaseName $id) }}{{ end }}
+
+            <div class="video-embedded {{ $class }}" data-video-padding="{{ $padding }}">
+                <iframe src="{{ $url | safeHTMLAttr }}" title="{{ $title }}" webkitallowfullscreen mozallowfullscreen allowfullscreen>
+                </iframe>
+            </div>
+        {{ else }}
+            {{ errorf "Cannot retrieve metadata of Cloudinary video '%s' with account '%s': %s" $id $account $origin }}
+        {{ end }}
+    {{ else }}
+        {{ warnf "partial [assets/video.html] - Unsupported video provider: %s" $host }}
+    {{ end }}
+{{ end -}}

layouts/partials/footer/optional-scripts.html

@@ -4,6 +4,7 @@
 {{ else }}
     {{ $page_modules = $page_modules | append .Params.modules }}
 {{ end }}
+{{ with .Scratch.Get "dependencies" }}{{ $page_modules = append $page_modules . | uniq }}{{ end }}
 
 {{ $config := page.Scratch.Get "modules" }}
 {{ if not $config }}
@@ -26,5 +27,20 @@
         {{- with index . "state" }}{{ $state = . }}{{ end -}}
     {{- end -}}
 
-    {{- partial "footer/scripts.html" (dict "filename" $filename "match" $match "header" false "skipTemplate" $skipTemplate "state" $state "page" .) }}
+    {{ $localize := false }}
+    {{- if reflect.IsSlice $config.localize -}}
+        {{- if in $config.localize $mod}}
+            {{- $localize = true -}}
+        {{- end -}}
+    {{- end -}}
+
+    {{- partial "footer/scripts.html" (dict 
+        "filename" $filename
+        "match" $match
+        "header" false
+        "skipTemplate" $skipTemplate
+        "state" $state
+        "localize" $localize
+        "page" page
+    ) }}
 {{- end -}}

layouts/partials/footer/scripts.html

@@ -1,3 +1,18 @@
+<!-- 
+    Copyright © 2024 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 }}
+
+<!-- Validate arguments -->
+{{ if partial "utilities/IsInvalidArgs.html" (dict "structure" "scripts" "args" . "group" "partial") }}
+    {{- errorf "partial [footer/scripts.html] - Invalid arguments" -}}
+    {{ $error = true }}
+{{ end }}
+
+<!-- Initialize arguments -->
 {{- $absoluteURL := site.Params.main.canonifyAssetsURLs | default false -}}
 {{- $filename := .filename | default "js/main.bundle.js" -}}
 {{- $match := .match | default "{js/*.js,js/vendor/**.js}" -}}
@@ -5,26 +20,41 @@
 {{- $header := .header -}}
 {{- $core := .core | default false -}}
 {{- $skipTemplate := .skipTemplate | default false -}}
+{{- $localize := .localize | default false }}
 
-{{- $state := "async" -}}
-{{- with .state }}{{ $state = . }}{{ end -}}
+{{- $state := .state | default "async" -}}
 {{- if or $header (eq $state "immediate") }}{{ $state = "" }}{{ end -}}
-{{- $supportedStates := slice "defer" "async" "immediate" -}}
-{{- if and $state (not (in $supportedStates $state)) -}}
-    {{- errorf "partial [footer/script.html] - Invalid value for param 'processing': %s" $state -}}
-{{- end -}}
-
-{{ $config := page.Scratch.Get "modules" }}
-{{ if not $config }}
-    {{ errorf "partial [footer/scripts.html] - Cannot initialize module configuration" }}
-{{ end }}
 
 {{- $modules := "" -}}
 {{ if $core }}
+    {{ $config := $page.Scratch.Get "modules" }}
+    {{ if not $config }}
+        {{ errorf "partial [footer/scripts.html] - Cannot initialize module configuration" }}
+    {{ end }}
+
     {{- $modules = $config.core -}}
+    {{- if reflect.IsSlice $config.localize -}}
+        {{- range $index, $mod := $modules -}}            
+            {{- if in $config.localize $mod}}
+                {{- $localize = true -}}
+            {{- end -}}
+        {{- end -}}
+    {{- end -}}
 {{- end -}}
 
-{{- $bundle := partial "utilities/bundle" (dict "match" $match "filename" $filename "modules" $modules "basepath" "js/modules" "all" true "debugging" site.Params.debugging.showJS) -}}
+{{ if $localize }}
+    {{ $filename = path.Join (path.Dir $filename) (printf "%s.%s%s" (path.BaseName $filename) $page.Language.Lang (path.Ext $filename)) }}
+{{ end }}
+
+<!-- Main code -->
+{{- $bundle := partial "utilities/bundle" (dict
+    "match" $match
+    "filename" $filename
+    "modules" $modules
+    "basepath" "js/modules"
+    "all" true
+    "debugging" site.Params.debugging.showJS
+) -}}
 {{- $js := $bundle -}}
 {{- if not $skipTemplate -}}
     {{- $js = $bundle | resources.ExecuteAsTemplate $filename $page -}}

layouts/partials/head/head.html

@@ -14,6 +14,7 @@
     {{ end }}
         
     {{ $page_modules := slice | append .Page.Params.modules }}
+    {{ with .Scratch.Get "dependencies" }}{{ $page_modules = append $page_modules . | uniq }}{{ end }}
     {{- $modules := $config.optional | intersect $page_modules -}}
     {{- range $index, $mod := $modules -}}
         {{- $source := printf "scss/%s.scss" $mod -}}

layouts/partials/head/seo.html

@@ -13,8 +13,10 @@
 {{ end }}
 {{ $.Scratch.Set "description" $description -}}
 
-{{- $thumbnail := (or (and (reflect.IsMap .Params.Thumbnail) .Params.Thumbnail.url) .Params.Thumbnail) -}}
-{{ with $thumbnail -}}
+{{- $thumbnail := "" -}}
+{{ if reflect.IsMap .Params.Thumbnail }}{{ $thumbnail = .Params.Thumbnail.url }}{{ else }}{{ $thumbnail = .Params.Thumbnail }}{{ end }}
+
+{{ if $thumbnail -}}
     {{ $imgURL := index (partial "assets/helpers/image-dimension.html" (dict "url" $thumbnail "width" 1280 "height" 640 "page" .)) "target" }}
     {{ $.Scratch.Set "thumbnail" ($imgURL | absURL) -}}
 {{ else -}}

layouts/partials/head/structured-data.html

@@ -17,6 +17,8 @@
   {{ end -}}
 {{ end -}}
 
+{{ $alt := slice .Site.Params.schema.twitter .Site.Params.schema.linkedin .Site.Params.schema.github }}
+
 <script type="application/ld+json">
 {
   "@context": "https://schema.org",
@@ -31,17 +33,7 @@
       {{ end -}}
       "name": "{{ .Site.Params.schema.name }}",
       "url": {{ print $baseURL }},
-      "sameAs": [
-        {{ with .Site.Params.schema.twitter -}}
-        {{ . }}
-        {{ end -}}
-        {{ with .Site.Params.schema.linkedin -}}
-        , {{ . }}
-        {{ end -}}
-        {{ with .Site.Params.schema.github -}}
-        , {{ . }}
-        {{ end -}}
-      ],
+      "sameAs": {{ $alt | uniq | complement (slice "") }},
       {{ if eq .Site.Params.schemaType "Organization" -}}
         "logo": {
           "@type": "ImageObject",
@@ -103,8 +95,8 @@
           "@id": {{ print $baseURL "#/schema/person/1" }}
         },
       {{ end -}}
-      "datePublished": "{{ .Date.Format "2006-01-02T15:04:05CET" }}",
-      "dateModified": "{{ .Lastmod.Format "2006-01-02T15:04:05CET" }}",
+      {{ with .Date }}"datePublished": "{{ .Format "2006-01-02T15:04:05CET" }}",{{ end -}}
+      {{ with .Lastmod }}"dateModified": "{{ .Format "2006-01-02T15:04:05CET" }}",{{ end -}}
       "breadcrumb": {
         "@id": {{ print .Permalink "#/schema/breadcrumb/1" }}
       },
@@ -151,8 +143,8 @@
           "mainEntityOfPage": {
             "@id": {{ .Permalink }}
           },
-          "datePublished": "{{ .Date.Format "2006-01-02T15:04:05CET" }}",
-          "dateModified": "{{ .Lastmod.Format "2006-01-02T15:04:05CET" }}",
+          {{ with .Date }}"datePublished": "{{ .Format "2006-01-02T15:04:05CET" }}",{{ end -}}
+          {{ with .Lastmod }}"dateModified": "{{ .Format "2006-01-02T15:04:05CET" }}",{{ end -}}
           "author": {
             "@id": {{ print $baseURL "#/schema/person/2" }}
           },

layouts/partials/head/stylesheet.html

@@ -73,7 +73,7 @@
     {{ end }}
     {{- if site.Params.style.purge -}}
         {{- $post_options := dict "config" "config" "noMap" hugo.IsProduction -}}
-        {{- $css = $css | resources.PostCSS $post_options -}}
+        {{- $css = $css | css.PostCSS $post_options -}}
     {{- end -}}
 
     {{- if not hugo.IsProduction -}}

layouts/partials/list/featured.html

@@ -40,7 +40,7 @@
             {{- $actions = sort $actions "weight" "asc" -}}
             <div class="hstack{{ if gt (len $actions) 1 }} gap-1{{ end }} justify-content-{{ $align}} pt-5 pt-md-3">
                 {{ range $actions }}
-                    {{ partial "assets/button.html" (dict "href" .url "icon" .icon "title" .title "outline" .outline "order" "last" "justify" "start") }}
+                    {{ partial "assets/button.html" (dict "href" .url "icon" .icon "label" .label "title" .title "outline" .outline "order" "last" "justify" "start") }}
                 {{ end }}
             </div>
         {{ end }}
@@ -61,7 +61,8 @@
             {{ partial "assets/icon.html" (dict "icon" "mode" $mode $icon "wrapper" "col-6 mx-auto text-center")}}
         {{ end }}
     {{ else }}
-        {{- $thumbnail := (or (and (reflect.IsMap $page.Params.Thumbnail) $page.Params.Thumbnail.url) $page.Params.Thumbnail) -}}
+        {{- $thumbnail := "" -}}
+        {{ if reflect.IsMap $page.Params.Thumbnail }}{{ $thumbnail = $page.Params.Thumbnail.url }}{{ else }}{{ $thumbnail = $page.Params.Thumbnail }}{{ end }}
         {{- if $thumbnail }}
             {{ partial "assets/image.html" (dict "url" $thumbnail "ratio" "16x9" "sizes" $sizes "wrapper" $style "class" "rounded" "title" $page.Site.Title "priority" "high") }}
         {{ end }}

layouts/partials/utilities/AddModule.html

@@ -0,0 +1,9 @@
+{{ with .module }}
+	{{- $dependencies := page.Scratch.Get "dependencies" -}}
+	{{- if reflect.IsSlice $dependencies -}}
+		{{- $dependencies = complement $dependencies . -}}
+	{{ else }}
+		{{- $dependencies = slice . -}}
+	{{ end }}
+	{{- page.Scratch.Set "dependencies" $dependencies -}}
+{{ end }}

layouts/partials/utilities/GetIllustration.html

@@ -12,7 +12,8 @@
         {{ $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) -}}
+    {{- $thumbnail := "" -}}
+    {{ if reflect.IsMap $item.Params.Thumbnail }}{{ $thumbnail = $item.Params.Thumbnail.url }}{{ else }}{{ $thumbnail = $item.Params.Thumbnail }}{{ end }}
     {{- if $thumbnail }}
         {{ $illustration = partial "assets/image.html" (dict "url" $thumbnail "ratio" "16x9" "wrapper" $style "inner" "rounded" "title" $item.Site.Title) }}
     {{ end }}