Merge pull request #1491 from gethinode/develop

fix: improve non-fluid section rendering

.github/workflows/lint-build.yml

@@ -14,6 +14,10 @@ env:
   CACHE_PATH_WIN: '~\AppData\Local\hugo_cache'
   CACHE_PATH_MAC: '/Users/runner/Library/Caches/hugo_cache'
 
+permissions:
+  pull-requests: read
+  contents: read
+
 jobs:
   lint:
     runs-on: ubuntu-latest

.github/workflows/npm-publish.yml

@@ -1,41 +0,0 @@
-# This workflow will run tests using node and then publish a package to npmjs.org when a release is created
-# For more information see: https://docs.github.com/en/actions/publishing-packages/publishing-nodejs-packages
-name: Publish package to npmjs
-
-on:
-  workflow_dispatch:
-  release:
-    types: [published]
-
-env:
-  REGISTRY_URL: 'https://registry.npmjs.org/'
-
-jobs:
-  build:
-    strategy:
-      matrix:
-        os: [ubuntu-latest]
-        node-version: [20.x]
-
-    runs-on: ${{ matrix.os }}
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Setup .npmrc file to publish to npm
-        uses: actions/setup-node@v4
-        with:
-          node-version: ${{ matrix.node-version }}
-          registry-url: ${{ env.REGISTRY_URL }}
-          cache: 'npm'
-          cache-dependency-path: '**/package-lock.json'
-  
-      # [27/AUG/23] Adjusted from npm ci to prevent EBADPLATFORM error due to fsevents
-      - name: Install npm
-        run: npm i
-
-      - name: Publish package to npm
-        run: npm publish
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.github/workflows/release.yml

@@ -0,0 +1,44 @@
+name: Release
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - main
+
+env:
+  HUSKY: 0
+
+permissions:
+  contents: read # for checkout
+
+jobs:
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write # to be able to publish a GitHub release
+      issues: write # to be able to comment on released issues
+      pull-requests: write # to be able to comment on released pull requests
+      id-token: write # to enable use of OIDC for npm provenance
+    
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "lts/*"
+
+      - name: Install dependencies
+        run: npm clean-install
+
+      - name: Verify the integrity of provenance attestations and registry signatures for installed dependencies
+        run: npm audit signatures
+
+      - name: Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: npx semantic-release

.gitignore

@@ -1,5 +1,6 @@
 _vendor/
 prebuild/
+prebuild-headers/
 public/
 resources/
 node_modules/

.husky/commit-msg

@@ -0,0 +1 @@
+npx --no -- commitlint --edit $1

.husky/install.mjs

@@ -0,0 +1,6 @@
+// Skip Husky install in production and CI
+if (process.env.NODE_ENV === 'production' || process.env.CI === 'true') {
+    process.exit(0)
+}
+const husky = (await import('husky')).default
+console.log(husky())

.husky/pre-commit

@@ -0,0 +1 @@
+npm test

assets/scss/common/_styles.scss

@@ -18,23 +18,13 @@ a:active {
 // Ensure main page is rendered to full viewport height
 //
 .main {
-    min-height: 100vh;
-}
-
-.fullcover {
     --navbar-height: #{$navbar-height};
-
-    min-height: calc(100vh - var(--navbar-height));
-}
-
-.fullscreen {
     --overlay-offset: #{$overlay-offset};
+    --section-height: 88vh;
+    --max-section-height: 1024px;
 
-    min-height: calc(100vh - var(--overlay-offset));
-}
-
-.main-content {
-    margin-top: var(--navbar-offset);
+    min-height: 100vh;
+    margin-top: var(--overlay-offset);
 }
 
 $utilities: map-merge(
@@ -100,66 +90,24 @@ $utilities: map-merge(
     )
 );
 
-@media screen and (orientation: portrait) {
-    .min-vh-custom {
-        min-height: 25vh !important
-    }
-}
-
-@media screen and (orientation: landscape) {
-    .min-vh-custom {
-        min-height: 50vh !important
-    }
-}
-
 :root {
     --nav-height: 90px;
 }
 
-@include media-breakpoint-up(sm) {
-    .ratio-section {
-        min-height: calc(min(100vh, 576px) - var(--nav-height));
-    }    
-}
-
-@include media-breakpoint-up(md) {
-    .ratio-section {
-        min-height: calc(min(100vh, 768px) - var(--nav-height));
-    }    
-}
-
-@include media-breakpoint-up(lg) {
-    .ratio-section {
-        min-height: calc(min(100vh, 992px) - var(--nav-height));
-    }    
-}
-
-@include media-breakpoint-up(xl) {
-    .ratio-section {
-        min-height: calc(min(100vh, 1200px) - var(--nav-height));
-    }    
-}
-
-@include media-breakpoint-up(xxl) {
-    .ratio-section {
-        min-height: calc(min(100vh, 1400px) - var(--nav-height));
-    }    
-}
-
 .section-cover {
-    min-height: 100vh;
+    min-height: calc(var(--section-height) - var(--overlay-offset));
 }    
 
 @include media-breakpoint-up(xxl) {
     .section-cover {
-        min-height: calc(min(100vh, 1000px));
+        min-height: calc(min(calc(var(--section-height) - var(--overlay-offset)), var(--max-section-height)));
     }    
 }
 
 /* stylelint-disable media-feature-range-notation */
 @media (min-height: 1400px) { 
     .section-cover {
-        min-height: calc(min(100vh, 1000px));
+        min-height: calc(min(calc(var(--section-height) - var(--overlay-offset)), var(--max-section-height)));
     }
 }
 /* stylelint-enable media-feature-range-notation */

assets/scss/common/_variables-dart.scss

@@ -69,3 +69,8 @@ $theme-colors: (
   "body":          $body-bg,
   "body-tertiary": $gray-100,
 );
+
+$btn-padding-y-xs:            .08rem !default;
+$btn-padding-x-xs:            0.3rem !default;
+$btn-font-size-xs:            $font-size-base * .6 !default;
+$btn-border-radius-xs:        .2rem !default;

assets/scss/common/_variables.scss

@@ -64,3 +64,8 @@ $theme-colors: (
   "body":          $body-bg,
   "body-tertiary": $gray-100,
 );
+
+$btn-padding-y-xs:            .08rem !default;
+$btn-padding-x-xs:            0.3rem !default;
+$btn-font-size-xs:            $font-size-base * .6 !default;
+$btn-border-radius-xs:        .2rem !default;

assets/scss/components/_button.scss

@@ -48,3 +48,7 @@ a.btn {
 
     margin: 0 !important;
 }
+
+.btn-xs {
+  @include button-size($btn-padding-y-xs, $btn-padding-x-xs, $btn-font-size-xs, $btn-border-radius-xs);
+}

assets/scss/components/_nav.scss

@@ -1,14 +1,8 @@
-.nav-tabs .nav-tabs {
-    border: none;
+.nav-tabs {
+    border: none !important;
 }
 
-.nav-tabs .nav-link.active {
-    border-bottom-color: var(--bs-body-bg) !important;
-    border-bottom-style: solid !important;
-    z-index: 1;
-}
-
-.nav-callout {
+.nav-callout, .tab-content {
     --#{$prefix}nav-callout-bg: var(--#{$prefix}light);
     --#{$prefix}nav-callout-active-bg: var(--bs-primary-bg-subtle);
     --#{$prefix}nav-callout-gap: #{$nav-underline-gap};
@@ -92,7 +86,7 @@
 
 @if $enable-dark-mode {
     @include color-mode(dark) {
-        .nav-callout {
+        .nav-callout, .tab-content {
             --#{$prefix}nav-callout-bg: var(--#{$prefix}tertiary-bg);
         }
 

commitlint.config.js

@@ -0,0 +1 @@
+module.exports = {extends: ['@commitlint/config-conventional']}

component-library/bookshop.scss

@@ -1,6 +1,8 @@
 @import "modules/bookshop/shared/styles/global";
 @import "modules/bookshop/components/about/about";
 @import "modules/bookshop/components/articles/articles";
+@import "modules/bookshop/components/cards/cards";
+@import "modules/bookshop/components/cta/cta";
 @import "modules/bookshop/components/faq/faq";
 @import "modules/bookshop/components/hero/hero";
 @import "modules/bookshop/components/releases/releases";

component-library/components/about/about.bookshop.yml

@@ -30,6 +30,7 @@ blueprint:
     mode:
   order:
   width:
+  justify:
   link-type:
   links:
     -

component-library/components/about/about.hugo.html

@@ -9,6 +9,7 @@
 {{ if or $args.err $args.warnmsg }}
     {{ partial (cond $args.err "utilities/LogErr.html" "utilities/LogWarn.html") (dict 
         "partial" "component-library/components/about/about.hugo.html" 
+        "warnid"  "warn-invalid-arguments"
         "msg"     "Invalid arguments"
         "details" ($args.errmsg | append $args.warnmsg)
         "file"    page.File
@@ -18,14 +19,15 @@
 {{/* Main code */}}
 {{ if not $args.error }}
     {{ partial "assets/hero.html"  (dict 
+        "page"         page
         "heading"      $args.heading
         "background"   $args.background
-        "illustration" (merge (dict "ratio" "1x1") $args.illustration)
+        "illustration" (merge (dict "ratio" "auto") $args.illustration)
         "order"        $args.order
         "link-type"    $args.linkType
         "links"        $args.links
         "orientation"  "horizontal"
-        "width"        (or .width 8)
+        "width"        (or $args.width 8)
         )
     }}
 {{- end -}}

component-library/components/articles/articles.bookshop.yml

@@ -29,7 +29,7 @@ blueprint:
     link:
   cols:
   padding:
-  max:
+  limit:
   pagination:
   paginate:
   background:
@@ -43,3 +43,5 @@ blueprint:
   footer-style:
   orientation:
   class:
+  width:
+  justify:

component-library/components/articles/articles.hugo.html

@@ -11,6 +11,7 @@
 {{ if or $args.err $args.warnmsg }}
     {{ partial (cond $args.err "utilities/LogErr.html" "utilities/LogWarn.html") (dict 
         "partial" "component-library/components/articles/articles.hugo.html" 
+        "warnid"  "warn-invalid-arguments"
         "msg"     "Invalid arguments"
         "details" ($args.errmsg | append $args.warnmsg)
         "file"    page.File
@@ -61,15 +62,14 @@
 
 <!-- Main code -->
 {{ if not $error }}
-	<div class="container-xxl p-4 px-xxl-0">
-		{{- partial "assets/section-title.html" (dict "heading" $args.heading "class" "py-5") -}}
+	{{- partial "assets/section-title.html" (dict "heading" $args.heading "justify" $args.justify) -}}
 
 	{{ $partial := "assets/card-group.html" }}
 	{{ $params := dict }}
 	{{- $params = merge $params (dict
 		"page"         page
 		"list"         $pages
-			"max"          $args.max
+		"limit"        $args.limit
 		"cols"         $args.cols
 		"icon-rounded" $args.iconRounded
 		"href"         (cond $moreButton $moreLink "")
@@ -104,5 +104,4 @@
 		) -}}
 	{{ end }}
 	{{ partial $partial $params }}
-	</div>
 {{ end }}

component-library/components/cards/cards.bookshop.yml

@@ -0,0 +1,34 @@
+# Metadata about this component, to be used in the CMS
+spec:
+  structures:
+    - content_blocks
+  label: Benefits
+  description: Introduction section
+  icon: check
+  tags: []
+
+# Defines the structure of this component, as well as the default values
+blueprint:
+  heading:
+    preheading:
+    heading:
+    content:
+    align:
+    width:
+  cols:
+  icon-rounded:
+  padding:
+  background:
+    backdrop:
+    color:
+    subtle:
+  elements:
+    - title:
+      icon:
+      image:
+      mode:
+      content:
+  orientation:
+  class:
+  width:
+  justify:

component-library/components/cards/cards.hugo.html

@@ -0,0 +1,72 @@
+{{/* 
+    Copyright © 2025 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 }}
+
+{{/* Initialize arguments */}}
+{{ $args := partial "utilities/InitArgs.html" (dict "bookshop" "cards" "args" .)}}
+{{ if or $args.err $args.warnmsg }}
+    {{ partial (cond $args.err "utilities/LogErr.html" "utilities/LogWarn.html") (dict 
+        "partial" "component-library/components/cards/cards.hugo.html" 
+        "warnid"  "warn-invalid-arguments"
+        "msg"     "Invalid arguments"
+        "details" ($args.errmsg | append $args.warnmsg)
+        "file"    page.File
+    )}}
+    {{ $error = $args.err }}
+{{ end }}
+
+{{/* Initialize global arguments */}}
+{{- $breakpoint := partial "utilities/GetBreakpoint.html" -}}
+
+{{/* Initialize local variables */}}
+{{ $list := slice }}
+{{ range $args.elements }}
+	<!-- TODO: check mode -->
+	{{ $list = $list | append (dict 
+		"title"       .title
+		"description" (.content | page.RenderString)
+		"icon"        .icon
+		"thumbnail"   .image
+	) }}
+{{ end}}
+
+{{ if not $error }}
+	{{- partial "assets/section-title.html" (dict "heading" $args.heading "justify" $args.justify) -}}
+
+	{{- partial "assets/card-group.html" (dict 
+		"page"         page
+		"list"         $list
+		"class"        (printf "border-0 card-icon-primary d-%s-none %s" $breakpoint.prev $args.class)
+		"cols"         $args.cols
+		"gutter"       "4"
+		"padding"      $args.padding
+		"header-style" "none"
+		"footer-style" "none"
+		"icon-rounded" $args.iconRounded
+		"icon-style"   "fa-2x"
+		"align"        "start"
+		"orientation"  ($args.orientation | default "horizontal-sm")
+		"hook"         "assets/live-card.html"
+	) -}}
+
+	{{- partial "assets/card-group.html" (dict 
+		"page"         page
+		"list"         $list
+		"class"        (printf "border-0 card-icon-primary d-none d-%s-block %s" $breakpoint.prev $args.class)
+		"cols"         $args.cols
+		"gutter"       "4"
+		"padding"      $args.padding
+		"header-style" "none"
+		"footer-style" "none"
+		"icon-rounded" $args.iconRounded
+		"icon-style"   "fa-2x"
+		"align"        "start"
+		"orientation"  ($args.orientation | default "stacked")
+		"hook"         "assets/live-card.html"
+	) -}}
+{{ end }}
+

component-library/components/cta/cta.bookshop.yml

@@ -0,0 +1,43 @@
+# Metadata about this component, to be used in the CMS
+spec:
+  structures:
+    - content_blocks
+  label: CTA
+  description: Call to action
+  icon: contact_page
+  tags: []
+
+# Defines the structure of this component, as well as the default values
+blueprint:
+  heading:
+    preheading:
+    title:
+    content:
+    align:
+    arrangement:
+    width:
+    size:
+  contact:
+  caption-url:
+  illustration:
+    image:
+    icon:
+    ratio:
+    class:
+    anchor:
+    mode:
+  background:
+    backdrop:
+    color:
+    subtle:
+  links:
+    -
+      title:
+      url:
+      icon:
+      force:
+  align:
+  fluid:
+  padding:
+  order:
+  width:

component-library/components/cta/cta.hugo.html

@@ -0,0 +1,43 @@
+{{/* 
+    Copyright © 2025 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.
+*/}}
+
+{{/* Initialize arguments */}}
+{{ $args := partial "utilities/InitArgs.html" (dict "bookshop" "cta" "args" .) }}
+{{ if or $args.err $args.warnmsg }}
+    {{ partial (cond $args.err "utilities/LogErr.html" "utilities/LogWarn.html") (dict 
+        "partial" "component-library/components/cta/cta.hugo.html" 
+        "warnid"  "warn-invalid-arguments"
+        "msg"     "Invalid arguments"
+        "details" ($args.errmsg | append $args.warnmsg)
+        "file"    page.File
+    )}}
+{{- end -}}
+
+{{/* Main code */}}
+{{ if not $args.error }}
+	{{ $links := slice }}
+	{{ if and (reflect.IsSlice .links) (gt (len .links) 0) }}
+		{{ $links = .links }}
+	{{ else }}
+		{{ with site.Params.modules.bookshop.cta.defaultURL }}
+			{{ $links = $links | append (dict "title" (T "contactAction") "url" . "icon" "fas chevron-right") }}
+		{{ end }}
+	{{ end }}
+
+	{{ partial "assets/contact.html" (dict 
+		"page"         page
+		"orientation"  "horizontal"
+		"heading"      $args.heading
+		"contact"      $args.contact
+		"caption-url"  $args.captionUrl
+		"illustration" $args.illustration
+		"class"        "contact-img"
+		"links"        $links
+		"align"        $args.align
+		"order"        $args.order
+		"data"         site.Params.modules.bookshop.cta.section 
+	) }}
+{{ end }}

component-library/components/cta/cta.scss

@@ -0,0 +1,8 @@
+.cta {
+    background-color: var(--#{$prefix}primary-bg-subtle);
+}
+
+.cta .contact-img {
+    background-color: var(--#{$prefix}body-bg);
+    border-radius: var(--bs-border-radius);
+}

component-library/components/faq/faq.bookshop.yml

@@ -17,6 +17,8 @@ blueprint:
     width:
     size:
   contrast:
+  width:
+  justify:
   background:
     backdrop:
     color:

component-library/components/faq/faq.hugo.html

@@ -9,6 +9,7 @@
 {{ if or $args.err $args.warnmsg }}
     {{ partial (cond $args.err "utilities/LogErr.html" "utilities/LogWarn.html") (dict 
         "partial" "component-library/components/faq/faq.hugo.html" 
+        "warnid"  "warn-invalid-arguments"
         "msg"     "Invalid arguments"
         "details" ($args.errmsg | append $args.warnmsg)
         "file"    page.File
@@ -16,14 +17,9 @@
 {{ end }}
 
 {{ if not $args.err }}
-	<div class="container-xxl p-4 px-xxl-0">
 	{{ $color := "" }}
 	{{ if $args.contrast }}{{ $color = "white" }}{{ end }}
-		{{- partial "assets/section-title.html" (dict 
-			"heading" $args.heading
-			"color" $color
-			"class" "py-5"
-		) -}}
+	{{- partial "assets/section-title.html" (dict "heading" $args.heading "color" $color "justify" $args.justify) -}}
 
 	{{ $class := "" }}
 	{{ $id := printf "faq-%s" (md5 (delimit (slice . now) "-")) }}
@@ -54,5 +50,4 @@
 			</div>
 		{{ end }}
 	</div>
-	</div>
 {{ end }}

component-library/components/hero/hero.bookshop.yml

@@ -38,3 +38,4 @@ blueprint:
   cover:
   orientation:
   width:
+  justify:

component-library/components/hero/hero.hugo.html

@@ -9,6 +9,7 @@
 {{ if or $args.err $args.warnmsg }}
     {{ partial (cond $args.err "utilities/LogErr.html" "utilities/LogWarn.html") (dict 
         "partial" "component-library/components/hero/hero.hugo.html" 
+        "warnid"  "warn-invalid-arguments"
         "msg"     "Invalid arguments"
         "details" ($args.errmsg | append $args.warnmsg)
         "file"    page.File
@@ -17,6 +18,7 @@
 
 {{ if not $args.err }}
 	{{ partial "assets/hero.html"  (dict 
+        "page"         page
 		"breadcrumb"   $args.breadcrumb
 		"heading"      $args.heading
 		"background"   $args.background
@@ -29,6 +31,7 @@
 		"links"        $args.links
 		"orientation"  $args.orientation
 		"width"        $args.width
+		"justify"      $args.justify
 		)
 	}}
 {{ end }}

component-library/components/releases/releases.bookshop.yml

@@ -21,4 +21,6 @@ blueprint:
     backdrop:
     color:
     subtle:
+  width:
+  justify:
   data:

component-library/components/releases/releases.hugo.html

@@ -9,6 +9,7 @@
 {{ if or $args.err $args.warnmsg }}
     {{ partial (cond $args.err "utilities/LogErr.html" "utilities/LogWarn.html") (dict 
         "partial" "component-library/components/releases/releases.hugo.html" 
+        "warnid"  "warn-invalid-arguments"
         "msg"     "Invalid arguments"
         "details" ($args.errmsg | append $args.warnmsg)
         "file"    page.File

component-library/components/separator/separator.hugo.html

@@ -8,6 +8,7 @@
 {{ if or $args.err $args.warnmsg }}
     {{ partial (cond $args.err "utilities/LogErr.html" "utilities/LogWarn.html") (dict 
         "partial" "component-library/components/separator/separator.hugo.html" 
+        "warnid"  "warn-invalid-arguments"
         "msg"     "Invalid arguments"
         "details" ($args.errmsg | append $args.warnmsg)
         "file"    page.File
@@ -15,5 +16,5 @@
 {{ end }}
 
 {{ if not $args.err }}
-    <div class="container-xxl p-0"{{ with $args.theme }} data-bs-theme="{{ . }}"{{ end }}><hr></div>
+    <hr class="w-100">
 {{ end }}

component-library/components/video-message/video-message.bookshop.yml

@@ -39,6 +39,7 @@ blueprint:
       label:
   border:
   width:
+  justify:
 
 _structures:
   messages:

component-library/components/video-message/video-message.hugo.html

@@ -9,6 +9,7 @@
 {{ if or $args.err $args.warnmsg }}
     {{ partial (cond $args.err "utilities/LogErr.html" "utilities/LogWarn.html") (dict 
         "partial" "component-library/components/video-message/video-message.hugo.html" 
+        "warnid"  "warn-invalid-arguments"
         "msg"     "Invalid arguments"
         "details" ($args.errmsg | append $args.warnmsg)
         "file"    page.File
@@ -16,6 +17,7 @@
 {{ end }}
 
 {{- $breakpoint := partial "utilities/GetBreakpoint.html" -}}
+{{- $padding := partial "utilities/GetPadding.html" -}}
 
 {{- define "_partials/inline/video.html" -}}
 	{{ $provider := .provider }}
@@ -24,10 +26,14 @@
 	{{ $autoplay := .autoplay }}
 	{{ $queryArgs := .queryArgs }}
 	{{ $border := .border }}
+	{{ $padding := .padding }}
 
 	{{ if site.Params.env_bookshop_live }}
 		{{/* Define dummy content as we cannot retrieve video data in live mode */}}
-		{{- partial "assets/live-image.html" (dict "src" "/img/placeholder-video.svg" "ratio" "21x9" "wrapper" "text-center mb-4") -}}
+		{{- partial "assets/live-image.html" (dict
+			"src" "/img/placeholder-video.svg"
+			"ratio" "21x9"
+			"wrapper" (printf "text-center mb-%d" $padding.y)) -}}
 	{{ else }}
         <div class="video-container{{ if $border }} video-container-border{{ end}}">
 			{{ partial "assets/video.html" (dict
@@ -72,7 +78,7 @@
 	) -}}
 {{ end }}
 
-<div class="container-xxl p-4 px-xxl-0">
+{{ if not $args.err }}
 	{{ $list := slice }}
 
 	{{ range $args.messages }}
@@ -90,13 +96,10 @@
 		) }}
 	{{ end}}
 
-	{{- partial "assets/section-title.html" (dict 
-		"heading" $args.heading
-		"class"   "py-5"
-	) -}}
+	{{- partial "assets/section-title.html" (dict "heading" $args.heading "justify" $args.justify) -}}
 
 	{{ if eq $args.orientation "stacked" }}
-		<div class="col-{{ $breakpoint.current }}-{{ $args.width }} mx-auto">
+		<div class="col-{{ $breakpoint.current }}-{{ $args.width }} mx-auto pb-{{ $padding.y }}">
 		{{ with $args.video }}
 			{{- partial "inline/video.html" (dict
 				"provider"   .provider
@@ -105,14 +108,15 @@
 				"autoplay"   .autoplay
 				"query-args" .queryArgs
 				"border"     $.border
+				"padding"    $padding
 			) -}}
 		{{ end }}
 		</div>
-		<div class="mt-4">
+		<div class="mt-{{ $padding.y }} pb-{{ $padding.y }}">
 			{{- partial "inline/messages.html" (dict "list" $list "cols" $args.cols "type" $args.type "iconRounded" $args.iconRounded) -}}
 		</div>
 	{{ else }}
-		<div class="container grid gap-4">
+		<div class="container grid gap-4 pb-{{ $padding.y }}">
 			<div class="row row-cols-1 row-cols-{{ $breakpoint.current }}-2">
 				<div class="col col-{{ $breakpoint.current }}-{{ $args.width }} p-0">
 					{{ with $args.video }}
@@ -123,13 +127,14 @@
 							"autoplay"   .autoplay
 							"query-args" .queryArgs
 							"border"     $.border
+							"padding"    $padding
 						) -}}
 					{{ end }}
 				</div>
-				<div class="col col-{{ $breakpoint.current }}-{{ sub 12 $args.width }} mt-4 mt-{{ $breakpoint.current }}-0">
+				<div class="col col-{{ $breakpoint.current }}-{{ sub 12 $args.width }} mt-{{ $padding.y }} mt-{{ $breakpoint.current }}-0">
 					{{- partial "inline/messages.html" (dict "list" $list "cols" 1 "type" $args.type "iconRounded" $args.iconRounded) -}}
 				</div>
 			</div>
 		</div>
 	{{ end }}
-</div>
+{{ end }}

component-library/helpers/component.html

@@ -15,7 +15,8 @@
 {{- $component_props := index . 1 -}}
 {{- $class := index . 2 | default "p-0" -}}
 {{- $bgclass := index . 3 | default "" -}}
-
+{{- $padding := partial "utilities/GetPadding.html" -}}
+{{- with index $component_props "padding" }}{{ $padding = dict "x" . "y" . }}{{ end -}}
 {{- $component_path := partial "_bookshop/helpers/component_key" $component_name -}}
 {{- $flat_component_path := partial "_bookshop/helpers/flat_component_key" $component_name -}}
 
@@ -31,7 +32,12 @@
     {{- $cover := index $component_props "cover" -}}
     {{- $background := index $component_props "background" -}}
     {{- $backdrop := "" -}}
+    {{- $fluid := index $component_props "fluid" | default true -}}
     {{- $style := index $component_props "wrapper" -}}
+    {{- $width := index $component_props "width" -}}
+    {{- $justify := index $component_props "justify" | default "start" -}}
+    {{- $paddingOuter := cond (ne $component_name "separator") (printf "px-xxl-0 px-%d py-0" $padding.x) "" -}}
+    {{- $padding := cond (ne $component_name "separator") (printf "px-%d %spy-%d" $padding.x (cond $fluid "px-xxl-0 " "") $padding.y) "" -}}
     {{- $wrapper := $style }}
     {{ with $background }}
         {{ $wrapper = partial "utilities/GetBackgroundStyle.html" (dict "background" . "class" $style) }}
@@ -39,14 +45,16 @@
             {{ with $background.backdrop }}{{ $wrapper = "" }}{{ $backdrop = . }}{{ end }}
         {{ end }}
     {{ end }}
-    {{/* warnf "wrapper: '%s'" $wrapper */}}
     {{- $theme := index $component_props "theme" -}}
     {{- $overlayMode := (or (index $component_props "overlay-mode") page.Params.overlayMode) | default "dark" -}}
     {{ if not $backdrop }}{{ $overlayMode = page.Params.overlayMode }}{{ end }}
     {{ if eq $overlayMode "none" }}{{ $overlayMode = "" }}{{ end }}
     
     {{ (printf "<!--bookshop-live name(%s)-->" $component_name) | safeHTML }}
-    <section {{ with $id }}id="{{ . }}" {{ end }}class="{{ $component_name }} container-fluid {{ $class }} {{ with $wrapper }}{{ . }}{{ end -}}
+    {{ if not $fluid }}<div class="container-xxl {{ $paddingOuter }}">{{ end }}
+    <section {{ with $id }}id="{{ . }}" {{ end }}class="{{ $component_name }}
+        container-fluid {{ $class }}
+        {{ with $wrapper }}{{ . }}{{ end -}}
         {{- if and $backdrop $overlayMode }} background-container{{ end -}}
         {{- if $cover }} section-cover d-flex align-items-center{{ end }}" 
         {{ with $overlayMode -}}
@@ -57,10 +65,24 @@
         {{- end -}}
         >
         {{- if $backdrop -}}
-            {{ partial "assets/live-image.html" (dict "src" $backdrop "class" (printf "background-img-fluid %s" $bgclass) "title" (T "backgroundImage")) }}
+            {{ partial "assets/live-image.html" (dict
+                "src" $backdrop
+                "class" (printf "background-img-fluid %s" $bgclass)
+                "title" (T "backgroundImage"))
+            }}
         {{- end -}}
+
+        {{ $col := cond (and $width (lt $width 12)) (printf "col-12 col-md-%d" $width) "" }}
+
+        <div class="container-{{ cond $fluid "xxl" "fluid" }} {{ $padding }} d-flex flex-column align-items-{{ $justify }}">
+            {{ with $col }}
+                <div class="{{ . }}">{{ partial $resolved_component $component_props }}</div>
+            {{ else }}
                 {{ partial $resolved_component $component_props }}
+            {{ end}}
+        </div>
     </section>
+    {{ if not $fluid }}</div>{{ end }}
     {{ "<!--bookshop-live end-->" | safeHTML }}
 {{- else -}}
     {{- $file_loc := slicestr $component_path 9 -}}

config/_default/hugo.toml

@@ -116,7 +116,7 @@ home = ["HTML", "RSS", "REDIR", "netlify", "server"]
 [module]
   [module.hugoVersion]
     extended = true
-    min = "0.141.0"
+    min = "0.146.0"
   [[module.mounts]]
     source = "archetypes"
     target = "archetypes"
@@ -188,11 +188,11 @@ home = ["HTML", "RSS", "REDIR", "netlify", "server"]
   [[module.imports]]
     path = "github.com/gethinode/mod-lottie"
   [[module.imports]]
-    path = "github.com/gethinode/mod-mermaid"
+    path = "github.com/gethinode/mod-mermaid/v2"
   [[module.imports]]
-    path = "github.com/gethinode/mod-simple-datatables"
+    path = "github.com/gethinode/mod-simple-datatables/v2"
   [[module.imports]]
-    path = "github.com/gethinode/mod-utils/v3"
+    path = "github.com/gethinode/mod-utils/v4"
 # toml-docs-end modules
 
 # toml-docs-start segments

config/_default/params.toml

@@ -11,6 +11,9 @@
     loading = "lazy"
     breakpoint = "md"
     titleCase = false
+    [main.padding]
+        x = 4
+        y = 4
     [main.internalLinks]
         validate = true
         pretty = false

config/postcss.config.js

@@ -30,7 +30,7 @@ const purgecss = purgeCSSPlugin({
       './_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/gethinode/mod-simple-datatables/v2/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',

content/_index.md

@@ -7,7 +7,7 @@ content_blocks:
       title: Welcome to Hinode!
       content: |-
         A clean documentation and blog theme for your Hugo site based on Bootstrap 5.
-      align: start
+      width: 6
     background:
       color: primary
       subtle: true
@@ -15,10 +15,10 @@ content_blocks:
       image: /img/sunrise.jpg
       ratio: 16x9
     width: 8
-    width: 6
     links:
-      - title: Get started
+      - title: Getting started
         url: https://gethinode.com/docs
-        icon: fas book-open
+        icon: fas chevron-right
     orientation: horizontal
+    justify: center
 ---

data/netlify.toml

@@ -4,12 +4,12 @@
     command = "npm run build:example"
 
 [build.environment]
-    DART_SASS_VERSION = "1.83.1"
-    HUGO_VERSION = "0.140.2"
+    DART_SASS_VERSION = "1.89.2"
+    HUGO_VERSION = "0.147.9"
     HUGO_ENV = "production"
     HUGO_ENABLEGITINFO = "true"
-    NODE_VERSION = "22.12.0"
-    NPM_VERSION = "10.9.0"
+    NODE_VERSION = "22.13.0"
+    NPM_VERSION = "10.9.2"
 # toml-docs-end netlify
 
 [context.deploy-preview]

data/structures/_types.yml

@@ -1,59 +0,0 @@
-types:
-  background:
-    backdrop:
-    color:
-    subtle:
-  heading:
-    preheading:
-    title:
-    content:
-    align:
-    arrangement:
-    width:
-    size:
-  illustration:
-    image:
-    icon:
-    ratio:
-    class:
-    anchor:
-    mode:
-    width:
-    image-overlay:
-    hook:
-  input:
-    section:
-    nested:
-    keywords:
-    categories:
-    tags:
-    reverse:
-    sort:
-  items:
-    - title:
-      description:
-  links:
-    - title:
-      url:
-      icon:
-      force:
-  messages:
-    - title:
-      icon:
-      content:
-      link:
-      label:
-  more:
-    title:
-    link:
-  styles:
-    - ratio:
-      orientation:
-      portrait:
-      width:
-  video:
-    provider:
-    account:
-    id:
-    autoplay:
-    query-args:

data/structures/args.yml

@@ -2,6 +2,9 @@ comment: >-
   Generates a markdown table of structured arguments. The argument definitions are
   expected to be defined in a data file identified by a provided structure name.
 arguments:
+  page:
+    optional: false
+    group: partial
   structure:
     type: string
     position: 0
@@ -26,3 +29,28 @@ arguments:
     comment: >-
       Flag to filter only arguments that have a parent attribute (either
       `cascade` or `merge`).
+  render-type:
+    type: select
+    position: 3
+    default: both
+    optional: true
+    comment: >-
+      Option whether to render arguments, user-defined types, or both. Please
+      note that the arguments will render a link to a user-defined type in any
+      case.
+    options:
+      values:
+        - arguments
+        - types
+        - both
+    release: v1.0.0
+  header-level:
+    type: int
+    default: 3
+    optional: true
+    options:
+      min: 1
+      max: 6
+    comment: >-
+      The header level to use for the user-defined type headers.
+    release: v1.0.0

data/structures/card-group.yml

@@ -22,7 +22,8 @@ arguments:
     release: 1.0.0
   list:
   cards:
-  max:
+  limit:
+    release: v1.0.0
   cols:
     release: v0.19.0
   paginate:
@@ -158,3 +159,12 @@ arguments:
     group: partial
     deprecated: v1.0.0
     alternative: href-title
+  max:
+    type: int
+    optional: true
+    comment: Maximum number of elements to display.
+    group: partial
+    options:
+      min: 1
+    deprecated: v1.0.0
+    alternative: limit

data/structures/card.yml

@@ -65,6 +65,7 @@ arguments:
     release: v1.0.0
   link-type:
   hook:
+    default: assets/image.html
     group: partial
   sizes:
     group: partial

data/structures/contact.yml

@@ -0,0 +1,36 @@
+comment: >-
+  Displays a contact banner, typically placed at the bottom or right-hand side of the page.
+arguments:
+  page:
+  data:
+  heading:
+  contact:
+    type: string
+    optional: false
+    comment: >-
+      The full name of the contact to retrieve.
+  caption-url:
+    type:
+      - string
+      - template.URL
+    optional: true
+    comment: >-
+      Address of the contact's page, either a local reference or an external
+      address. Include the `scheme` when referencing an external address, such
+      as `https://google.com`. Local references may include an optional anchor
+      link such as `blog/bootstrap-elements/#docs`.
+  illustration:
+  background:
+  link-type:
+  links:
+  align:
+  order:
+    default: first
+  orientation:
+  width:
+  justify:
+  class:
+  width:
+    default: 12
+  hook:
+    default: assets/hero-image.html

data/structures/file.yml

@@ -11,8 +11,8 @@ arguments:
   full:
   id: 
   class:
-  options:
-    release: v0.27.6
+  highlight-options:
+    release: v1.0.0
   # deprecated arguments
   path:
     type: string
@@ -22,3 +22,11 @@ arguments:
       the path of the repository is used as base path instead.
     deprecated: v1.0.0
     alternative: file
+  options:
+    type: string
+    optional: true
+    comment: >-
+        Hugo highlighting options, see https://gohugo.io/shortcodes/highlight/#options-1.
+    release: v0.27.6
+    deprecated: v1.0.0
+    alternative: highlight-options

data/structures/get-dimension.yml

@@ -2,3 +2,17 @@ comment: >-
   Initializes images dimensions (widht x height for supported image ratios.
 arguments:
   ratio:
+    type: select
+    optional: true
+    comment: >-
+      Ratio of the media asset. When the asset is an image, it is resized and
+      cropped (not applicable to vector graphics). For video assets, the padding
+      of the embedded frame is adjusted.
+    options:
+      values:
+        - 1x1
+        - 3x2
+        - 4x3
+        - 16x9
+        - 21x9
+        - auto

data/structures/hero-image.yml

@@ -11,3 +11,4 @@ arguments:
   wrapper:
   class:
   image-overlay:
+  justify:

data/structures/hero.yml

@@ -3,6 +3,7 @@ comment: >-
   supports a heading, featured illustration, and navigation links. You can
   can also add a background image with an overlay to improve contrast.
 arguments:
+  page:
   breadcrumb:
   heading:
   background:
@@ -15,8 +16,10 @@ arguments:
   cover:
   orientation:
   width:
+  justify:
   use-section:
   use-title:
+  size:
   class:
   padding:
     default: px-4 px-xxl-0 py-4

data/structures/image-definition.yml

@@ -4,6 +4,8 @@ arguments:
   mode:
   ratio:
   portrait:
+  image-height:
+  image-width:
   loading:
   priority:
   sizes:

data/structures/image.yml

@@ -44,6 +44,10 @@ arguments:
     release: v0.24.0
   anchor:
     release: v0.24.22
+  image-height:
+    release: v1.0.0
+  image-width:
+    release: v1.0.0
   # deprecated arguments
   url:
     type:

data/structures/kbd.yml

@@ -1,6 +1,7 @@
 comment: Adds a keyboard input element.
 arguments:
   text:
+    optional: true
     position: 0
     release: v1.0.0
   class:

data/structures/nav-item.yml

@@ -1,6 +1,8 @@
 comment: >-
   Defines an individual item.
 arguments:
+  page:
+    group: partial
   id:
     group: partial
   parent-id:

data/structures/nav.yml

@@ -7,8 +7,12 @@ arguments:
     group: partial
   list:
     group: partial
+  nav-disabled:
+    release: v1.0.0
   nav-items:
     release: v1.0.0
+  nav-show:
+    release: v1.0.0
   nav-titles:
     release: v1.0.0
   tab-type:

data/structures/section-title.yml

@@ -3,124 +3,13 @@ arguments:
   heading:
   links:
   color:
-    type: select
-    comment: Text color of the section.
     default: body
-    optional: true
-    options:
-      values:
-        - body
-        - primary
-        - secondary
-        - black
-        - white
   class:
-    type: string
-    optional: true
-    comment: Class attribute of the section title.
   size: 
-    type: int
-    optional: true
-    comment: Display size of the title.
-    options:
-      min: 1
-      max: 6
   use-title:
-    type: bool
-    optional: true
-    default: false
-    comment: Sets the title to an HTML header instead of a div.
   justify:
-    type: select
-    comment: Justification of the link titles and icons.
-    optional: true
-    default: center
-    options:
-      values:
-        - start
-        - end
-        - center
-        - between
-        - around
-        - evenly
-  type:
-    type: select
-    optional: true
-    default: button
-    comment: Link type
-    options:
-      values:
-        - button
-        - link
-  section: 
-    type: bool
-    optional: true
-    default: false
-    comment: >-
-      Trigger to use the current section as preheading, applies to single pages
-      only. Any preheading values takes precedence.
+  link-type:
+  use-section: 
   arrangement:
-  headingStyle:
-    type: select
-    optional: true
-    default: display
-    options:
-      values:
-        - display
-        - fs
-    comment: >-
-      Style of the heading, either display or fs (regular).
-  bodyStyle:
-    type: string
-    optional: true
-    default: lead text-muted
-    comment: >-
-      Style of the body text, if any..
-  # class:
-  #   type: string
-  #   optional: true
-  #   comment: Class attribute of the illustration, e.g. "col-6".
-  # image:
-  #   type: string
-  #   optional: true
-  #   comment: Image displayed on top of or adjacent to the headline.
-  # imageOverlay:
-  #   type: bool
-  #   optional: true
-  #   default: false
-  #   comment: Trigger to include an image overlay placeholder.
-  # ratio:
-  #   type: select
-  #   optional: true
-  #   default: 16x9
-  #   comment: >-
-  #     Ratio of the illustration, uses original aspect ratio by default.
-  #   options:
-  #     values:
-  #       - 1x1
-  #       - 3x2
-  #       - 4x3
-  #       - 16x9
-  #       - 21x9
-  # 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
-  # icon:
-  #   type: string
-  #   optional: true
-  #   comment: Icon or animation displayed on top of or adjacent to the headline.
+  heading-style:
+  content-style:

data/structures/timeline.yml

@@ -9,3 +9,4 @@ arguments:
     optional: false
   background:
   class:
+  justify:

data/structures/video.yml

@@ -31,6 +31,11 @@ arguments:
     deprecated: v1.0.0
     alternative: media-id
   options:
+    type: string
+    optional: true
+    comment: >-
+      Optional query parameters to append to video asset's url. The query string
+      is prepended with a `?` symbol. Only applicable to Cloudinary.
     release: v0.28.2
     deprecated: v1.0.0
     alternative: query-args

exampleSite/config/_default/hugo.toml

@@ -129,4 +129,4 @@ home = ["HTML", "RSS", "REDIR", "netlify", "server"]
   [[module.imports]]
     path = "github.com/gethinode/mod-simple-datatables"
   [[module.imports]]
-    path = "github.com/gethinode/mod-utils/v3"
+    path = "github.com/gethinode/mod-utils/v4"

exampleSite/config/_default/params.toml

@@ -9,6 +9,9 @@
     loading = "lazy"
     breakpoint = "md"
     titleCase = true
+    [main.padding]
+        x = 4
+        y = 4
     [main.internalLinks]
         validate = true
         pretty = true
@@ -122,8 +125,7 @@
     # themeFontPath = "https://fonts.googleapis.com/css2?family=Inter:wght@200;300;600&display=swap" # external path
     themeFontPath = "/fonts" # local path
     themeFontPreload = "/fonts/inter-v12-latin-regular.woff2"
-    # TODO: adjust purge settings
-    purge = false
+    purge = true
 # toml-docs-end theme-colors
 
 [schema]

exampleSite/config/postcss.config.js

@@ -30,7 +30,7 @@ const purgecss = purgeCSSPlugin({
       './_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/gethinode/mod-simple-datatables/v2/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',

exampleSite/content/en/_index.md

@@ -8,7 +8,7 @@ content_blocks:
       title: Welcome to Hinode!
       content: |-
         A clean documentation and blog theme for your Hugo site based on Bootstrap 5.
-      align: start
+      width: 6
     background:
       color: primary
       subtle: true
@@ -16,12 +16,12 @@ content_blocks:
       image: /img/sunrise.jpg
       ratio: 16x9
     width: 8
-    width: 6
     links:
       - title: About
         url: about
         icon: fas chevron-right
     orientation: horizontal
+    justify: center
 
   - _bookshop_name: articles
     heading:
@@ -33,10 +33,11 @@ content_blocks:
       sort: date
       keywords: featured
     hide-empty: false
+    header-style: none
     more:
       title: More Posts
     padding: 0
-    max: 3
+    limit: 3
     class: border-0 card-zoom card-body-margin
 
   - _bookshop_name: articles
@@ -54,7 +55,7 @@ content_blocks:
       title: More articles
     cols: 1
     padding: 4
-    max: 2
+    limit: 2
     header-style: none
     footer-style: tags
     orientation: horizontal-sm

exampleSite/content/en/blocks/_index.md

@@ -6,18 +6,17 @@ content_blocks:
   - _bookshop_name: hero
     heading:
       title: Content blocks
-      align: start
-    breadcrumb: true
-
-  - _bookshop_name: articles
-    heading:
       content: >-
         Hinode uses [Bookshop](https://github.com/CloudCannon/bookshop) to
         support so-called content blocks. Content blocks are reusable page
         elements, such as a hero, about panel, or an FAQ. Hinode includes
         several ready-to-use blocks. Click on a card for more details about
         a content block, including its frontmatter configuration.
+      align: start
       width: 8
+    breadcrumb: true
+
+  - _bookshop_name: articles
     hide-empty: false
     input:
       section: blocks
@@ -27,7 +26,7 @@ content_blocks:
       title: More Posts
     cols: 3
     padding: 0
-    max: 9
+    limit: 9
     paginate: true
     cover: false
     header-style: none

exampleSite/content/en/blocks/about.md

@@ -25,6 +25,7 @@ The `about` content block renders a short message next to an illustration. You c
     subtle: true
   illustration:
     image: /assets/img/nat-9l98kFByiao-unsplash.jpg
+    ratio: 1x1
   link-type: link
   links:
     - title: First link

exampleSite/content/en/blocks/articles.md

@@ -0,0 +1,44 @@
+---
+_schema: default
+title: Articles
+description: Use the articles content block to show a group of article cards.
+icon: fas grip
+---
+
+## Overview
+
+The `articles` content block renders a group of article cards.
+
+<!-- markdownlint-disable MD037 -->
+{{< example-bookshop lang="bookshop" >}}
+
+```yml
+- _bookshop_name: articles
+  heading:
+    title: Blog
+    align: start
+  input:
+    section: blog
+    reverse: false
+    sort: title
+  hide-empty: false
+  header-style: none
+  more:
+    title: More Blogs
+  padding: 0
+  limit: 3
+  background:
+    color: primary
+    subtle: true
+  class: border-0 card-zoom card-body-margin
+  justify: start
+```
+
+{{< /example-bookshop >}}
+<!-- markdownlint-enable MD037 -->
+
+## Arguments
+
+The content block supports the following arguments:
+
+{{< args bookshop-articles >}}

exampleSite/content/en/blocks/cards.md

@@ -0,0 +1,44 @@
+---
+_schema: default
+title: Cards
+description: Use the cards content block to show a card group of messages.
+icon: fa address-card
+---
+
+## Overview
+
+The `cards` content block renders a group of content cards.
+
+<!-- markdownlint-disable MD037 -->
+{{< example-bookshop lang="bookshop" >}}
+
+```yml
+- _bookshop_name: cards
+  heading:
+    preheading: Preheading
+    title: Heading
+    content: Cards content. It supports multiple lines.
+    align: start
+  background:
+    color: primary
+    subtle: true
+  orientation: stacked
+  icon-rounded: true
+  class: text-center
+  elements:
+    - title: First Card
+      icon: fas 1
+    - title: Second Card
+      icon: fas 2
+    - title: Third Card
+      icon: fas 3
+```
+
+{{< /example-bookshop >}}
+<!-- markdownlint-enable MD037 -->
+
+## Arguments
+
+The content block supports the following arguments:
+
+{{< args bookshop-cards >}}

exampleSite/content/en/blocks/cta.md

@@ -0,0 +1,36 @@
+---
+_schema: default
+title: CTA
+description: Use the CTA content block to display an action link with an optional contact.
+icon: fas address-card
+---
+
+## Overview
+
+The `cta` content block renders a call to action link or button. You can include an optional contact or provide your own illustration. By default, the `cta` uses a generic title and message. Set the `heading` attribute to override these values.
+
+<!-- markdownlint-disable MD037 -->
+{{< example-bookshop lang="bookshop" >}}
+
+```yml
+- _bookshop_name: cta
+  contact: Betty White
+  caption-url: /en/blocks/cta/
+  background:
+    color: primary
+    subtle: true
+  order: first
+  links:
+    - title: Get in touch
+      url: '#!'
+      icon: fas chevron-right
+```
+
+{{< /example-bookshop >}}
+<!-- markdownlint-enable MD037 -->
+
+## Arguments
+
+The content block supports the following arguments:
+
+{{< args bookshop-cta >}}

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

@@ -21,7 +21,7 @@ As an example, the following shortcode displays the full text of an abbreviation
 
 <!-- markdownlint-disable MD037 -->
 {{< example lang="hugo" >}}
-{{</* abbr key="CI/CD" */>}}
+{{</* abbr "CI/CD" */>}}
 {{< /example >}}
 <!-- markdownlint-enable MD037 -->
 
@@ -33,8 +33,9 @@ As an example, the following shortcode displays an accordion with three elements
 {{< example lang="hugo" >}}
 {{</* accordion */>}}
   {{</* accordion-item title="Accordion Item #1" show="true" */>}}
-    This is the first item's accordion body. It supports HTML content, if enabled in the goldmark
-    renderer. The item is shown by adding the value `show` to the `class` argument.
+    This is the first item's accordion body.
+    It supports Markdown content. The item
+    is shown by adding the value `show` to the `class` argument.
   {{</* /accordion-item */>}}
   {{</* accordion-item title="Accordion Item #2" */>}}
     This is the second item's accordion body.
@@ -58,6 +59,16 @@ As an example, the following shortcode displays a simple alert.
 {{< /example >}}
 <!-- markdownlint-enable MD037 -->
 
+## Args
+
+Use the args shortcode to generates a table of structured arguments. The argument definitions are expected to be defined in a data file identified by a provided structure name.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* args "args" */>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
 ## Badge
 
 Use the badge shortcode to display a badge for a heading.
@@ -237,7 +248,7 @@ Use the `file` shortcode to print and highlight the full content of a given inpu
 
 <!-- markdownlint-disable MD037 -->
 {{< example lang="hugo" >}}
-{{</* file file="./config/_default/languages.toml" id="file-collapse-1" */>}}
+{{</* file file="./config/_default/languages.toml" id="file-collapse-1" full=false */>}}
 {{< /example >}}
 <!-- markdownlint-enable MD037 -->
 
@@ -351,14 +362,14 @@ As an example, the following shortcode displays a tab group with vertically alig
 <!-- markdownlint-disable MD037 -->
 {{< example lang="hugo" >}}
   {{</* nav tab-type="pills" vertical="true" */>}}
-    {{</* nav-item title="Nav Item #1" show="true" */>}}
-      This is the first item's nav body. It supports HTML content, if enabled in the goldmark
-      renderer. The item is shown by adding the value `show` to the `class` argument.
+    {{</* nav-item title="Nav Item #1" */>}}
+      This is the first item's nav body. It supports Markdown content.
+      The item is shown by adding the value `show` to the `class` argument.
     {{</* /nav-item */>}}
-    {{</* nav-item title="Nav Item #2" */>}}
+    {{</* nav-item title="Nav Item #2" show="true" */>}}
       This is the second item's nav body.
     {{</* /nav-item */>}}
-    {{</* nav-item title="Nav Item #3" */>}}
+    {{</* nav-item title="Nav Item #3" disabled="true" */>}}
       This is the third item's nav body.
     {{</* /nav-item */>}}
   {{</* /nav */>}}

exampleSite/content/en/blog/components.md

@@ -22,7 +22,7 @@ As an example, the following shortcode shows an animation that plays on hover.
 
 <!-- markdownlint-disable MD037 -->
 {{< example lang="hugo" >}}
-{{</* animation data="gatin.json" auto=false hover=true class="col-6 mx-auto" */>}}
+{{</* animation animation-data="gatin.json" autoplay=false hover=true class="col-6 mx-auto" */>}}
 {{< /example >}}
 <!-- markdownlint-enable MD037 -->
 

exampleSite/content/fr/blog/components.md

@@ -22,7 +22,7 @@ Hinode propose plusieurs shortcodes en plus des [éléments Bootstrap]({{% relre
 
 <!-- markdownlint-disable MD037 -->
 {{< example lang="hugo" >}}
-{{</* animation data="gatin.json" auto=false hover=true class="col-6 mx-auto" */>}}
+{{</* animation animation-data="gatin.json" autoplay=false hover=true class="col-6 mx-auto" */>}}
 {{< /example >}}
 <!-- markdownlint-enable MD037 -->
 

exampleSite/content/nl/blog/components.md

@@ -21,7 +21,7 @@ Het volgende voorbeeld gebruikt een shortcode om een animatie te tonen, die afsp
 
 <!-- markdownlint-disable MD037 -->
 {{< example lang="hugo" >}}
-{{</* animation data="gatin.json" auto=false hover=true class="col-6 mx-auto" */>}}
+{{</* animation animation-data="gatin.json" autoplay=false hover=true class="col-6 mx-auto" */>}}
 {{< /example >}}
 <!-- markdownlint-enable MD037 -->
 

exampleSite/data/contacts.en.yml

@@ -0,0 +1,45 @@
+- name: Alex Smith
+  preferred: Alex
+  image: /assets/img/joseph-gonzalez-iFgRcqHznqg-unsplash.png
+  function: Digital Strategy Lead
+  linkedin: https://www.linkedin.com
+  keywords:
+    - transformation
+  biography: >-
+    Lorem ipsum dolor sit amet, consectetur adipiscing elit. Ut accumsan
+    venenatis dapibus. Proin placerat mauris ac interdum gravida. Proin
+    consequat feugiat sagittis. Sed vel augue nec est auctor semper. Curabitur
+    mauris ante, euismod eu sem in, sagittis porttitor urna. Mauris sodales at
+    quam condimentum malesuada. Vivamus erat augue, euismod nec ligula quis,
+    molestie lobortis ante. Proin venenatis non diam ac interdum.
+
+- name: Betty White
+  preferred: Betty
+  image: /assets/img/jake-nackos-IF9TK5Uy-KI-unsplash.png
+  function: UX Expert
+  linkedin: https://www.linkedin.com
+  keywords:
+    - experience
+  biography: >-
+    Duis rutrum, justo eleifend sagittis facilisis, leo orci hendrerit elit, ac
+    tristique nisl justo non neque. Mauris semper egestas massa, nec dapibus ex
+    tincidunt nec. Quisque lectus quam, finibus sed hendrerit id, accumsan eget
+    sapien. Nam facilisis diam eu felis tempus euismod. Nullam id neque
+    fringilla purus vestibulum mattis elementum vitae lectus. Fusce vel libero
+    consectetur urna egestas molestie eget sit amet elit.
+
+- name: Charles Green
+  preferred: Charles
+  image: /assets/img/foto-sushi-6anudmpILw4-unsplash-1x1.png
+  function: UX Expert
+  linkedin: https://www.linkedin.com
+  keywords:
+    - technology
+    - transformation
+    - experience
+  biography: >-
+    Suspendisse potenti. Aenean elit nisl, viverra eu volutpat at, sodales a sem.
+    Aliquam blandit nunc non mi posuere, quis laoreet ex congue. Donec fringilla
+    porttitor lacus accumsan porttitor. Integer vel sagittis diam. Nullam vehicula
+    fermentum risus nec facilisis. Fusce eleifend gravida orci, in efficitur enim
+    fermentum nec. Sed quis malesuada lorem. Ut vitae sodales sapien.

exampleSite/hinode.work.sum

@@ -7,5 +7,5 @@ github.com/gethinode/mod-cookieyes/v2 v2.0.4 h1:QgYSD3S23351e7xEeQb+Mon+e+I6Rbnn
 github.com/gethinode/mod-cookieyes/v2 v2.0.4/go.mod h1:tULb7D7CoTycGUyL7ryqHJKaX11XuL2SN+XwP7/DI0Y=
 github.com/gethinode/mod-cookieyes/v2 v2.1.2 h1:hzGCbRbpNAVkLr+jFWpAQaXHG0lgK+KgIpaZYsI1J+U=
 github.com/gethinode/mod-cookieyes/v2 v2.1.2/go.mod h1:tULb7D7CoTycGUyL7ryqHJKaX11XuL2SN+XwP7/DI0Y=
-github.com/gethinode/mod-utils/v3 v3.0.2 h1:AewNQYVXy/qoNdqJGG6nKCZXjtXavcZcgdeC1Q6EEnQ=
-github.com/gethinode/mod-utils/v3 v3.0.2/go.mod h1:9iHYWiDpDlcyrGAOHniubK/kziJYhTsw7UpGM+u4MOM=
+github.com/gethinode/mod-utils/v4 v4.4.0 h1:IhhJDLqXCdYvrjM6kUR10wlg0kyZrY94f7EuGMj8NN0=
+github.com/gethinode/mod-utils/v4 v4.4.0/go.mod h1:bYmvRdAo4ICy5MpSGafDvO4p5bTDpsDKFCPL3bH0mN4=

exampleSite/hugo_stats.json

@@ -14,6 +14,7 @@
       "figure",
       "footer",
       "form",
+      "h1",
       "h2",
       "h3",
       "head",
@@ -69,6 +70,7 @@
     ],
     "classes": [
       "%!s(<nil>)",
+      "%!s(MISSING)",
       "about",
       "accordion",
       "accordion-body",
@@ -121,22 +123,25 @@
       "btn-group",
       "btn-light",
       "btn-link",
-      "btn-md",
       "btn-outline-primary",
       "btn-outline-secondary",
       "btn-primary",
       "btn-secondary",
+      "btn-sm",
       "btn-social",
+      "btn-xs",
       "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-icon-primary",
       "card-icon-secondary",
       "card-img-bg",
       "card-img-top",
@@ -144,6 +149,7 @@
       "card-text",
       "card-title",
       "card-zoom",
+      "cards",
       "carousel",
       "carousel-caption",
       "carousel-control-next",
@@ -169,7 +175,7 @@
       "col-lg-2",
       "col-lg-4",
       "col-lg-8",
-      "col-md-",
+      "col-md-10",
       "col-md-12",
       "col-md-2",
       "col-md-3",
@@ -181,14 +187,13 @@
       "col-sm-12",
       "col-sm-3",
       "col-sm-6",
-      "col-sm-9",
-      "col-xl-10",
-      "col-xl-2",
       "collapse",
       "collapsed",
+      "contact-img",
       "container",
       "container-fluid",
       "container-xxl",
+      "cta",
       "custom",
       "d-block",
       "d-flex",
@@ -205,8 +210,10 @@
       "d-sm-block",
       "d-sm-none",
       "data-table",
+      "disabled",
       "display-1",
       "display-4",
+      "display-6",
       "dropdown",
       "dropdown-divider-bg",
       "dropdown-item",
@@ -224,11 +231,13 @@
       "fa-3",
       "fa-4x",
       "fa-activity",
+      "fa-address-card",
       "fa-angle-left",
       "fa-arrow-left",
       "fa-arrow-right",
       "fa-bootstrap",
       "fa-chevron-right",
+      "fa-circle",
       "fa-circle-check",
       "fa-circle-play",
       "fa-circle-question",
@@ -242,10 +251,12 @@
       "fa-fw",
       "fa-github",
       "fa-globe",
+      "fa-grip",
       "fa-h",
       "fa-heart",
       "fa-house",
       "fa-info",
+      "fa-inverse",
       "fa-link",
       "fa-linkedin",
       "fa-magnifying-glass",
@@ -256,6 +267,9 @@
       "fa-share-nodes",
       "fa-sort",
       "fa-square-check",
+      "fa-stack",
+      "fa-stack-1x",
+      "fa-stack-2x",
       "fa-sun",
       "fa-timeline",
       "fa-up-right-from-square",
@@ -271,7 +285,6 @@
       "flex-column",
       "flex-fill",
       "flex-grow-1",
-      "flex-md-grow-0",
       "flex-nowrap",
       "flex-row",
       "font-monospace",
@@ -283,7 +296,6 @@
       "fs-6",
       "fs-lg-5",
       "fs-md-5",
-      "fullscreen",
       "fw-30",
       "fw-bold",
       "fw-semibold",
@@ -319,6 +331,7 @@
       "justify-content-between",
       "justify-content-center",
       "justify-content-end",
+      "justify-content-md-start",
       "justify-content-start",
       "katex",
       "label",
@@ -332,9 +345,10 @@
       "link-warning",
       "lottie-animation",
       "m-0",
+      "m-auto",
       "m-md-n4",
       "m-n1",
-      "main-content",
+      "main",
       "main-nav-toggler",
       "mb-0",
       "mb-3",
@@ -357,6 +371,7 @@
       "mt-auto",
       "mt-md-0",
       "multi-docs-collapse-15",
+      "multi-docs-collapse-16",
       "multi-file-collapse-1",
       "mx-auto",
       "mx-md-0",
@@ -381,7 +396,6 @@
       "navbar-mode-selector",
       "navbar-nav",
       "navbar-nav-scroll",
-      "navbar-title",
       "navbar-toggler",
       "next",
       "no-js",
@@ -399,6 +413,7 @@
       "pb-3",
       "pb-4",
       "pb-5",
+      "pe-0",
       "pe-1",
       "pe-3",
       "pe-5",
@@ -415,21 +430,20 @@
       "pt-4",
       "pt-5",
       "pt-md-0",
-      "pt-md-3",
       "ptw-3",
       "ptw-5",
       "ptw-lg-5",
       "ptw-sm-4",
+      "px-%!d(string=0)",
       "px-2",
       "px-4",
       "px-xxl-0",
+      "py-%!d(string=0)",
       "py-1",
       "py-2",
       "py-3",
       "py-4",
-      "py-5",
       "py-md-1",
-      "py-md-5",
       "ratio",
       "ratio-16x9",
       "releases",
@@ -556,12 +570,15 @@
       "alerte",
       "animatie",
       "animation",
+      "args",
       "arguments",
+      "background-type",
       "badge",
       "barre-de-navigation",
       "block-diagram",
       "blog",
       "body-docs-collapse-15",
+      "body-docs-collapse-16",
       "body-file-collapse-1",
       "bouton",
       "breadcrumb",
@@ -589,9 +606,11 @@
       "data-tables",
       "docs",
       "documentation",
+      "elements-type",
       "entity-relationship-diagram",
       "example",
       "exemple",
+      "fa-address-card",
       "fa-face-frown",
       "fa-square-check",
       "fab-bootstrap",
@@ -602,28 +621,20 @@
       "fab-medium",
       "fab-whatsapp",
       "fab-x-twitter",
-      "faq-184f299e274a5ce56b6a879ad10e2b73",
-      "faq-184f299e274a5ce56b6a879ad10e2b73-heading-faq-184f299e274a5ce56b6a879ad10e2b73",
-      "faq-184f299e274a5ce56b6a879ad10e2b73-item-0",
-      "faq-184f299e274a5ce56b6a879ad10e2b73-item-1",
-      "faq-184f299e274a5ce56b6a879ad10e2b73-item-2",
-      "faq-43ab418abcc6ab8991ad130c40cca21e",
-      "faq-43ab418abcc6ab8991ad130c40cca21e-heading-faq-43ab418abcc6ab8991ad130c40cca21e",
-      "faq-43ab418abcc6ab8991ad130c40cca21e-item-0",
-      "faq-43ab418abcc6ab8991ad130c40cca21e-item-1",
-      "faq-43ab418abcc6ab8991ad130c40cca21e-item-2",
-      "faq-5f13c156f93854db8bafbe22d85efd03",
-      "faq-5f13c156f93854db8bafbe22d85efd03-heading-faq-5f13c156f93854db8bafbe22d85efd03",
-      "faq-5f13c156f93854db8bafbe22d85efd03-item-0",
-      "faq-5f13c156f93854db8bafbe22d85efd03-item-1",
-      "faq-5f13c156f93854db8bafbe22d85efd03-item-2",
+      "faq-9ef13ff2bd73b0e328491bd048c7a1ef",
+      "faq-9ef13ff2bd73b0e328491bd048c7a1ef-heading-faq-9ef13ff2bd73b0e328491bd048c7a1ef",
+      "faq-9ef13ff2bd73b0e328491bd048c7a1ef-item-0",
+      "faq-9ef13ff2bd73b0e328491bd048c7a1ef-item-1",
+      "faq-9ef13ff2bd73b0e328491bd048c7a1ef-item-2",
       "fas-1",
       "fas-2",
       "fas-3",
+      "fas-address-card",
       "fas-angle-left",
       "fas-arrow-left",
       "fas-arrow-right",
       "fas-chevron-right",
+      "fas-circle",
       "fas-circle-check",
       "fas-circle-play",
       "fas-circle-question",
@@ -631,6 +642,7 @@
       "fas-divide",
       "fas-ellipsis",
       "fas-globe",
+      "fas-grip",
       "fas-h",
       "fas-heart",
       "fas-house",
@@ -649,6 +661,7 @@
       "file",
       "flowchart",
       "footer-docs-collapse-15",
+      "footer-docs-collapse-16",
       "footer-file-collapse-1",
       "formula-katex",
       "formule-katex",
@@ -669,7 +682,9 @@
       "imgix",
       "indicateur-de-chargement",
       "infobulle",
+      "input-type",
       "ins",
+      "interested-in-this-topic",
       "invite-de-commandes",
       "items-type",
       "kaart",
@@ -687,20 +702,19 @@
       "mermaid-diagrams",
       "messages-type",
       "mindmap",
+      "more-type",
       "nav",
       "nav-0-0",
       "nav-0-1",
       "nav-0-2",
+      "nav-0-btn-0",
+      "nav-0-btn-1",
+      "nav-0-btn-2",
       "nav-nav-0",
-      "nav-nav-0-btn-0",
-      "nav-nav-0-btn-1",
-      "nav-nav-0-btn-2",
       "navbar",
       "navbar-0-collapse",
       "navbar-mode",
       "navbar-mode-checkbox",
-      "navbar-sample",
-      "navbar-sample-checkbox",
       "navbar-sample-collapse",
       "navigation",
       "notification",

go.mod

@@ -8,16 +8,17 @@ require (
 	github.com/gethinode/mod-bootstrap v1.3.3 // indirect
 	github.com/gethinode/mod-csp v1.0.7 // indirect
 	github.com/gethinode/mod-flexsearch/v2 v2.1.1 // indirect
-	github.com/gethinode/mod-fontawesome v1.10.1 // indirect
-	github.com/gethinode/mod-fontawesome/v2 v2.0.0 // indirect
-	github.com/gethinode/mod-google-analytics v1.3.1 // indirect
+	github.com/gethinode/mod-fontawesome/v2 v2.1.1 // indirect
+	github.com/gethinode/mod-google-analytics v1.3.2 // indirect
 	github.com/gethinode/mod-katex v1.1.3 // indirect
-	github.com/gethinode/mod-leaflet v1.2.1 // indirect
-	github.com/gethinode/mod-lottie v1.5.14 // indirect
+	github.com/gethinode/mod-leaflet v1.3.0 // indirect
+	github.com/gethinode/mod-lottie v1.6.0 // indirect
 	github.com/gethinode/mod-mermaid v1.1.23 // indirect
+	github.com/gethinode/mod-mermaid/v2 v2.0.1 // indirect
 	github.com/gethinode/mod-simple-datatables v1.1.7 // indirect
-	github.com/gethinode/mod-utils/v2 v2.10.0 // indirect
-	github.com/gethinode/mod-utils/v3 v3.1.2 // indirect
+	github.com/gethinode/mod-simple-datatables/v2 v2.0.1 // indirect
+	github.com/gethinode/mod-utils/v3 v3.3.1 // indirect
+	github.com/gethinode/mod-utils/v4 v4.9.2 // indirect
 	github.com/nextapps-de/flexsearch v0.0.0-20250606060143-c28f52c09b7a // indirect
-	github.com/twbs/bootstrap v5.3.6+incompatible // indirect
+	github.com/twbs/bootstrap v5.3.7+incompatible // indirect
 )

go.sum

@@ -156,6 +156,10 @@ github.com/gethinode/mod-fontawesome v1.10.1 h1:gXQ75VXI+a0W2ALkAFHd/QFQ/VoZR6eu
 github.com/gethinode/mod-fontawesome v1.10.1/go.mod h1:xBKsZH3WJtMOItZVlp9SbO51uaBy6IbvUZSKpNu3b6Y=
 github.com/gethinode/mod-fontawesome/v2 v2.0.0 h1:vIcVq4sa68iqYBEei+XBZgWKvT79NXuh+jMS6yVpCV8=
 github.com/gethinode/mod-fontawesome/v2 v2.0.0/go.mod h1:MJghtpjpnbGVzRN+1rH5Fs9Y+eQAawAotGnlemEPb60=
+github.com/gethinode/mod-fontawesome/v2 v2.1.0 h1:kRQ/4ady4Ih/m3bJ/1+/rkFhunuzjNEc4NqIlpNks/o=
+github.com/gethinode/mod-fontawesome/v2 v2.1.0/go.mod h1:Jhwzi3KQI3fYn1hPNPJFCk+kcz80s8ONT4FmwLTXH2c=
+github.com/gethinode/mod-fontawesome/v2 v2.1.1 h1:EieVCvEiT0ulXpEHY4kCLJvZCIvGkupIVyoCRTidrvo=
+github.com/gethinode/mod-fontawesome/v2 v2.1.1/go.mod h1:zukv88wXqquEvTJJ9mWWk8Ia+9INnA41wYqusf2RcHA=
 github.com/gethinode/mod-google-analytics v1.0.0 h1:fly42RQ69bdyJe8WFefsBIo7WMIXkd3wZn32kyAr4h4=
 github.com/gethinode/mod-google-analytics v1.0.0/go.mod h1:dl628cFozpCvoIMCiV7ujzQipjxcm3eatXrSfLPWNII=
 github.com/gethinode/mod-google-analytics v1.0.1 h1:zbmOdnAhhFCA7qWw7fnR46biWhqW2r06sIaTWyhB5R0=
@@ -182,6 +186,8 @@ github.com/gethinode/mod-google-analytics v1.3.0 h1:R9oRB6nbFDwLsNmIhxlcmUVH4JE1
 github.com/gethinode/mod-google-analytics v1.3.0/go.mod h1:dl628cFozpCvoIMCiV7ujzQipjxcm3eatXrSfLPWNII=
 github.com/gethinode/mod-google-analytics v1.3.1 h1:WPXrsO6Kpp0k8PYY9a1JyiZgYGMlkBfHY8eEg6CfcL0=
 github.com/gethinode/mod-google-analytics v1.3.1/go.mod h1:dl628cFozpCvoIMCiV7ujzQipjxcm3eatXrSfLPWNII=
+github.com/gethinode/mod-google-analytics v1.3.2 h1:W4caxWkSor/BFfOEGDDMp+7RajO/Jh1bE7LXxPqLE3A=
+github.com/gethinode/mod-google-analytics v1.3.2/go.mod h1:dl628cFozpCvoIMCiV7ujzQipjxcm3eatXrSfLPWNII=
 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=
@@ -232,6 +238,8 @@ github.com/gethinode/mod-leaflet v1.2.0 h1:5q5LHmGNi9N4cdRDCsl/6oI8vY3oQ2ogNUjP3
 github.com/gethinode/mod-leaflet v1.2.0/go.mod h1:Ei0x9WiL7Dbi4JeG6yI1CE63bT1QJ8sKi67Jea1wFSE=
 github.com/gethinode/mod-leaflet v1.2.1 h1:p0bKi+F5vbXwYknBvFEN9KymK8PRqKaYhVz5O1QPs/c=
 github.com/gethinode/mod-leaflet v1.2.1/go.mod h1:Ei0x9WiL7Dbi4JeG6yI1CE63bT1QJ8sKi67Jea1wFSE=
+github.com/gethinode/mod-leaflet v1.3.0 h1:rRjuuW2KVJjnrBrFIOxxHxkB6RPdmlTivBlvceBG3Fk=
+github.com/gethinode/mod-leaflet v1.3.0/go.mod h1:F/XR1lYKENw91u+IC4NXQT6dbCyJlSJUPClMVpBK8Tw=
 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=
@@ -288,8 +296,12 @@ github.com/gethinode/mod-lottie v1.5.13 h1:Vth/OZDjfBZ9Kz5ew3tXGj9tU6w4StIta6qgf
 github.com/gethinode/mod-lottie v1.5.13/go.mod h1:tMFSUW9z3kC8IvDfs1ph9MGjuZFRBrpCnpodrwY+L4w=
 github.com/gethinode/mod-lottie v1.5.14 h1:17wmpi4XQzmwSB2HKNVa7c6ZzULrRnpKdowOFQQf0m8=
 github.com/gethinode/mod-lottie v1.5.14/go.mod h1:VrjjmrwP/NIrLW7oDQyEAHdbeIRQfbr5BKjgKvI9Al4=
+github.com/gethinode/mod-lottie v1.6.0 h1:O0ld9Q1rBWKb9HzuCuGPBfCegUcIqczMGNW2O/VjVYk=
+github.com/gethinode/mod-lottie v1.6.0/go.mod h1:jZy8EJ6ldLnOXhpzayJ2STZ4hzykqkguFHWpN4aHxMo=
 github.com/gethinode/mod-mermaid v1.1.23 h1:DA5iIdopb7f3wC+bfZ7J5HhcRUuVI/2j1+W/j5L/wwQ=
 github.com/gethinode/mod-mermaid v1.1.23/go.mod h1:rw6vrY9DpdJblwFwLuXCdy2kBHxMf6gGKWeetwfTSfc=
+github.com/gethinode/mod-mermaid/v2 v2.0.1 h1:QcahIFCgmYAGsukQ0d+/L4IJtDwgXgv0WzilZ9poI9o=
+github.com/gethinode/mod-mermaid/v2 v2.0.1/go.mod h1:kp3oUFAjKxuwzFbwxGWPEx5VQOu2ZHzcrwcNhDv08BI=
 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=
@@ -328,6 +340,8 @@ github.com/gethinode/mod-simple-datatables v1.1.6 h1:7nPeRwHlYbmlNEg7fBV6FyXqpxW
 github.com/gethinode/mod-simple-datatables v1.1.6/go.mod h1:bvMdmQFk4Hvyltf/QhMqUaApvPbIGTnbI3JLjOEh8go=
 github.com/gethinode/mod-simple-datatables v1.1.7 h1:wCY2bWFUxRHWbWzb/zefCACooCSbDPYKrZthfn+qAgM=
 github.com/gethinode/mod-simple-datatables v1.1.7/go.mod h1:FjkIEuxqeLLEqqDcz/nHAGHsRfV7EJP5Uhk4kYD8okY=
+github.com/gethinode/mod-simple-datatables/v2 v2.0.1 h1:ZwdI96n8dM2VLwdM/x+Vj7sa4tfiAUnkDj39jn+vkXc=
+github.com/gethinode/mod-simple-datatables/v2 v2.0.1/go.mod h1:mmf1AOxpHdSRQnW2k7ExVWKTyzbG2hpsDRssmyASNb8=
 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=
@@ -412,6 +426,38 @@ github.com/gethinode/mod-utils/v3 v3.1.1 h1:hjC/vnq7NF2Kf18qkpeTHiS14bVrNa55avy0
 github.com/gethinode/mod-utils/v3 v3.1.1/go.mod h1:9iHYWiDpDlcyrGAOHniubK/kziJYhTsw7UpGM+u4MOM=
 github.com/gethinode/mod-utils/v3 v3.1.2 h1:nE1tUkeSTOPxaLRoSiQlODbJhekOJsHrKXte5A2jujg=
 github.com/gethinode/mod-utils/v3 v3.1.2/go.mod h1:9iHYWiDpDlcyrGAOHniubK/kziJYhTsw7UpGM+u4MOM=
+github.com/gethinode/mod-utils/v3 v3.1.3 h1:oIpbIUCpVrWb7Axo1TZODWJ2iA6uYZp4rpx8fC7GIXk=
+github.com/gethinode/mod-utils/v3 v3.1.3/go.mod h1:9iHYWiDpDlcyrGAOHniubK/kziJYhTsw7UpGM+u4MOM=
+github.com/gethinode/mod-utils/v3 v3.2.0 h1:FmRCMAqNvKeQSY+rTy+9lZ65JKkuDA9MTw/HW/HWzSM=
+github.com/gethinode/mod-utils/v3 v3.2.0/go.mod h1:9iHYWiDpDlcyrGAOHniubK/kziJYhTsw7UpGM+u4MOM=
+github.com/gethinode/mod-utils/v3 v3.3.0 h1:qxuIavgL9LIyMhfCv8El+KL41rcNmQ8GaExn142QmLw=
+github.com/gethinode/mod-utils/v3 v3.3.0/go.mod h1:9iHYWiDpDlcyrGAOHniubK/kziJYhTsw7UpGM+u4MOM=
+github.com/gethinode/mod-utils/v3 v3.3.1 h1:0mHrUyIwSkbiQIUuXpnptYDIizkI7Ak39RTgoRMbJfY=
+github.com/gethinode/mod-utils/v3 v3.3.1/go.mod h1:9iHYWiDpDlcyrGAOHniubK/kziJYhTsw7UpGM+u4MOM=
+github.com/gethinode/mod-utils/v4 v4.5.0 h1:p6sDsMNA/KE2IK3SPdWjFX3cPAwPP5gDxzJu2tIWYl4=
+github.com/gethinode/mod-utils/v4 v4.5.0/go.mod h1:bYmvRdAo4ICy5MpSGafDvO4p5bTDpsDKFCPL3bH0mN4=
+github.com/gethinode/mod-utils/v4 v4.5.1 h1:VKmqi6+oC93noHUJ6HvFlelglHT/9+kXQjpJs7VtWko=
+github.com/gethinode/mod-utils/v4 v4.5.1/go.mod h1:bYmvRdAo4ICy5MpSGafDvO4p5bTDpsDKFCPL3bH0mN4=
+github.com/gethinode/mod-utils/v4 v4.6.0 h1:XQ7hiCrn15SzgkcD0j53XVZPQYeQKUxg/UUkr80pJ2w=
+github.com/gethinode/mod-utils/v4 v4.6.0/go.mod h1:bYmvRdAo4ICy5MpSGafDvO4p5bTDpsDKFCPL3bH0mN4=
+github.com/gethinode/mod-utils/v4 v4.7.0 h1:JaL/+APOwdEzAi6y174ZdwoguCdALyGiGX8qBVXXBdU=
+github.com/gethinode/mod-utils/v4 v4.7.0/go.mod h1:bYmvRdAo4ICy5MpSGafDvO4p5bTDpsDKFCPL3bH0mN4=
+github.com/gethinode/mod-utils/v4 v4.8.0 h1:/+M3EHqA8IzgBWXX1GLmT/xKbk2FVhUwmUfMnk/goF4=
+github.com/gethinode/mod-utils/v4 v4.8.0/go.mod h1:bYmvRdAo4ICy5MpSGafDvO4p5bTDpsDKFCPL3bH0mN4=
+github.com/gethinode/mod-utils/v4 v4.8.1 h1:XJULrx5VWO4wR69EsvfPp9bQoRvx8Y7GwnknpDbrDpg=
+github.com/gethinode/mod-utils/v4 v4.8.1/go.mod h1:bYmvRdAo4ICy5MpSGafDvO4p5bTDpsDKFCPL3bH0mN4=
+github.com/gethinode/mod-utils/v4 v4.8.2 h1:mhPmqdeCar2sOdVwKIyJl5la0RVBPtw4d29ncRKN3ek=
+github.com/gethinode/mod-utils/v4 v4.8.2/go.mod h1:bYmvRdAo4ICy5MpSGafDvO4p5bTDpsDKFCPL3bH0mN4=
+github.com/gethinode/mod-utils/v4 v4.8.3 h1:CSaFR/c1cGrSPpH5ZfrNOoMhAbNb8sw0SCRh9ZxCJTU=
+github.com/gethinode/mod-utils/v4 v4.8.3/go.mod h1:bYmvRdAo4ICy5MpSGafDvO4p5bTDpsDKFCPL3bH0mN4=
+github.com/gethinode/mod-utils/v4 v4.8.4 h1:ExD2zZCGonAmbIxC9wBU2dp+V4ZfvG46NWaz+LaV3iQ=
+github.com/gethinode/mod-utils/v4 v4.8.4/go.mod h1:bYmvRdAo4ICy5MpSGafDvO4p5bTDpsDKFCPL3bH0mN4=
+github.com/gethinode/mod-utils/v4 v4.9.0 h1:v7+prGZPETqgI6t/LN0UhrtRKU4mqpJUQu6jEUU5MYg=
+github.com/gethinode/mod-utils/v4 v4.9.0/go.mod h1:bYmvRdAo4ICy5MpSGafDvO4p5bTDpsDKFCPL3bH0mN4=
+github.com/gethinode/mod-utils/v4 v4.9.1 h1:9D2AJcrlS5r2moHEoo70GrNBmq1pJHd9oT4G14DsZRs=
+github.com/gethinode/mod-utils/v4 v4.9.1/go.mod h1:bYmvRdAo4ICy5MpSGafDvO4p5bTDpsDKFCPL3bH0mN4=
+github.com/gethinode/mod-utils/v4 v4.9.2 h1:lzcihwAsm8R2k2v+tWu5nfWvXMA8uRKi0nGIzZCygZ8=
+github.com/gethinode/mod-utils/v4 v4.9.2/go.mod h1:bYmvRdAo4ICy5MpSGafDvO4p5bTDpsDKFCPL3bH0mN4=
 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=
@@ -442,3 +488,5 @@ github.com/twbs/bootstrap v5.3.5+incompatible h1:6XrrFNMsiTTFcVTBf2886FO2XUNtwSE
 github.com/twbs/bootstrap v5.3.5+incompatible/go.mod h1:fZTSrkpSf0/HkL0IIJzvVspTt1r9zuf7XlZau8kpcY0=
 github.com/twbs/bootstrap v5.3.6+incompatible h1:efmXVyq839m5QQ0+JBUdQQ1TrmoBqvQ5kRhUueKsH+4=
 github.com/twbs/bootstrap v5.3.6+incompatible/go.mod h1:fZTSrkpSf0/HkL0IIJzvVspTt1r9zuf7XlZau8kpcY0=
+github.com/twbs/bootstrap v5.3.7+incompatible h1:ea1W8TOWZFkqSK2M0McpgzLiUQVru3bz8aHb0j/XtuM=
+github.com/twbs/bootstrap v5.3.7+incompatible/go.mod h1:fZTSrkpSf0/HkL0IIJzvVspTt1r9zuf7XlZau8kpcY0=

hugo_stats.json

@@ -50,11 +50,9 @@
       "btn-primary",
       "checkbox",
       "col",
-      "col-10",
       "col-12",
       "col-6",
       "col-8",
-      "col-md-",
       "col-md-2",
       "col-md-6",
       "col-md-8",
@@ -78,7 +76,7 @@
       "fa-10x",
       "fa-2x",
       "fa-angle-left",
-      "fa-book-open",
+      "fa-chevron-right",
       "fa-ellipsis",
       "fa-face-frown",
       "fa-fw",
@@ -92,10 +90,10 @@
       "fixed-top",
       "flex-column",
       "flex-fill",
+      "flex-grow-1",
       "footer",
       "form-control",
       "fs-3",
-      "fullscreen",
       "fw-30",
       "fw-bold",
       "h-100",
@@ -111,12 +109,14 @@
       "is-search",
       "justify-content-center",
       "justify-content-end",
+      "justify-content-md-start",
       "justify-content-start",
       "label",
       "lead",
       "link-bg-footer",
       "link-secondary",
-      "main-content",
+      "m-auto",
+      "main",
       "main-nav-toggler",
       "me-auto",
       "middle-bar",
@@ -156,19 +156,15 @@
       "ps-1",
       "pt-1",
       "pt-4",
-      "pt-5",
       "pt-md-0",
-      "pt-md-3",
       "px-4",
       "px-xxl-0",
       "py-3",
       "py-4",
-      "py-md-5",
       "rounded",
       "row",
       "row-cols-1",
       "row-cols-2",
-      "row-cols-md-2",
       "row-cols-sm-3",
       "search",
       "search-input",
@@ -176,6 +172,7 @@
       "section-cover",
       "shadow",
       "svg-inline--fa",
+      "text-",
       "text-body",
       "text-center",
       "text-decoration-none",
@@ -197,7 +194,7 @@
       "fab-linkedin",
       "fab-medium",
       "fas-angle-left",
-      "fas-book-open",
+      "fas-chevron-right",
       "fas-ellipsis",
       "fas-moon",
       "fas-sun",

i18n/en.yaml

@@ -177,3 +177,11 @@
 # Nav & Tab
 - id: clickToExpand
   translation: "Click to expand"
+
+# Contact information
+- id: contactHeaderTopic
+  translation: "Interested in this topic?"
+- id: contactBody
+  translation: "Please leave your contact details so we can get in touch."
+- id: contactAction
+  translation: "Get in touch"

i18n/nl.yaml

@@ -174,3 +174,11 @@
 # Nav & Tab
 - id: clickToExpand
   translation: "Klik om open te klappen"
+
+# Contact information
+- id: contactHeaderTopic
+  translation: "Wil je meer weten over dit onderwerp?"
+- id: contactBody
+  translation: "Laat je gegevens achter en dan neem ik contact met je op."
+- id: contactAction
+  translation: "Neem contact op"

layouts/_partials/assets/adapters/cloudinary.html

@@ -24,6 +24,7 @@
 {{ if or $args.err $args.warnmsg }}
     {{ partial (cond $args.err "utilities/LogErr.html" "utilities/LogWarn.html") (dict 
         "partial" "assets/adapter/cloudinary.html" 
+        "warnid"  "warn-invalid-arguments"
         "msg"     "Invalid arguments"
         "details" ($args.errmsg | append $args.warnmsg)
         "file"    page.File

layouts/_partials/assets/adapters/hugo.html

@@ -11,6 +11,7 @@
 {{ if or $args.err $args.warnmsg }}
     {{ partial (cond $args.err "utilities/LogErr.html" "utilities/LogWarn.html") (dict 
         "partial" "assets/adapter/hugo.html" 
+        "warnid"  "warn-invalid-arguments"
         "msg"     "Invalid arguments"
         "details" ($args.errmsg | append $args.warnmsg)
         "file"    page.File

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

@@ -11,6 +11,7 @@
 {{ if or $args.err $args.warnmsg }}
     {{ partial (cond $args.err "utilities/LogErr.html" "utilities/LogWarn.html") (dict 
         "partial" "assets/adapter/imagekit-rewrite.html" 
+        "warnid"  "warn-invalid-arguments"
         "msg"     "Invalid arguments"
         "details" ($args.errmsg | append $args.warnmsg)
         "file"    page.File

layouts/_partials/assets/adapters/imagekit.html

@@ -24,6 +24,7 @@
 {{ if or $args.err $args.warnmsg }}
     {{ partial (cond $args.err "utilities/LogErr.html" "utilities/LogWarn.html") (dict 
         "partial" "assets/adapter/imagekit.html" 
+        "warnid"  "warn-invalid-arguments"
         "msg"    "Invalid arguments"
         "details" ($args.errmsg | append $args.warnmsg)
         "file"    page.File

layouts/_partials/assets/adapters/imgix.html

@@ -22,6 +22,7 @@
 {{ if or $args.err $args.warnmsg }}
     {{ partial (cond $args.err "utilities/LogErr.html" "utilities/LogWarn.html") (dict 
         "partial" "assets/adapter/imgix.html" 
+        "warnid"  "warn-invalid-arguments"
         "msg"     "Invalid arguments"
         "details" ($args.errmsg | append $args.warnmsg)
         "file"    page.File

layouts/_partials/assets/args.html

@@ -0,0 +1,134 @@
+{{/* 
+    Copyright © 2022 - 2025 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 }}
+
+{{ define "_partials/inline/args-table.html"}}
+    {{ $args := .args }}
+    {{ $types := .types }}
+    {{ $page := .page }}
+    {{ $group := .group | default "" }}
+    {{ $parent := .parent }}
+    {{ $reflect := "" }}
+    
+    {{ $table := printf "| %s | %s | %s | %s | %s |\n| --- | --- | --- | --- | --- |" 
+        (T "name") (T "type") (T "required") (T "default") (T "comment") 
+    }}
+
+    {{ range $key, $val := $args }}
+        {{ if eq $key "_reflect" }}
+            {{ $reflect = $val }}
+            {{ continue }}
+        {{ end }}
+        {{ $skip := false }}
+        {{ $groups := slice }}
+        {{ if $val }} {{ $groups = $groups | append $val.group }}{{ end }}
+        {{ if and $group $val.group }}
+            {{ $skip = not (in $groups $group )}}
+        {{ end }}
+        {{ if $parent }}{{ $skip = not (in (slice "cascade" "merge") $val.parent) }}{{ end }}
+    
+        {{ if not $skip }}
+            {{ $type := $val.type }}
+            {{ $udt := false }}
+            {{ $slice := false }}
+            {{ if reflect.IsSlice $val.type }}{{ $type = delimit $val.type ", " }}{{ end }}
+            {{ with index $types $val.type }}
+                {{ $udt = true }}
+                {{ $slice = eq ._reflect "[]interface {}" }}
+            {{ end }}
+            {{ $required := "" }}
+            {{ if not $val.optional }}{{ $required = "yes" }}{{ end }}
+
+            {{ $comment := $val.comment }}
+            {{ if $val.deprecated }}
+                {{ $btn := printf `{{< release version="%s" short="true" button-size="xs" inline="true" release-state="deprecated" >}}` $val.deprecated }}
+                {{ with $val.alternative }}
+                    {{ $comment = printf "%s **%s**. %s" $btn (T "alternativeFeature" .) $comment }}
+                {{ else }}
+                    {{ $comment = printf "%s %s" $btn $comment }}
+                {{ end }}
+            {{ end }}
+            {{ if $val.release }}
+                {{ $comment = printf `{{< release version="%s" short="true" button-size="xs" inline="true" >}} %s` $val.release $comment }}
+            {{ end }}
+
+            {{ $min := "" }}
+            {{ $max := "" }}
+            {{ if and $val.options.values (eq $type "select") }}
+                {{ $comment = printf "%s %s: [`%s`]." $comment (T "supportedValues") (delimit $val.options.values "`, `") }}
+            {{ else if in (slice "int" "float" "float64") $type }}
+                {{ if eq (printf "%T" $val.options.min) "int" }}{{ $min = int $val.options.min }}{{ end }}
+                {{ if eq (printf "%T" $val.options.max) "int" }}{{ $max = int $val.options.max }}{{ end }}
+            {{ end }}
+            {{ if and (eq (printf "%T" $min) "int") (eq (printf "%T" $max) "int") }}
+                {{ $comment = printf "%s %s: [`%d - %d`]." $comment (T "supportedValues") $min $max }}
+            {{ else if (eq (printf "%T" $min) "int") }}
+                {{ $comment = printf "%s %s: `>=%d`." $comment (T "supportedValues") $min }}
+            {{ else if (eq (printf "%T" $max) "int") }}
+                {{ $comment = printf "%s %s: `<=%d`." $comment (T "supportedValues") $max }}
+            {{ end }}
+
+            {{ $default := "" }}
+            {{ with $val.default }}{{ $default = printf "`%v`" . }}{{ end }}
+            {{ if $udt }}{{ $type = printf "[%s](#%s)" $type (anchorize (printf "%s %s" $type (T "type"))) }}{{ end }}
+            {{ if $slice }}{{ $type = printf "[]%s" $type }}{{ end }}
+            {{ $table = printf "%s\n| %s | %s | %s | %s | %s |" $table $key $type $required $default $comment }}
+        {{ end }}
+    {{ end }}
+
+    {{ return partial "assets/table.html" (dict "page" $page "input" $table "wrap" true) }}
+{{ end }}
+
+{{/* Initialize arguments */}}
+{{- $args := partial "utilities/InitArgs.html" (dict "structure" "args" "args" . "group" "partial") -}}
+{{- if or $args.err $args.warnmsg -}}
+    {{- partial (cond $args.err "utilities/LogErr.html" "utilities/LogWarn.html") (dict 
+        "partial" "assets/args.html" 
+        "warnid"  "warn-invalid-arguments"
+        "msg"     "Invalid arguments"
+        "details" ($args.errmsg | append $args.warnmsg)
+        "file"    page.File
+    ) -}}
+    {{- $error = $args.err -}}
+{{- end -}}
+
+{{/* Initialize type structure */}}
+{{ $structure := $args.structure }}
+{{ $bookshop := "" }}
+{{ if hasPrefix $structure "bookshop-" }}{{ $bookshop = strings.TrimPrefix "bookshop-" $structure }}{{ $structure = "" }}{{ end }}
+{{ $types := dict }}
+{{ if not $error }}
+    {{ $types = partial "utilities/InitTypes.html" (dict "structure" $structure "bookshop" $bookshop) }}
+    {{ if or $types.err $types.warnmsg }}
+        {{ partial (cond $args.err "utilities/LogErr.html" "utilities/LogWarn.html") (dict 
+            "partial" "assets/args.html"
+            "warnid"  "warn-invalid-arguments"
+            "msg"     "Invalid arguments"
+            "details" ($types.errmsg | append $types.warnmsg)
+            "file"    page.File
+        )}}
+        {{ $error = $args.err }}
+    {{ end }}
+{{ end }}
+
+{{/* Main code */}}
+{{ if not $error }}
+    {{ $params := dict "types" $types.udt "page" $args.page "group" $args.group "parent" $args.parent }}
+    {{ if in (slice "arguments" "both") $args.renderType }}
+        {{ partial "inline/args-table.html" (merge $params (dict "args" $types.types)) }}
+    {{ end }}
+
+    {{ if in (slice "types" "both") $args.renderType }}
+        {{ $prefix := strings.Repeat $args.headerLevel "#" }}
+        {{ range $k, $v := $types.udt }}
+            {{ $title := $k }}
+            {{ if site.Params.main.titleCase }}{{ $title = title $title }}{{ end }}
+            {{ printf "%s %s %s" $prefix $title (T "type") | $args.page.RenderString }}
+            {{ partial "inline/args-table.html" (merge $params (dict "args" $v)) }}
+        {{ end }}
+    {{ end }}
+{{ end }}

layouts/_partials/assets/breadcrumb.html

@@ -21,6 +21,7 @@
 {{ if or $args.err $args.warnmsg }}
     {{ partial (cond $args.err "utilities/LogErr.html" "utilities/LogWarn.html") (dict 
         "partial" "assets/breadcrumb.html" 
+        "warnid"  "warn-invalid-arguments"
         "msg"     "Invalid arguments"
         "details" ($args.errmsg | append $args.warnmsg)
         "file"    page.File

layouts/_partials/assets/button.html

@@ -11,6 +11,7 @@
 {{ if or $args.err $args.warnmsg }}
     {{ partial (cond $args.err "utilities/LogErr.html" "utilities/LogWarn.html") (dict 
         "partial" "assets/button.html" 
+        "warnid"  "warn-invalid-arguments"
         "msg"     "Invalid arguments"
         "details" ($args.errmsg | append $args.warnmsg)
         "file"    page.File
@@ -32,8 +33,7 @@
     {{- with $args.tooltip }}{{ $tooltip = . }}{{ end -}}
 {{- end -}}
 
-{{- $href := .href -}}
-
+{{- $href := $args.href -}}
 {{ $linkType := or $args.linkType $args.type }}
 {{ $buttonSize := or $args.buttonSize $args.size }}
 {{ $toastID := or $args.toastId $args.toast }}
@@ -73,13 +73,21 @@
 
 {{/* Main code */}}
 {{ if not $error }}
+    {{- $btnClass := "" -}}
+    {{- if eq $linkType "button" }}
+        {{- $btnClass = printf "btn btn-%s%s" (cond $args.outline "outline-" "") $args.color -}}
+        {{- if ne $buttonSize "md" }}{{ $btnClass = printf "%s btn-%s" $btnClass $buttonSize }}{{ end -}}
+        {{- if in (slice "disabled" "active") $state }}{{ $btnClass = printf "%s %s" $btnClass $state }}{{ end -}}
+        {{- $btnClass = printf "%s position-relative %s" $btnClass $class }}
+    {{- end -}}        
+
     <a aria-label="{{ (or $label $title) | safeHTML }}"
         {{ if ne $state "disabled" }}{{ with $href }}href="{{ . }}"{{ end }}{{ end -}}
         {{- with $args.id }} id="{{ . }}"{{ end -}}
         {{- with $target }} target="{{ . }}"{{ end }}{{ with $rel }} rel="{{ . }}"{{ end -}}
         {{- with $toastID }} data-toast-target="{{ . }}"{{ end -}}
         {{- with $args.clipboard }} data-clipboard="{{ . }}"{{ end -}}
-        {{- if eq $linkType "button" }} class="btn btn-{{ if $args.outline }}outline-{{ end }}{{ $args.color }} {{ if ne $buttonSize "md" }}btn-{{ $args.size }}{{ end }} position-relative {{ if in (slice "disabled" "active") $args.state }}{{ $args.state }}{{ end }} {{ $class -}}"
+        {{- with $btnClass }} class="{{ . }}"
         {{ if eq $state "disabled" }}aria-disabled="true"{{ end -}}
         {{- else }} class="btn btn-link link-{{ $args.color }} position-relative {{ $class }}"{{ end -}}
         {{- with $tooltip }} data-bs-toggle="tooltip" data-bs-title="{{ . }}" data-bs-placement="{{ $args.placement }}"{{ end -}}

layouts/_partials/assets/card-group.html

@@ -21,6 +21,7 @@
 {{- if or $args.err $args.warnmsg -}}
     {{- partial (cond $args.err "utilities/LogErr.html" "utilities/LogWarn.html") (dict 
         "partial" "assets/card-group.html" 
+        "warnid"  "warn-invalid-arguments"
         "msg"     "Invalid arguments"
         "details" ($args.errmsg | append $args.warnmsg)
         "file"    page.File
@@ -29,6 +30,8 @@
 {{- end -}}
 
 {{/* Initialize global variables */}}
+{{- $breakpoint := partial "utilities/GetBreakpoint.html" -}}
+{{- $padding := partial "utilities/GetPadding.html" -}}
 {{- $pretty := site.Params.main.internalLinks.pretty | default false -}}
 
 {{/* Initialize local variables */}}
@@ -110,7 +113,7 @@
 {{/* Limit list to max elements */}}
 {{- $count := len $elements -}}
 {{- $max := $count -}}
-{{- $max = math.Min ($args.max | default $count) $count -}}
+{{- $max = math.Min ((or $args.limit $args.max) | default $count) $count -}}
 {{- if not $args.paginate -}}
     {{- $elements = first $max $elements -}}
 {{- end -}}
@@ -135,8 +138,7 @@
 
 {{/* Main code */}}
 {{- if and (not $error) (or (gt (len $elements) 0) $args.cards) -}}
-<div class="{{- $args.wrapper -}}">
-    <div class="container-fluid {{ if $args.scroll }}card-container-wrapper{{ end }} p-0">
+    <div class="container-fluid {{ if $args.scroll }}card-container-wrapper{{ end }} p-0 {{ $args.wrapper }}">
         <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 }}">
@@ -186,7 +188,7 @@
 
     {{- if $paginator -}}
         {{- if gt $paginator.TotalPages 1 -}}
-            <div class="pt-3">{{- partial "assets/pagination.html" (dict "page" $args.page "format" "terse") -}}</div>
+            <div class="pt-{{ $padding.y }}">{{- partial "assets/pagination.html" (dict "page" $args.page "format" "terse") -}}</div>
         {{- end -}} 
     {{- else -}}
         {{- if or (and (gt $count $max) $args.hrefTitle) (and $args.hrefForce  $args.hrefTitle) -}}
@@ -194,8 +196,11 @@
             {{- if and $pretty (not (hasSuffix $href "/" )) (not (strings.Contains $href "#")) -}}
                 {{- $href = printf "%s/" $href -}}
             {{- end -}}
-            <a class="btn btn-outline-primary mt-4" href="{{ $href | safeURL }}" role="button">{{ $args.hrefTitle }}</a>
-        {{- end -}}
-    {{- end -}}
+            <div class="mt-{{ $padding.y }} w-100">
+                <a class="btn btn-outline-primary" href="{{ $href | safeURL }}" role="button">
+                    {{ $args.hrefTitle }}
+                </a>
             </div>
         {{- end -}}
+    {{- end -}}
+{{- end -}}

layouts/_partials/assets/card.html

@@ -62,11 +62,15 @@
     </small></p>
 {{- end -}}
 
-{{/* Initialize arguments */}}
+{{/* Initialize global variables */}}
+{{- $padding := partial "utilities/GetPadding.html" -}}
+
+{{/* Initialize local arguments */}}
 {{ $args := partial "utilities/InitArgs.html" (dict "structure" "card" "args" . "group" "partial") }}
 {{ if or $args.err $args.warnmsg }}
     {{ partial (cond $args.err "utilities/LogErr.html" "utilities/LogWarn.html") (dict 
         "partial" "assets/card.html" 
+        "warnid"  "warn-invalid-arguments"
         "msg"     "Invalid arguments"
         "details" ($args.errmsg | append $args.warnmsg)
         "file"    page.File
@@ -147,19 +151,19 @@
     {{ if $thumbnail }}
         {{ if eq $args.orientation "horizontal-sm" }}
             {{ $stack = "fa-1x" }}
-            {{ $col1 = "col-4 col-md-2" }}
+            {{ $col1 = "col-4 col-md-2 pe-0" }}
             {{ $col2 = "col-8 col-md-10" }}
         {{ else }}
-            {{ $col1 = "col-4" }}
+            {{ $col1 = "col-4 pe-0" }}
             {{ $col2 = "col-8" }}
         {{ end }}
     {{ else if $icon }}
         {{ if eq $args.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" }}
+            {{ $col1 = "col-4 col-md-2 pe-0" }}
+            {{ $col2 = "col-8 col-md-10" }}
         {{ else }}
-            {{ $col1 = "col-4" }}
+            {{ $col1 = "col-4 pe-0" }}
             {{ $col2 = "col-8" }}
         {{ end }}
 
@@ -167,7 +171,7 @@
 
     {{/* Render horizontal card */}}
     <div class="card {{ $colorStyle }}{{ $args.class }}">
-        <div class="row g-0 row-cols-2 h-100{{ if $args.button }} pb-5{{ end }}">
+        <div class="row g-0 row-cols-2 h-100{{ if $args.button }} pb-{{ $padding.y }}{{ end }}">
             {{- if $thumbnail -}}
                 <div class="{{ $col1 }}">
                     {{ $fullHeight := "card-img-h100" }}
@@ -175,7 +179,7 @@
                     {{ if eq (lower (path.Ext $thumbnail)) ".svg" }}{{ $fullHeight = "" }}{{ $rounding = "" }}{{ end }}
                     {{- partial $args.hook (dict 
                         "src"      $thumbnail
-                        "ratio"    (or $ratio "1x1")
+                        "ratio"    (or $ratio "auto")
                         "portrait" $args.portrait
                         "sizes"    $args.sizes
                         "anchor"   $anchor
@@ -199,9 +203,22 @@
             {{- end -}}
             <div class="{{ $col2 }}">
                 <div class="card-body d-flex p-{{ $args.padding }} flex-column h-100 flex-fill">
-                    {{ if $page }}<div>{{ partial "inline/card-caption.html" (dict "page" $page "keywords" $args.headerStyle "color" $args.color) }}</div>{{ end }}
+                    {{ if $page }}
+                        <div>{{ partial "inline/card-caption.html" (dict
+                            "page"     $page
+                            "keywords" $args.headerStyle
+                            "color"    $args.color
+                            ) }}
+                        </div>
+                    {{ end }}
                     <div class="flex-fill">
-                        {{- partial "inline/card-body.html" (dict "title" $title "href" $href "color" $args.color "description" $description "button" $args.button) -}}
+                        {{- partial "inline/card-body.html" (dict
+                            "title"       $title
+                            "href"        $href
+                            "color"       $args.color
+                            "description" $description
+                            "button"      $args.button
+                        ) -}}
                     </div>
                     {{ if $page }}<div>{{ partial "inline/card-caption.html" (dict "page" $page "keywords" $args.footerStyle "color" $args.color) }}</div>{{ end }}
                     {{ if and $href $args.button }}

layouts/_partials/assets/carousel-item.html

@@ -9,6 +9,7 @@
 {{ if or $args.err $args.warnmsg }}
     {{ partial (cond $args.err "utilities/LogErr.html" "utilities/LogWarn.html") (dict 
         "partial" "assets/carousel-item.html" 
+        "warnid"  "warn-invalid-arguments"
         "msg"     "Invalid arguments"
         "details" ($args.errmsg | append $args.warnmsg)
         "file"    page.File

layouts/_partials/assets/contact.html

@@ -0,0 +1,66 @@
+{{/* 
+    Copyright © 2024 - 2025 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.
+*/}}
+
+{{/* Initialize arguments */}}
+{{ $args := partial "utilities/InitArgs.html" (dict "structure" "contact" "args" . "group" "partial") }}
+{{ if or $args.err $args.warnmsg }}
+    {{ partial (cond $args.err "utilities/LogErr.html" "utilities/LogWarn.html") (dict 
+        "partial" "assets/contact.html" 
+        "warnid"  "warn-invalid-arguments"
+        "msg"     "Invalid arguments"
+        "details" ($args.errmsg | append $args.warnmsg)
+        "file"    page.File
+    )}}
+{{ end }}
+
+{{/* Main code */}}
+{{ if not $args.err }}
+    {{ $contact := partial "utilities/GetContact" (dict
+        "contact"      $args.contact
+        "data"         $args.data
+        "language-tag" site.Language.Lang
+    ) }}
+
+    {{ $illustration := dict }}
+    {{ if and $contact $contact.image }}
+        {{ $illustration = dict
+            "image"       $contact.image
+            "ratio"       "1x1"
+            "class"       $args.class
+            "caption"     $contact.name 
+            "caption-url" $args.captionUrl
+        }}
+    {{ else if $args.illustration }}
+        {{ $illustration = $args.illustration }}
+    {{ end }}
+
+    {{ $heading := "" }}
+    {{ if and (not $args.heading.title) (not $args.heading.content) }}
+        {{ $heading = dict
+            "title"     (T "contactHeaderTopic")
+            "content"   (T "contactBody")
+            "align"     "start"
+            "width"     (cond $illustration.image 10 12)
+        }}
+    {{ else }}
+        {{ $heading = $args.heading }}
+    {{ end }}
+
+    {{ partial "assets/hero.html"  (dict
+        "page"         $args.page
+        "heading"      $heading
+        "background"   $args.background
+        "illustration" $illustration 
+        "order"        $args.order
+        "link-type"    $args.linkType
+        "links"        $args.links
+        "orientation"  $args.orientation
+        "width"        (or $args.width 12)
+        "use-title"    true
+        "size"         6
+        )
+    }}
+{{ end }}

layouts/_partials/assets/download.html

@@ -11,6 +11,7 @@
 {{ if or $args.err $args.warnmsg }}
     {{ partial (cond $args.err "utilities/LogErr.html" "utilities/LogWarn.html") (dict 
         "partial" "assets/download.html" 
+        "warnid"  "warn-invalid-arguments"
         "msg"     "Invalid arguments"
         "details" ($args.errmsg | append $args.warnmsg)
         "file"    page.File

layouts/_partials/assets/featured-illustration.html

@@ -11,6 +11,7 @@
 {{ if or $args.err $args.warnmsg }}
     {{ partial (cond $args.err "utilities/LogErr.html" "utilities/LogWarn.html") (dict 
         "partial" "assets/featured-illustration.html" 
+        "warnid"  "warn-invalid-arguments"
         "msg"     "Invalid arguments"
         "details" ($args.errmsg | append $args.warnmsg)
         "file"    page.File

layouts/_partials/assets/helpers/GetDimension.html

@@ -11,6 +11,7 @@
 {{ if or $args.err $args.warnmsg }}
     {{ partial (cond $args.err "utilities/LogErr.html" "utilities/LogWarn.html") (dict 
         "partial" "assets/helpers/get-dimension.html" 
+        "warnid"  "warn-invalid-arguments"
         "msg"     "Invalid arguments"
         "details" ($args.errmsg | append $args.warnmsg)
         "file"    page.File
@@ -19,9 +20,10 @@
 {{ end }}
 
 {{/* Initialize local arguments */}}
-{{ $dim := "" }}
+{{ $dim := slice }}
 {{ $default := dict "4x3" "1400x1050" "3x2" "1400x933" "1x1" "1400x1400" "16x9" "1400x788" "21x9" "1400x600" "auto" "1400" }}
 
+{{ if not $args.err }}
     {{/* Initialize dimensions data - stripping unsupported file extension */}}
     {{ $config := "dimensions" }}
     {{ with index site.Params "dam" }}{{ with index . "dimensions" }}{{ $config = . }}{{ end }}{{ end }}
@@ -35,5 +37,6 @@
     {{ end }}
 
     {{ if not $dim }}{{ $dim = slice (index $default $args.ratio) }}{{ end }}
+{{ end }}
 
 {{ return $dim }}

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

@@ -11,6 +11,7 @@
 {{- if or $args.err $args.warnmsg -}}
     {{- partial (cond $args.err "utilities/LogErr.html" "utilities/LogWarn.html") (dict 
         "partial" "assets/helpers/image-definition.html" 
+        "warnid"  "warn-invalid-arguments"
         "msg"     "Invalid arguments"
         "details" ($args.errmsg | append $args.warnmsg)
         "file"    page.File
@@ -50,6 +51,17 @@
 {{- $width := index $target "width" -}}
 {{- $data := index $target "data" -}}
 
+{{ if and $args.imageWidth $args.imageHeight }}
+    {{ $height = $args.imageHeight }}
+    {{ $width = $args.imageWidth }}
+{{ else if and $args.imageWidth $height $width }}
+    {{ $height = int (math.Round (mul (div (float $args.imageWidth) $width) $height)) }}
+    {{ $width = $args.imageWidth }}
+{{ else if and $args.imageHeight $height $width }}
+    {{ $width = int (math.Round (mul (div (float $args.imageHeight) $height) $width)) }}
+    {{ $height = $args.imageHeight }}
+{{ end }}
+
 {{/* Add color modes */}}
 {{- range $none := $modes -}}
     {{- if ne $none $args.colorMode -}}
@@ -80,7 +92,12 @@
             {{ with $width }} width="{{ . }}"{{ end -}}
             {{ with $alt }} alt="{{ . }}"{{ end }}>
     {{- else -}}
-        <svg class="{{ $args.class }}">
+        <svg class="{{ $args.class }}"
+        {{ if or $args.imageHeight $args.imageWidth }}
+            {{ with $width }} width="{{ . }}"{{ end }}
+            {{ with $height }} height="{{ . }}"{{ end }}
+        {{ end }}
+        >
             <use href="{{ $fallbackURL }}#{{ $fileAnchor }}"></use>
         </svg>
     {{- end -}}

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

@@ -11,6 +11,7 @@
 {{ if or $args.err $args.warnmsg }}
     {{ partial (cond $args.err "utilities/LogErr.html" "utilities/LogWarn.html") (dict 
         "partial" "assets/helpers/image-dimension.html" 
+        "warnid"  "warn-invalid-arguments"
         "msg"     "Invalid arguments"
         "details" ($args.errmsg | append $args.warnmsg)
         "file"    page.File
@@ -82,7 +83,7 @@
     {{ else }}
         {{ warnf "Unsupported media type '%s': %q" (string $res.MediaType) $src -}}
     {{ end }}
-{{ else if $args.ratio }}
+{{ else if and $args.ratio (ne $args.ratio "auto") }}
     {{ $transform = "fill" }}
     {{ $dims = partial "assets/helpers/GetDimension.html" (dict "ratio" $args.ratio) }}
     {{ if not $dims }}{{ errorf "partial [assets/image.html] - Cannot find dimension data: %s" $args.ratio }}{{ end }}
@@ -153,6 +154,7 @@
             "anchor"        $args.anchor
             "transform"     $transform
             "hook"          $hook
+            "include-width" true
         ) -}}
     {{ end }}
 {{ end }}

layouts/_partials/assets/helpers/image-rewrite.html

@@ -11,6 +11,7 @@
 {{ if or $args.err $args.warnmsg }}
     {{ partial (cond $args.err "utilities/LogErr.html" "utilities/LogWarn.html") (dict 
         "partial" "assets/helpers/image-rewrite.html" 
+        "warnid"  "warn-invalid-arguments"
         "msg"     "Invalid arguments"
         "details" ($args.errmsg | append $args.warnmsg)
         "file"    page.File

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

@@ -9,6 +9,7 @@
 {{ if or $args.err $args.warnmsg }}
     {{ partial (cond $args.err "utilities/LogErr.html" "utilities/LogWarn.html") (dict 
         "partial" "assets/helpers/image-set.html" 
+        "warnid"  "warn-invalid-arguments"
         "msg"     "Invalid arguments"
         "details" ($args.errmsg | append $args.warnmsg)
         "file"    page.File