Merge pull request #558 from gethinode/develop

Refine featured partial

.github/release.yml

@@ -14,7 +14,7 @@ changelog:
       labels:
         - Semver-Minor
         - enhancement
-    - title: 🐛 Bug fixes
+    - title: 🐛 Bug Fixes
       labels:
         - fix
         - bugfix

.github/workflows/lint-build.yml

@@ -43,7 +43,7 @@ jobs:
       matrix:
         os: [macos-latest, windows-latest, ubuntu-latest]
         # See supported Node.js release schedule at https://nodejs.org/en/about/releases/
-        node-version: [16.x, 18.x, 20.x]
+        node-version: [18.x, 20.x]
 
     runs-on: ${{ matrix.os }}
 
@@ -58,6 +58,17 @@ jobs:
         cache: 'npm'
         cache-dependency-path: '**/package-lock.json'
 
+    - name: Install Dart Sass
+      run:  |
+        if [ "$RUNNER_OS" == "Linux" ]; then
+          sudo snap install dart-sass
+        elif [ "$RUNNER_OS" == "macOS" ]; then
+          brew install sass/sass/sass
+        elif [ "$RUNNER_OS" == "Windows" ]; then
+          choco install sass
+        fi
+      shell: bash
+
     # [24/AUG/23] Adjusted from npm ci for non-macOS to prevent EBADPLATFORM error due to fsevents
     - name: Perform clean install of npm
       run:  |

.github/workflows/npm-publish.yml

@@ -31,8 +31,9 @@ jobs:
           cache: 'npm'
           cache-dependency-path: '**/package-lock.json'
   
-      - name: Perform clean install of npm
-        run: npm ci
+      # [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

.stylelintignore

@@ -3,5 +3,6 @@ assets/scss/components/_syntax-dark.scss
 assets/scss/components/_syntax-light.scss
 assets/scss/vendor
 assets/scss/theme/fonts.scss
+assets/scss/app-dart.scss
 assets/scss/app.scss
 node_modules

assets/scss/app-dart.scss

@@ -0,0 +1,56 @@
+@use "sass:meta";
+
+// Define template variables
+@use "hugo:vars" as h; // note: modified for dart-sass
+
+// Include default variable overrides
+@import "common/variables-dart.scss"; // note: modified for dart-sass
+@import "common/icons.scss";
+
+// Import Bootstrap configuration (mounted by core Bootstrap module)
+@import "bootstrap-dart.scss"; // note: modified for dart-sass
+
+// Include dark mode overrides
+@import "common/variables-dark.scss";
+
+// Import Hinode theme styles
+@import "components/alert.scss";
+@import "components/blockquote.scss";
+@import "components/breadcrumb.scss";
+@import "components/buttons.scss";
+@import "components/card.scss";
+@import "components/carousel.scss";
+@import "components/clipboard.scss";
+@import "components/command.scss";
+@import "components/comments.scss";
+@import "components/feature.scss";
+@import "components/footer.scss";
+@import "components/navbar.scss";
+@import "components/img.scss";
+@import "components/pagination.scss";
+@import "components/persona.scss";
+@import "components/popover.scss";
+@import "components/sidebar.scss";
+@import "components/syntax-dart.scss"; // note: modified for dart-sass
+@import "components/table.scss";
+@import "components/timeline.scss";
+@import "components/toc.scss";
+@import "components/vimeo.scss";
+@import "common/animation.scss";
+@import "common/styles.scss";
+@import "layouts/reboot.scss";
+@import "layouts/type.scss";
+@import "common/export.scss";
+@import "helpers/colored-links.scss";
+@import "helpers/display.scss";
+
+// note: modified for dart-sass
+@if h.$import-fonts {
+    @include meta.load-css(theme/fonts);
+}
+
+// Import theme placeholder
+@import "theme/theme.scss";
+
+// Import Bootstrap utilities API  (mounted by core Bootstrap module)
+@import "modules/bootstrap/utilities/api";

assets/scss/app.scss

@@ -30,6 +30,7 @@
 @import "components/popover.scss";
 @import "components/sidebar.scss";
 @import "components/syntax.scss";
+@import "components/table.scss";
 @import "components/timeline.scss";
 @import "components/toc.scss";
 @import "components/vimeo.scss";

assets/scss/common/_styles.scss

@@ -15,6 +15,28 @@ a:active {
     min-height: 100vh;
 }
 
+.fullscreen {
+    --navbar-offset: #{$navbar-offset};
+
+    min-height: calc(100vh - var(--navbar-offset));
+}
+
+.main-content {
+    margin-top: $navbar-offset;
+}
+
+$utilities: map-merge(
+  $utilities,
+  (
+    "cursor": (
+      property: margin-left margin-right,
+      class: mx,
+      responsive: true,
+      values: auto 0,
+    )
+  )
+);
+
 .tickmark li::marker {
     content: "✓ ";
 }

assets/scss/common/_variables-dart.scss

@@ -0,0 +1,42 @@
+// Bootstrap variables overrides for theme
+$enable-negative-margins:       true;
+$enable-important-utilities:    true !default;
+
+// Remove the border from the focused navigation toggler
+$navbar-toggler-focus-width:    0 !default;
+
+$font-family-sans-serif:        h.$theme-font, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji" !default;
+$font-size-base:                h.$font-size-base !default;
+$headings-font-weight:          600 !default;
+$font-weight-lighter:           lighter !default;
+$font-weight-light:             200 !default;
+$font-weight-normal:            300 !default;
+$font-weight-bold:              600 !default;
+$font-weight-bolder:            bolder !default;
+
+strong {
+    font-weight:                600 if($enable-important-utilities, !important, null);
+}
+
+$navbar-offset:                 h.$navbar-offset;
+$primary:                       h.$primary;
+$secondary:                     h.$secondary;
+$success:                       h.$success;
+$info:                          h.$info;
+$warning:                       h.$warning;
+$danger:                        h.$danger;
+$light:                         h.$light;
+$dark:                          h.$dark;
+
+$black:                       #000 !default;
+$btn-toggle-color:              $black !default;
+
+$carousel-dark-indicator-active-bg:  #fff !default;
+$carousel-dark-caption-color:        #fff !default;
+$carousel-dark-control-icon-filter:  invert(0) grayscale(100) !default;
+
+$primary-text-emphasis-dark:        mix(white, h.$primary, h.$dark-mode-tint) !default;
+$secondary-text-emphasis-dark:      mix(white, h.$secondary, h.$dark-mode-tint) !default;
+$link-color-dark:                   mix(white, h.$primary, h.$dark-mode-tint) !default;
+$primary-bg-subtle-dark:            mix(black, h.$primary, h.$dark-mode-shade) !default;
+$primary-border-subtle-dark:        mix(black, h.$primary, calc(h.$dark-mode-shade / 2)) !default;

assets/scss/common/_variables.scss

@@ -7,6 +7,7 @@ $navbar-toggler-focus-width:    0 !default;
 
 // scss-docs-start font
 $font-family-sans-serif:        $theme-font, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji" !default;
+$font-size-base:                $font-size-base !default;;
 $headings-font-weight:          600 !default;
 $font-weight-lighter:           lighter !default;
 $font-weight-light:             200 !default;
@@ -22,8 +23,8 @@ strong {
 $black:                       #000 !default;
 $btn-toggle-color:              $black !default;
 
-$carousel-dark-indicator-active-bg:  #ffffff !default;
-$carousel-dark-caption-color:        #ffffff !default;
+$carousel-dark-indicator-active-bg:  #fff !default;
+$carousel-dark-caption-color:        #fff !default;
 $carousel-dark-control-icon-filter:  invert(0) grayscale(100) !default;
 
 // scss-docs-start color-mode

assets/scss/components/_card.scss

@@ -15,6 +15,10 @@
     width: 100%;
 }
 
+.card-icon {
+    color: $secondary;
+}
+
 .card-zoom::after .card-img-wrap img {
     content: "";
     position: absolute;
@@ -48,6 +52,10 @@
     color: $body-color if($enable-important-utilities, !important, null);
 }
 
+.card-body-margin {
+    margin-bottom: $spacer * 1.5; // equals mb-4
+}
+
 @if $enable-dark-mode {
     @include color-mode(dark) {
         .card-body-link {

assets/scss/components/_syntax-dart.scss

@@ -0,0 +1,49 @@
+// stylelint-disable annotation-no-unknown
+@import "syntax-light";
+
+.bg,
+.chroma,
+.chroma .err {
+    // set to transparent background to avoid rendering issues with example shortcode
+    background-color: transparent if($enable-important-utilities, !important, null);
+}
+
+.chroma {
+    display: flex;
+}
+
+.chroma code {
+    flex: 1;
+}
+
+.syntax-highlight {
+    background-color: var(--bs-light) if($enable-important-utilities, !important, null);
+    overflow-x: auto;
+}
+
+@if $enable-dark-mode {
+    [data-bs-theme="dark"] {
+        @include meta.load-css(syntax-dark);
+
+        .bg,
+        .chroma,
+        .chroma .err {
+            // set to transparent background to avoid rendering issues with example shortcode
+            background-color: transparent if($enable-important-utilities, !important, null);
+        }
+
+        .syntax-highlight {
+            background-color: var(--bs-tertiary-bg) if($enable-important-utilities, !important, null);
+            overflow-x: auto;
+        }
+
+        .bg,
+        .chroma,
+        .chroma .ge,
+        .chroma .gl,
+        .chroma .gs {
+            color: #c9d1d9 if($enable-important-utilities, !important, null);
+        }
+    }
+}
+// stylelint-enable annotation-no-unknown

assets/scss/components/_table.scss

@@ -0,0 +1,13 @@
+@if $enable-dark-mode {
+    @include color-mode(dark) {
+        .table-striped, .table-striped-columns {
+            --bs-table-striped-bg: var(--bs-tertiary-bg);
+            --bs-table-striped-color: var(--bs-body-color);
+        }
+
+        .table-hover {
+            --bs-table-hover-bg: var(--bs-tertiary-bg);
+            --bs-table-striped-color: var(--bs-body-color);
+        }
+    }
+}

assets/scss/layouts/_type.scss

@@ -30,3 +30,7 @@ h6 {
     margin-top: $spacer;
     scroll-margin-top: $navbar-offset;
 }
+
+.display-1, .display-2, .display-3, .display-4, .display-5, .display-6 {
+    scroll-margin-top: $navbar-offset;
+}

config/_default/hugo.toml

@@ -120,4 +120,6 @@ home = ["HTML", "RSS", "REDIR"]
     path = "github.com/gethinode/mod-katex"
   [[module.imports]]
     path = "github.com/gethinode/mod-leaflet"
+  [[module.imports]]
+    path = "github.com/gethinode/mod-lottie"
 # toml-docs-end modules

config/_default/params.toml

@@ -9,12 +9,14 @@
     [main.externalLinks]
         cue = false
         tab = false
+    [main.build]
+        transpiler = "libsass"
 # toml-docs-end main
 
 # toml-docs-start modules
 [modules]
     core = ["bootstrap", "flexsearch", "fontawesome"]
-    optional = ["leaflet", "katex"]
+    optional = ["leaflet", "katex", "lottie"]
     excludeSCSS = ["bootstrap"]
     disableTemplate = ["katex"]
     [modules.fontawesome]
@@ -43,6 +45,10 @@
     fullCover = false
     centerHeadline = false
     style = ""
+    [home.feature]
+        orientation = "horizontal"
+        color = "primary"
+        width = 4
 # toml-docs-end home
 
 # toml-docs-start navigation
@@ -50,8 +56,7 @@
     anchor = true
     logo = "/img/logo_icon.svg"
     color = "body"
-    fixed = true
-    offset = "3.8em"
+    offset = "5.5rem"
     search = true
     breadcrumb = true
     toc = true
@@ -116,7 +121,7 @@
 #         header = "full"
 #         footer = "none"
 #         orientation = "stacked"
-#         style = "border-0 card-zoom"
+#         style = "border-0 card-zoom card-body-margin"
 #         homepage = 3
 #         separator = true
 # toml-docs-end sections
@@ -143,6 +148,7 @@
     themeFont = "Inter"
     # themeFontPath = "https://fonts.googleapis.com/css2?family=Inter:wght@200;300;600&display=swap" # external path
     themeFontPath = "/fonts" # local path
+    fontSizeBase = "1rem" # assumes the browser default, typically '16px'
 # toml-docs-end font
 # toml-docs-start build
     purge = false

config/postcss.config.js

@@ -19,6 +19,7 @@ const purgecss = require('@fullhuman/postcss-purgecss')({
       './assets/scss/components/_syntax.scss',
       './assets/scss/components/_syntax-dark.scss',
       './assets/scss/components/_syntax-light.scss',
+      './assets/scss/components/_table.scss',
       './assets/scss/theme/fonts.scss',
       './assets/scss/theme/theme.scss',
       './_vendor/github.com/gethinode/mod-flexsearch/assets/scss/modules/flexsearch/flexsearch.scss',

content/_index.md

@@ -1,13 +1,15 @@
 ---
 title: Welcome to Hinode!
+description: A clean documentation and blog theme for your Hugo site based on Bootstrap 5.
 thumbnail:
     url: /img/sunrise.jpg
     author: Harris Vo
     authorURL: https://unsplash.com/@hoanvokim
     origin: https://unsplash.com/photos/ZX6BPboJrYk
     originName: Unsplash
+actions:
+  get-started:
+    url: "https://gethinode.com/docs"
+    title: "Get started"
+    icon: "fas book-open"
 ---
-
-A clean documentation and blog theme for your Hugo site based on Bootstrap 5.
-
-{{< button href="https://gethinode.com/docs" icon="fas book-open" order="first" >}}Get Started{{< /button>}}

exampleSite/assets/svgs/custom/activity.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" class="bi bi-activity" viewBox="0 0 16 16">
+  <path fill-rule="evenodd" d="M6 2a.5.5 0 0 1 .47.33L10 12.036l1.53-4.208A.5.5 0 0 1 12 7.5h3.5a.5.5 0 0 1 0 1h-3.15l-1.88 5.17a.5.5 0 0 1-.94 0L6 3.964 4.47 8.171A.5.5 0 0 1 4 8.5H.5a.5.5 0 0 1 0-1h3.15l1.88-5.17A.5.5 0 0 1 6 2Z"/>
+</svg>

exampleSite/config/_default/params.toml

@@ -7,10 +7,12 @@
     [main.externalLinks]
         cue = true
         tab = true
+    [main.build]
+        transpiler = "dartsass"
 
 [modules]
     core = ["bootstrap", "flexsearch", "fontawesome"]
-    optional = ["leaflet", "katex"]
+    optional = ["leaflet", "katex", "lottie"]
     excludeSCSS = ["bootstrap"]
     disableTemplate = ["katex"]
     [modules.fontawesome]
@@ -34,13 +36,18 @@
     fullCover = false
     centerHeadline = false
     style = ""
+    [home.feature]
+        orientation = "horizontal"
+        color = "primary"
+        width = 4
+        align = "start"
 
 [navigation]
     anchor = true
     logo = "/img/logo_icon.svg"
     color = "body"
     fixed = true
-    offset = "3.8em"
+    offset = "5.5rem"
     search = true
     breadcrumb = true
     toc = true
@@ -98,7 +105,7 @@
         header = "full"
         footer = "none"
         orientation = "stacked"
-        style = "border-0 card-zoom"
+        style = "border-0 card-zoom card-body-margin"
         homepage = 3
         separator = true
     [sections.projects]
@@ -113,7 +120,7 @@
         padding = "3"
         header = "none"
         footer = "tags"
-        orientation = "horizontal"
+        orientation = "horizontal-sm"
         style = "border-1 card-emphasize"
         homepage = 3
         separator = false

exampleSite/content/en/_index.md

@@ -1,14 +1,15 @@
 ---
 author: Mark Dumay
 title: Welcome to Hinode!
+description: A clean documentation and blog theme for your Hugo site based on Bootstrap 5.
 thumbnail:
     url: /img/sunrise.jpg
     author: Harris Vo
     authorURL: https://unsplash.com/@hoanvokim
     origin: https://unsplash.com/photos/ZX6BPboJrYk
     originName: Unsplash
+actions:
+  about:
+    url: "about"
+    title: "About"
 ---
-
-A clean documentation and blog theme for your Hugo site based on Bootstrap 5.
-
-{{< button href="about" >}}About{{< /button>}}

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

@@ -14,6 +14,16 @@ thumbnail:
 
 Hinode provides several shortcodes that wrap common Bootstrap components. Refer to the [official documentation]({{< param "links.hinode_docs" >}}) for more details.
 
+## Abbr
+
+As an example, the following shortcode displays the full text of an abbreviation on hover.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* abbr "CI/CD" */>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
 ## Accordion
 
 As an example, the following shortcode displays an accordion with three elements, of which the first element is expanded.
@@ -125,7 +135,7 @@ As an example, the following shortcode displays a card group of three elements.
 
 <!-- markdownlint-disable MD037 -->
 {{< example lang="hugo" >}}
-{{</* card-group padding="3" */>}}
+{{</* card-group padding="3" gutter="3" */>}}
     {{</* card title="Bootstrap framework" icon="fab bootstrap" */>}}
         Build fast, responsive sites with Bootstrap 5. Easily customize your site with the source
         Sass files.
@@ -231,13 +241,14 @@ Use the `file` shortcode to print and highlight the full content of a given inpu
 
 ## Icon
 
-As an example, the following shortcodes show a square check, a brand logo, and a circle check.
+As an example, the following shortcodes show a square check, a brand logo, a circle check, and a custom icon.
 
 <!-- markdownlint-disable MD037 -->
 {{< example lang="hugo" >}}
 {{</* fa square-check */>}}
 {{</* fab linkedin */>}}
 {{</* fas circle-check */>}}
+{{</* icon custom activity */>}}
 {{< /example >}}
 <!-- markdownlint-enable MD037 -->
 
@@ -292,6 +303,16 @@ As an example, the following shortcodes render links in different formats.
 {{< /example >}}
 <!-- markdownlint-enable MD037 -->
 
+## Mark
+
+Use the `mark` shortcode to highlight text. The inner content is used as input.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+Use the mark shortcode to {{</* mark >}}highlight{{< /mark */>}} specific text.
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
 ## Nav
 
 As an example, the following shortcode displays a tab group with vertically aligned pills.
@@ -345,13 +366,33 @@ Loading...
 {{< /example>}}
 <!-- markdownlint-enable MD037 -->
 
+## Sub
+
+As an example, the following shortcode displays subscript text.
+
+<!-- markdownlint-disable MD037 -->
+{{< example >}}
+H{{</* sub 2 */>}}O is a liquid.
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+## Sup
+
+As an example, the following shortcode displays superscript text.
+
+<!-- markdownlint-disable MD037 -->
+{{< example >}}
+2{{</* sup 10 */>}} is 1024.
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
 ## Timeline
 
-As an example, the following shortcode displays a timeline with the file `data/timeline-en.yml` as data.
+As an example, the following shortcode displays a timeline with the file `data/timeline.en.yml` as data.
 
 <!-- markdownlint-disable MD037 -->
 {{< example lang="hugo" >}}
-{{</* timeline data="timeline-en" background="dark" */>}}
+{{</* timeline data="timeline" background="dark" */>}}
 {{< /example >}}
 <!-- markdownlint-enable MD037 -->
 

exampleSite/content/en/blog/components.md

@@ -1,7 +1,7 @@
 ---
 author: Mark Dumay
 title: Components
-date: 2023-07-21
+date: 2023-09-23
 description: Use shortcodes to add predefined components powered by external libraries.
 tags: ["bootstrap", "shortcode"]
 thumbnail:
@@ -10,11 +10,21 @@ thumbnail:
   authorURL: https://unsplash.com/@ryoji__iwata
   origin: Unsplash
   originURL: https://unsplash.com/photos/5siQcvSxCP8
-modules: ["katex", "leaflet"]
+modules: ["katex", "leaflet", "lottie"]
 ---
 
 Hinode provides several shortcodes on top of the common [Bootstrap elements]({{< relref "bootstrap-elements" >}}). Refer to the [official documentation]({{< param "links.hinode_docs" >}}) for more details.
 
+## Animation
+
+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" */>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
 ## Formula (KaTeX)
 
 As an example, the following markdown renders two formulas using the KaTeX typesetting library.

exampleSite/content/fr/_index.md

@@ -1,14 +1,15 @@
 ---
 author: Mark Dumay
 title: Bienvenue sur Hinode!
+description: Un thème de blog et de documentation pour Hugo basé sur Bootstrap 5.
 thumbnail:
   url: /img/sunrise.jpg
   author: Harris Vo
   authorURL: https://unsplash.com/@hoanvokim
   origin: https://unsplash.com/photos/ZX6BPboJrYk
   originName: Unsplash
+actions:
+  about:
+    url: "a-propos"
+    title: "À propos"
 ---
-
-Un thème de blog et de documentation pour Hugo basé sur Bootstrap 5.
-
-{{< button href="a-propos" >}}À propos{{< /button>}}

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

@@ -0,0 +1,432 @@
+---
+author: Mark Dumay
+title: Éléments Bootstrap
+slug: elements-bootstrap
+date: 2023-08-12
+description: Utilisez des shortcodes pour ajouter facilement des éléments Bootstrap courants.
+tags: ["bootstrap", "shortcode"]
+thumbnail:
+  url: img/boots.jpg
+  author: Nathan Dumlao
+  authorURL: https://unsplash.com/@nate_dumlao
+  origin: Unsplash
+  originURL: https://unsplash.com/photos/QLPWQvHvmII
+---
+
+Hinode propose plusieurs shortcodes qui enveloppent des composants Bootstrap courants. Consultez la [documentation officielle]({{< param "links.hinode_docs" >}}) pour plus de détails.
+
+## Abbr
+
+À titre d'exemple, le shortcode suivant affiche le texte complet d'une abréviation lorsque survolé.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* abbr "CI/CD" */>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+## Accordéon
+
+À titre d'exemple, le shortcode suivant affiche un accordéon avec trois éléments, dont le premier élément est déplié.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* accordion */>}}
+  {{</* accordion-item header="Élément d'accordéon #1" show="true" */>}}
+    Il s'agit du contenu du corps du premier élément de l'accordéon. Il prend en charge le contenu HTML, s'il est activé dans le moteur de rendu goldmark. L'élément est affiché en ajoutant la valeur `show` à l'argument `class`.
+  {{</* /accordion-item */>}}
+  {{</* accordion-item header="Élément d'accordéon #2" */>}}
+    Il s'agit du contenu du corps du deuxième élément de l'accordéon.
+  {{</* /accordion-item */>}}
+  {{</* accordion-item header="Élément d'accordéon #3" */>}}
+    Il s'agit du contenu du corps du troisième élément de l'accordéon.
+  {{</* /accordion-item */>}}
+{{</* /accordion */>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+## Alerte
+
+À titre d'exemple, le shortcode suivant affiche une alerte simple.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* alert color="danger" dismissible="true" */>}}
+    Une simple alerte de danger — vérifiez-la !
+{{</* /alert */>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+## Badge
+
+Utilisez le shortcode "badge" pour afficher un badge avec un en-tête.
+
+<!-- markdownlint-disable MD037 -->
+{{< example >}}
+En-tête 1 {{</* badge title="Nouveau" */>}}
+{.h1}
+
+En-tête 2 {{</* badge title="Nouveau" */>}}
+{.h2}
+
+En-tête 3 {{</* badge title="Nouveau" */>}}
+{.h3}
+
+En-tête 4 {{</* badge title="Nouveau" */>}}
+{.h4}
+
+En-tête 5 {{</* badge title="Nouveau" */>}}
+{.h5}
+
+En-tête 6 {{</* badge title="Nouveau" */>}}
+{.h6}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+## Fil d'Ariane
+
+À titre d'exemple, le shortcode suivant affiche un fil d'Ariane pour la page du blog.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* breadcrumb path="blog" */>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+## Bouton
+
+À titre d'exemple, le shortcode suivant affiche une infobulle pour un bouton sombre avec un badge.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* button color="secondary" tooltip="Cliquez sur la boîte de réception pour voir vos messages non lus." href="#!" badge="99+" */>}}
+    Boîte de réception
+{{</* /button */>}}
+{{< /example>}}
+<!-- markdownlint-enable MD037 -->
+
+## Groupe de boutons
+
+À titre d'exemple, le shortcode suivant affiche un groupe de trois boutons.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* button-group aria-label="Basic example" */>}}
+  {{</* button color="primary" href="#!" */>}}Gauche{{</* /button */>}}
+  {{</* button color="primary" href="#!" */>}}Millieu{{</* /button */>}}
+  {{</* button color="primary" href="#!" */>}}Droite{{</* /button */>}}
+{{</* /button-group */>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+## Carte
+
+À titre d'exemple, le shortcode suivant affiche une carte empilée qui renvoie à la page [à propos]({{< ref "about" >}}). Elle inclut un en-tête personnalisé.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* card path="about" padding="3" class="col-6 mx-auto" color="body-tertiary" header="publication" footer="none" /*/>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+## Groupe de cartes
+
+À titre d'exemple, le shortcode suivant affiche un groupe de cartes avec trois éléments.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* card-group padding="3" gutter="3" */>}}
+    {{</* card title="Framework Bootstrap" icon="fab bootstrap" */>}}
+        Créez des sites rapides et réactifs avec Bootstrap 5. Personnalisez facilement votre site
+        avec les fichiers source Sass.
+    {{</* /card */>}}
+    {{</* card title="Recherche en texte intégral" icon="fas magnifying-glass" */>}}
+        Recherchez votre site avec FlexSearch, une bibliothèque de recherche en texte intégral
+        avec zéro dépendances.
+    {{</* /card */>}}
+    {{</* card title="Outils de développement" icon="fas code" */>}}
+        Utilisez Node Package Manager pour automatiser le processus de construction et suivre
+        les dépendances.
+    {{</* /card */>}}
+{{</* /card-group */>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+## Carrousel
+
+À titre d'exemple, le shortcode suivant affiche un carrousel centré avec trois slides, un rapport hauteur/largeur de 16:9 et une largeur relative de 67 % sur les grands écrans.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* carousel ratio="16x9" class="col-sm-12 col-lg-8 mx-auto" */>}}
+  {{</* img src="img/coffee.jpg" caption="slide 1" */>}}
+  {{</* img src="img/phone.jpg" caption="slide 2" */>}}
+  {{</* img src="img/dunes.jpg" caption="slide 3" */>}}
+{{</* /carousel */>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+## Réduire
+
+À titre d'exemple, le shortcode suivant affiche un bouton qui, lorsqu'il est cliqué, déclenche l'apparition ou la disparition d'un panneau.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* button collapse="collapse-1" */>}}
+    Déclencher le panneau
+{{</* /button */>}}
+
+{{</* collapse id="collapse-1" class="p-3 border rounded bg-primary-subtle" */>}}
+    Un contenu de remplacement destiné au composant de repliement. Ce panneau est initialement masqué, mais il
+    sera révélé lorsque l'utilisateur active le déclencheur correspondant.
+{{</* /collapse */>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+## Invite de commandes
+
+Utilisez le shortcode `command` pour générer un bloc avec un invite de commandes bash par défaut.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* command */>}}
+export MY_VAR=123
+{{</* /command */>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+Spécifiez `user` et `host` pour ajouter le contexte de l'utilisateur à l'invite. De plus, utilisez `(out)` pour spécifier une ligne de sortie et utilisez `\` pour indiquer une continuation de ligne.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* command user="user" host="localhost" */>}}
+export MY_VAR=123
+echo "hello"
+(out)hello
+echo one \
+two \
+three
+(out)one two three
+echo "goodbye"
+(out)goodbye
+{{</* /command */>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+## Documentation
+
+Utilisez le shortcode `docs` pour afficher le contenu d'un fichier `js`, `scss` ou `toml` :
+
+{{< docs name="theme-colors" file="config/_default/params.toml" >}}
+
+## Exemple
+
+Utilisez le shortcode `example` pour afficher un exemple de code et pour afficher un aperçu de la même entrée.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* command */>}}
+export MY_VAR=123
+{{</* /command */>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+## Fichier
+
+Utilisez le shortcode `file` pour afficher et mettre en évidence le contenu complet d'un fichier d'entrée donné.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* file path="./config/_default/languages.toml" id="file-collapse-1" */>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+## Icon
+
+À titre d'exemple, les shortcodes suivants affichent une coche carrée, un logo de marque et une coche circulaire.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* fa square-check */>}}
+{{</* fab linkedin */>}}
+{{</* fas circle-check */>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+## Image
+
+À titre d'exemple, le shortcode suivant affiche une image avec des coins arrondis et un ratio d'aspect de 21:9.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* image src="img/flowers.jpg" ratio="21x9" caption="Légende de l'image" class="rounded" */>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+À titre d'exemple, le shortcode suivant affiche une image vectorielle classique.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* image src="/img/logo_icon.svg" class="col-sm-6 col-lg-4" wrapper="text-center" */>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+À titre d'exemple, le shortcode suivant affiche une image vectorielle avec une référence de symbole.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* image src="/img/logo_var.svg#logo" class="col-sm-6 col-lg-4" wrapper="text-center" */>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+## Lien
+
+À titre d'exemple, les shortcodes suivants rendent des liens dans différents formats.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+
+- {{</* link hinode >}}Lien nommé avec les paramètres par défaut{{< /link */>}}
+- {{</* link name=hinode cue=false tab=false >}}Lien nommé s'ouvrant dans l'onglet actuel sans icône{{< /link */>}}
+- {{</* link name=hinode cue=true tab=true >}}Lien nommé s'ouvrant dans un nouvel onglet avec icône{{< /link */>}}
+- {{</* link hinode /*/>}}
+- {{</* link href="https://developer.mozilla.org" >}}Lien externe{{< /link */>}}
+- {{</* link "./projects/another-project" >}}Lien interne avec titre{{< /link */>}}
+- {{</* link url="projects/another-project" /*/>}}
+- {{</* link url="/projects/another-project" /*/>}}
+- {{</* link url="../projects/another-project" case=false /*/>}}
+- {{</* link "/about/" /*/>}}
+- {{</* link "/en/about/" /*/>}}
+- {{</* link "/en/about" >}}About (Anglais){{< /link */>}}
+- {{</* link "#image" /*/>}}
+- {{</* link "components/#map" /*/>}}
+
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+## Mark
+
+Utilisez le shortcode `mark` pour mettre en évidence le texte. Le contenu interne est utilisé en tant qu'entrée.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+Utilisez le shortcode `mark` pour {{</* mark >}}mettre en évidence{{< /mark */>}} un texte spécifique.
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+## Navigation
+
+À titre d'exemple, le shortcode suivant affiche un groupe d'onglets avec des onglets alignés verticalement.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+  {{</* nav type="pills" vertical="true" */>}}
+    {{</* nav-item header="Élément de navigation #1" show="true" */>}}
+      Voici le contenu de navigation du premier élément. Il prend en charge le contenu HTML, s'il est
+      activé dans le moteur de rendu Goldmark. L'élément est affiché en ajoutant la valeur `show` à l'argument `class`.
+    {{</* /nav-item */>}}
+    {{</* nav-item header="Élément de navigation #2" */>}}
+      Voici le contenu de navigation du deuxième élément.
+    {{</* /nav-item */>}}
+    {{</* nav-item header="Élément de navigation #3" */>}}
+      Voici le contenu de navigation du troisième élément.
+    {{</* /nav-item */>}}
+  {{</* /nav */>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+## Barre de navigation
+
+À titre d'exemple, le shortcode suivant affiche un en-tête de navigation clair.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* navbar id="navbar-sample" path="blog" color="primary" size="md" search="false" menus="sample" title="Marque" mode="false" */>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+## Publication
+
+À titre d'exemple, le shortcode suivant affiche un bouton de publication par défaut.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* release version="v0.14.1" */>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+## Indicateur de chargement
+
+À titre d'exemple, le raccourci suivant affiche un indicateur de chargement centré.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* spinner color="info" class="text-center" */>}}
+Chargement...
+{{</* /spinner */>}}
+{{< /example>}}
+<!-- markdownlint-enable MD037 -->
+
+## Sub
+
+À titre d'exemple, le shortcode suivant affiche du texte en indice.
+
+<!-- markdownlint-disable MD037 -->
+{{< example >}}
+H{{</* sub 2 */>}}O est un liquide.
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+## Sup
+
+À titre d'exemple, le shortcode suivant affiche du texte en exposant.
+
+<!-- markdownlint-disable MD037 -->
+{{< example >}}
+2{{</* sup 10 */>}} équivaut à 1024.
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+## Chronologie
+
+À titre d'exemple, le shortcode suivant affiche une chronologie avec le fichier `data/timeline-fr.yml` en tant que données.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* timeline data="timeline-fr" background="dark" */>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+## Notification
+
+À titre d'exemple, le shortcode suivant affiche un bouton qui, lorsqu'il est cliqué, déclenche le message de notification.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* button toast="toast-example-1" */>}}
+    Affiche la notifiaction #1
+{{</* /button */>}}
+
+{{</* button toast="toast-example-2" */>}}
+    Affiche la notifiaction #1
+{{</* /button */>}}
+
+{{</* toast id="toast-example-1" header="Premier titre" */>}}
+    Ceci est le premier message de notification. Il prend en charge le `markdown`.
+{{</* /toast */>}}
+
+{{</* toast id="toast-example-2" header="Deuxième titre" */>}}
+    Ceci est le deuxième message de notification. Il prend en charge le `markdown`.
+{{</* /toast */>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+## Infobulle
+
+À titre d'exemple, le shortcode suivant affiche une infobulle pour un lien hypertexte coloré.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* tooltip color="primary" title="Légende de l'infobulle" href="#!" */>}}Démonstration{{</* /tooltip */>}} d'une infobulle
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->

exampleSite/content/fr/blog/components.md

@@ -0,0 +1,50 @@
+---
+author: Mark Dumay
+title: Composents
+slug: composents
+date: 2023-07-21
+description: Utilisez des shortcodes pour ajouter des composants prédéfinis alimentés par des bibliothèques externes.
+tags: ["bootstrap", "shortcode"]
+thumbnail:
+  url: img/puzzle.jpg
+  author: Ryoji Iwata
+  authorURL: https://unsplash.com/@ryoji__iwata
+  origin: Unsplash
+  originURL: https://unsplash.com/photos/5siQcvSxCP8
+modules: ["katex", "leaflet", "lottie"]
+---
+
+Hinode propose plusieurs shortcodes en plus des [éléments Bootstrap]({{< relref "bootstrap-elements" >}}) courants. Consultez la [documentation officielle]({{< param "links.hinode_docs" >}}) pour plus de détails.
+
+## Animation
+
+À titre d'exemple, le shortcode suivant affiche une animation qui se déclenche au survol.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* animation data="gatin.json" auto=false hover=true class="col-6 mx-auto" */>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+## Formule (KaTeX)
+
+À titre d'exemple, le markdown suivant affiche deux formules en utilisant la bibliothèque de composition typographique KaTeX.
+
+{{< example lang="markdown" >}}
+Voici une formule en ligne $-b \pm \sqrt{b^2 - 4ac} \over 2a$.
+
+Il s'agit d'une formule non en ligne:
+
+$$x = a_0 + \frac{1}{a_1 + \frac{1}{a_2 + \frac{1}{a_3 + a_4}}}$$  
+$$\forall x \in X, \quad \exists y \leq \epsilon$$
+{{< /example >}}
+
+## Map
+
+À titre d'exemple, le shortcode suivant affiche une carte interactive de la ville d'Amsterdam.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* map lat=52.377 long=4.90 zoom=13 popup="Gare centrale d'Amsterdam" popup-lat=52.378062 popup-long=4.900562 */>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->

exampleSite/content/nl/_index.md

@@ -1,14 +1,15 @@
 ---
 author: Mark Dumay
 title: Welkom bij Hinode!
+description: Een documentatie en blog thema voor Hugo gebaseerd op Bootstrap 5.
 thumbnail:
     url: /img/sunrise.jpg
     author: Harris Vo
     authorURL: https://unsplash.com/@hoanvokim
     origin: https://unsplash.com/photos/ZX6BPboJrYk
     originName: Unsplash
+actions:
+  about:
+    url: "over-mij"
+    title: "Over mij"
 ---
-
-Een documentatie en blog thema voor Hugo gebaseerd op Bootstrap 5.
-
-{{< button href="over-mij" >}}Over mij{{< /button>}}

exampleSite/data/abbr.yml

@@ -0,0 +1,11 @@
+- id: css
+  long: "Cascading Style Sheets"
+
+- id: html
+  long: "HyperText Markup Language"
+
+- id: svg
+  long: "Scalable Vector Graphics"
+
+- id: ci/cd
+  long: "Continuous Integration/Continuous Deployment"

exampleSite/data/timeline-fr.yml

@@ -0,0 +1,35 @@
+# This file holds all menu entries for the docs sidebar
+
+- title: Lancement de produit
+  icon: fas rocket
+  color: primary
+  date: 2023-07-01
+  url: https://github.com/gethinode/hinode/releases/tag/v0.15.2
+  content:
+    Lorem ipsum dolor sit amet, consectetur adipisicing elit. Cupiditate ducimus officiis quod! Aperiam eveniet nam nostrum odit quasi ullam voluptatum.
+    Lorem ipsum dolor sit amet, consectetur adipisicing elit. Cupiditate ducimus officiis quod! Aperiam eveniet nam nostrum odit quasi ullam voluptatum.
+
+- title: Prise en charge I18N
+  icon: fas globe
+  color: success
+  date: 2023-05-06
+  url: v0.14.0
+  content:
+    Lorem ipsum dolor sit amet.
+
+- title: Nouvelle fonctionnalité
+  icon: fas house
+  color: warning
+  date: 2023-02-04
+  url: v0.8.1
+  content:
+    Cupiditate ducimus officiis quod!
+
+- title: Version bêta
+  icon: fas heart
+  color: info
+  date: 2022-11-30
+  # url: v0.1
+  content:
+    Lorem ipsum dolor sit amet, consectetur adipisicing elit. Cupiditate ducimus officiis quod! Aperiam eveniet nam nostrum odit quasi ullam voluptatum.
+    Lorem ipsum dolor sit amet, consectetur adipisicing elit. Cupiditate ducimus officiis quod! Aperiam eveniet nam nostrum odit quasi ullam voluptatum.

exampleSite/go.mod

@@ -3,9 +3,4 @@ module github.com/gethinode/hinode-test
 go 1.19
 
 require (
-	github.com/gethinode/mod-bootstrap v1.1.1 // indirect
-	github.com/gethinode/mod-flexsearch v1.4.0 // indirect
-	github.com/gethinode/mod-fontawesome v1.2.5 // indirect
-	github.com/gethinode/mod-katex v1.0.2 // indirect
-	github.com/gethinode/mod-leaflet v0.3.4 // indirect
 )

exampleSite/go.sum

@@ -1,17 +1,49 @@
 github.com/gethinode/mod-bootstrap v1.1.1 h1:Tx4M5hGVOFrEaxnUONDAm6N9xuRi5UphKlT7F26HujU=
 github.com/gethinode/mod-bootstrap v1.1.1/go.mod h1:DcpPc2cNaXUPGEvhD7npuEEPA7573NvakTlrwFbyjr8=
+github.com/gethinode/mod-bootstrap v1.2.0 h1:JkTcImU3qpi25WgKvUxUYiMoiXtrxrG+Wf/utRB5UbU=
+github.com/gethinode/mod-bootstrap v1.2.0/go.mod h1:DcpPc2cNaXUPGEvhD7npuEEPA7573NvakTlrwFbyjr8=
+github.com/gethinode/mod-bootstrap v1.2.1 h1:z54dgsbhShhlri+X77Z+yLrg0wz/f8C8ojA/wnlhsJc=
+github.com/gethinode/mod-bootstrap v1.2.1/go.mod h1:DcpPc2cNaXUPGEvhD7npuEEPA7573NvakTlrwFbyjr8=
 github.com/gethinode/mod-flexsearch v1.2.0 h1:SSMpWzK9SMbi9QRYfil9PJZLLWWLHWzlTc69UxtSWAA=
 github.com/gethinode/mod-flexsearch v1.2.0/go.mod h1:TXbGbWsvmhBdsTzRt887mcpFfr4ORpzG3+h/l4W3YM4=
 github.com/gethinode/mod-flexsearch v1.3.0 h1:RbfEDw219Y1rOVp9lHmy5ePdF9lyPalDu2J5oVeejrU=
 github.com/gethinode/mod-flexsearch v1.3.0/go.mod h1:TXbGbWsvmhBdsTzRt887mcpFfr4ORpzG3+h/l4W3YM4=
 github.com/gethinode/mod-flexsearch v1.4.0 h1:5e/NVRLyWzUZ9fO/fNsM5o+O7nw+xyln2rfEOtbgfWc=
 github.com/gethinode/mod-flexsearch v1.4.0/go.mod h1:TXbGbWsvmhBdsTzRt887mcpFfr4ORpzG3+h/l4W3YM4=
+github.com/gethinode/mod-flexsearch v1.4.1 h1:z+GKvhJ4v6BsZsWVZRgbO9WcmSZEVUkb3Q9a09yXtd8=
+github.com/gethinode/mod-flexsearch v1.4.1/go.mod h1:TXbGbWsvmhBdsTzRt887mcpFfr4ORpzG3+h/l4W3YM4=
 github.com/gethinode/mod-fontawesome v1.2.4 h1:SqE3CQ+boaBIhrVh3MPu4nz0uoHPfEH5t60nNY1CfsI=
 github.com/gethinode/mod-fontawesome v1.2.4/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
 github.com/gethinode/mod-fontawesome v1.2.5 h1:RqkLRj6+s+gM4nKd0IwNMMDA8cRmxfp0fxkVH4FdAGU=
 github.com/gethinode/mod-fontawesome v1.2.5/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
+github.com/gethinode/mod-fontawesome v1.3.0 h1:oudeDBlAKu8vqYxumWuq5SG5F5itm33NgTrBLgvPulQ=
+github.com/gethinode/mod-fontawesome v1.3.0/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
+github.com/gethinode/mod-fontawesome v1.3.1 h1:EdnBuG2B+bi06OcYmcL1NfSxHpRMEGu8TXUqEEpVH4g=
+github.com/gethinode/mod-fontawesome v1.3.1/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
+github.com/gethinode/mod-fontawesome v1.3.2 h1:qLJSbAFR2T33BuBtC2Iulm9wZql3cy7AhXjxc2YGzBU=
+github.com/gethinode/mod-fontawesome v1.3.2/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
+github.com/gethinode/mod-fontawesome v1.4.0 h1:JfmVYwQl19jmZxgxY64yvGqJAAEiFkKf2dbZ5Iv08Qw=
+github.com/gethinode/mod-fontawesome v1.4.0/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
+github.com/gethinode/mod-fontawesome v1.5.0 h1:3mW5dnWauuF9wSWXNIY+PPgTNPlc/xQOQoG7XGic1Yk=
+github.com/gethinode/mod-fontawesome v1.5.0/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
 github.com/gethinode/mod-katex v1.0.1/go.mod h1:byAfpI3wuqNJIooTGVEGc1cjBhhCy4+CcK1H6495MYg=
 github.com/gethinode/mod-katex v1.0.2 h1:pIG4n3qLl/IVe7BEiwn+GL8r5lOCtF6FDxlcrPKdAXk=
 github.com/gethinode/mod-katex v1.0.2/go.mod h1:byAfpI3wuqNJIooTGVEGc1cjBhhCy4+CcK1H6495MYg=
+github.com/gethinode/mod-katex v1.0.3 h1:fvlUWqcUQqv2zRNM2kfmJ6GhXA816Tl1nfVrUkmBStI=
+github.com/gethinode/mod-katex v1.0.3/go.mod h1:byAfpI3wuqNJIooTGVEGc1cjBhhCy4+CcK1H6495MYg=
 github.com/gethinode/mod-leaflet v0.3.4 h1:oY+YQ0JiJuhFQNrk9XgFdg0NMsTUQPXNfnILp4ia4r4=
 github.com/gethinode/mod-leaflet v0.3.4/go.mod h1:uGggt87x4Fw7wBoJpSiUvNkYg+s/Ujne7klAX2rxMRk=
+github.com/gethinode/mod-leaflet v0.3.5 h1:69Bv/6zRXhbcTzo7TMr58h3ry47srHRpM1k81LrLbYU=
+github.com/gethinode/mod-leaflet v0.3.5/go.mod h1:uGggt87x4Fw7wBoJpSiUvNkYg+s/Ujne7klAX2rxMRk=
+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=
+github.com/gethinode/mod-lottie v1.0.1/go.mod h1:erRCgSL2FCfKHI0jQbSpM+g0jXl7SjKVJrh7kWGteKs=
+github.com/gethinode/mod-lottie v1.0.2 h1:QM/PJqEl1UhNNoPx6y7pVtwev/mDxUyWNHLqDB76YzI=
+github.com/gethinode/mod-lottie v1.0.2/go.mod h1:erRCgSL2FCfKHI0jQbSpM+g0jXl7SjKVJrh7kWGteKs=
+github.com/gethinode/mod-lottie v1.1.0 h1:KnfOQ45xdv1tpsKCkF5OiE3QuT29ycppBfY6o+rWl/4=
+github.com/gethinode/mod-lottie v1.1.0/go.mod h1:erRCgSL2FCfKHI0jQbSpM+g0jXl7SjKVJrh7kWGteKs=
+github.com/gethinode/mod-lottie v1.2.0 h1:9S0Y4PlEO66dIvFxayatmDEf8WWxqbLNLi4z563i2gM=
+github.com/gethinode/mod-lottie v1.2.0/go.mod h1:erRCgSL2FCfKHI0jQbSpM+g0jXl7SjKVJrh7kWGteKs=
+github.com/gethinode/mod-lottie v1.3.0 h1:vQ8CXkjdp2IeFskTzu+ZnKOEio8GtN08urVK+oCH81E=
+github.com/gethinode/mod-lottie v1.3.0/go.mod h1:erRCgSL2FCfKHI0jQbSpM+g0jXl7SjKVJrh7kWGteKs=

exampleSite/hugo_stats.json

@@ -2,6 +2,7 @@
   "htmlElements": {
     "tags": [
       "a",
+      "abbr",
       "body",
       "br",
       "button",
@@ -21,6 +22,7 @@
       "input",
       "li",
       "link",
+      "mark",
       "meta",
       "nav",
       "nil",
@@ -33,6 +35,8 @@
       "small",
       "span",
       "strong",
+      "sub",
+      "sup",
       "svg",
       "time",
       "title",
@@ -61,10 +65,11 @@
       "bg-body",
       "bg-body-tertiary",
       "bg-danger",
-      "bg-info",
       "bg-opacity-10",
       "bg-primary",
       "bg-primary-subtle",
+      "bi",
+      "bi-activity",
       "border",
       "border-0",
       "border-1",
@@ -90,7 +95,9 @@
       "card",
       "card-body",
       "card-body-link",
+      "card-body-margin",
       "card-emphasize",
+      "card-icon",
       "card-img-top",
       "card-img-wrap",
       "card-text",
@@ -113,7 +120,6 @@
       "col-6",
       "col-8",
       "col-9",
-      "col-lg-2",
       "col-lg-4",
       "col-lg-8",
       "col-md-10",
@@ -129,12 +135,12 @@
       "container",
       "container-fluid",
       "container-xxl",
+      "custom",
       "d-block",
       "d-flex",
       "d-grid",
       "d-inline",
       "d-inline-flex",
-      "d-lg-block",
       "d-md-block",
       "d-md-flex",
       "d-md-none",
@@ -159,6 +165,7 @@
       "fa-2x",
       "fa-2xs",
       "fa-4x",
+      "fa-activity",
       "fa-arrow-left",
       "fa-arrow-right",
       "fa-bootstrap",
@@ -209,6 +216,8 @@
       "fw-semibold",
       "g-0",
       "g-3",
+      "g-4",
+      "gap-1",
       "gap-2",
       "gap-3",
       "gradient",
@@ -239,11 +248,12 @@
       "link-secondary",
       "link-success",
       "link-warning",
+      "lottie-animation",
       "m-0",
+      "main-content",
       "main-nav-toggler",
       "mb-0",
       "mb-3",
-      "mb-4",
       "mb-5",
       "mb-lg-5",
       "me-3",
@@ -258,13 +268,15 @@
       "mt-3",
       "mt-5",
       "mt-auto",
-      "multi-docs-collapse-14",
+      "multi-docs-collapse-15",
       "multi-file-collapse-1",
       "mx-auto",
+      "mx-md-0",
       "mx-md-2",
       "my-2",
       "my-auto",
       "my-md-0",
+      "my-md-auto",
       "nav",
       "nav-item",
       "nav-link",
@@ -280,13 +292,11 @@
       "navbar-toggler",
       "next",
       "no-js",
+      "order-0",
       "order-1",
-      "order-2",
-      "order-3",
-      "order-4",
       "order-first",
-      "order-sm-2",
-      "order-sm-3",
+      "order-md-0",
+      "order-md-1",
       "p-0",
       "p-1",
       "p-2",
@@ -294,7 +304,9 @@
       "p-4",
       "pb-2",
       "pb-3",
+      "pb-4",
       "pb-5",
+      "pb-md-0",
       "pe-3",
       "position-absolute",
       "position-fixed",
@@ -304,14 +316,15 @@
       "ps-1",
       "ps-3",
       "ps-xl-3",
-      "pt-3",
+      "pt-4",
+      "pt-5",
+      "pt-md-3",
       "px-3",
       "px-4",
       "px-xxl-0",
       "py-1",
       "py-2",
       "py-3",
-      "py-5",
       "py-md-1",
       "ratio",
       "ratio-16x9",
@@ -323,10 +336,10 @@
       "row",
       "row-cols-1",
       "row-cols-2",
+      "row-cols-md-2",
       "row-cols-md-3",
       "row-cols-sm-2",
       "row-cols-sm-3",
-      "row-cols-sm-4",
       "search",
       "search-input",
       "search-suggestions",
@@ -358,10 +371,12 @@
       "text-decoration-none",
       "text-end",
       "text-info",
+      "text-muted",
       "text-nowrap",
       "text-right",
       "text-secondary",
       "text-sm-start",
+      "text-start",
       "text-uppercase",
       "theme-icon",
       "theme-icon-active",
@@ -403,6 +418,7 @@
       "-theme",
       "-theme-collapsed",
       "TableOfContents",
+      "abbr",
       "accordion",
       "accordion-0",
       "accordion-0-heading-0",
@@ -411,10 +427,16 @@
       "accordion-0-item-0",
       "accordion-0-item-1",
       "accordion-0-item-2",
+      "accordéon",
       "alert",
+      "alerte",
+      "animation",
       "badge",
-      "body-docs-collapse-14",
+      "barre-de-navigation",
+      "blog",
+      "body-docs-collapse-15",
       "body-file-collapse-1",
+      "bouton",
       "breadcrumb",
       "btn-webshare",
       "button",
@@ -423,20 +445,36 @@
       "card-group",
       "carousel",
       "carousel-0",
+      "carrousel",
+      "carte",
+      "chronologie",
       "collapse",
       "collapse-1",
       "command-prompt",
       "docs",
+      "documentation",
       "example",
+      "exemple",
+      "fichier",
+      "fil-dariane",
       "file",
-      "footer-docs-collapse-14",
+      "footer-docs-collapse-15",
       "footer-file-collapse-1",
       "formula-katex",
+      "formule-katex",
+      "groupe-de-boutons",
+      "groupe-de-cartes",
       "icon",
       "image",
+      "indicateur-de-chargement",
+      "infobulle",
+      "invite-de-commandes",
       "leaflet-map-0",
+      "lien",
       "link",
+      "lottie-animation-0",
       "map",
+      "mark",
       "nav",
       "nav-0",
       "nav-0-0",
@@ -448,8 +486,17 @@
       "navbar",
       "navbar-0-collapse",
       "navbar-sample-collapse",
+      "navigation",
+      "notification",
+      "projecten",
+      "projects",
+      "projets",
+      "publication",
       "release",
+      "réduire",
       "spinner",
+      "sub",
+      "sup",
       "timeline",
       "toast",
       "toast-container",
@@ -461,4 +508,4 @@
       "tooltip"
     ]
   }
-}
+}

go.mod

@@ -3,9 +3,10 @@ module github.com/gethinode/hinode
 go 1.19
 
 require (
-	github.com/gethinode/mod-bootstrap v1.1.1 // indirect
-	github.com/gethinode/mod-flexsearch v1.4.0 // indirect
-	github.com/gethinode/mod-fontawesome v1.2.5 // indirect
-	github.com/gethinode/mod-katex v1.0.2 // indirect
-	github.com/gethinode/mod-leaflet v0.3.4 // indirect
+	github.com/gethinode/mod-bootstrap v1.2.1 // indirect
+	github.com/gethinode/mod-flexsearch v1.4.1 // indirect
+	github.com/gethinode/mod-fontawesome v1.5.0 // indirect
+	github.com/gethinode/mod-katex v1.0.3 // indirect
+	github.com/gethinode/mod-leaflet v0.3.5 // indirect
+	github.com/gethinode/mod-lottie v1.3.0 // indirect
 )

go.sum

@@ -4,6 +4,10 @@ github.com/gethinode/mod-bootstrap v1.1.0 h1:BbalsW8kmFhv+J+dcc41TGcjIlM/p69AB0h
 github.com/gethinode/mod-bootstrap v1.1.0/go.mod h1:DcpPc2cNaXUPGEvhD7npuEEPA7573NvakTlrwFbyjr8=
 github.com/gethinode/mod-bootstrap v1.1.1 h1:Tx4M5hGVOFrEaxnUONDAm6N9xuRi5UphKlT7F26HujU=
 github.com/gethinode/mod-bootstrap v1.1.1/go.mod h1:DcpPc2cNaXUPGEvhD7npuEEPA7573NvakTlrwFbyjr8=
+github.com/gethinode/mod-bootstrap v1.2.0 h1:JkTcImU3qpi25WgKvUxUYiMoiXtrxrG+Wf/utRB5UbU=
+github.com/gethinode/mod-bootstrap v1.2.0/go.mod h1:DcpPc2cNaXUPGEvhD7npuEEPA7573NvakTlrwFbyjr8=
+github.com/gethinode/mod-bootstrap v1.2.1 h1:z54dgsbhShhlri+X77Z+yLrg0wz/f8C8ojA/wnlhsJc=
+github.com/gethinode/mod-bootstrap v1.2.1/go.mod h1:DcpPc2cNaXUPGEvhD7npuEEPA7573NvakTlrwFbyjr8=
 github.com/gethinode/mod-flexsearch v1.0.1 h1:FJkRsUzSnQTXl3MWCigT4E6vfff870UWTnkGqaDGIhA=
 github.com/gethinode/mod-flexsearch v1.0.1/go.mod h1:TXbGbWsvmhBdsTzRt887mcpFfr4ORpzG3+h/l4W3YM4=
 github.com/gethinode/mod-flexsearch v1.1.0 h1:7BCMyQDlYlskNXuazt8Jg/jg9WREexu2xVkYqThkAX4=
@@ -22,6 +26,8 @@ github.com/gethinode/mod-flexsearch v1.3.0 h1:RbfEDw219Y1rOVp9lHmy5ePdF9lyPalDu2
 github.com/gethinode/mod-flexsearch v1.3.0/go.mod h1:TXbGbWsvmhBdsTzRt887mcpFfr4ORpzG3+h/l4W3YM4=
 github.com/gethinode/mod-flexsearch v1.4.0 h1:5e/NVRLyWzUZ9fO/fNsM5o+O7nw+xyln2rfEOtbgfWc=
 github.com/gethinode/mod-flexsearch v1.4.0/go.mod h1:TXbGbWsvmhBdsTzRt887mcpFfr4ORpzG3+h/l4W3YM4=
+github.com/gethinode/mod-flexsearch v1.4.1 h1:z+GKvhJ4v6BsZsWVZRgbO9WcmSZEVUkb3Q9a09yXtd8=
+github.com/gethinode/mod-flexsearch v1.4.1/go.mod h1:TXbGbWsvmhBdsTzRt887mcpFfr4ORpzG3+h/l4W3YM4=
 github.com/gethinode/mod-fontawesome v1.0.2 h1:ZSK6D20/w4y5GnfYfTBB58uHD0ChIfkpKfRGwioS9rg=
 github.com/gethinode/mod-fontawesome v1.0.2/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
 github.com/gethinode/mod-fontawesome v1.1.0 h1:rsDzUI+3ZlS/do2ff3ne8/z3KwHeysmuA+WsXlumXXk=
@@ -38,12 +44,24 @@ github.com/gethinode/mod-fontawesome v1.2.4 h1:SqE3CQ+boaBIhrVh3MPu4nz0uoHPfEH5t
 github.com/gethinode/mod-fontawesome v1.2.4/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
 github.com/gethinode/mod-fontawesome v1.2.5 h1:RqkLRj6+s+gM4nKd0IwNMMDA8cRmxfp0fxkVH4FdAGU=
 github.com/gethinode/mod-fontawesome v1.2.5/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
+github.com/gethinode/mod-fontawesome v1.3.0 h1:oudeDBlAKu8vqYxumWuq5SG5F5itm33NgTrBLgvPulQ=
+github.com/gethinode/mod-fontawesome v1.3.0/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
+github.com/gethinode/mod-fontawesome v1.3.1 h1:EdnBuG2B+bi06OcYmcL1NfSxHpRMEGu8TXUqEEpVH4g=
+github.com/gethinode/mod-fontawesome v1.3.1/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
+github.com/gethinode/mod-fontawesome v1.3.2 h1:qLJSbAFR2T33BuBtC2Iulm9wZql3cy7AhXjxc2YGzBU=
+github.com/gethinode/mod-fontawesome v1.3.2/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
+github.com/gethinode/mod-fontawesome v1.4.0 h1:JfmVYwQl19jmZxgxY64yvGqJAAEiFkKf2dbZ5Iv08Qw=
+github.com/gethinode/mod-fontawesome v1.4.0/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
+github.com/gethinode/mod-fontawesome v1.5.0 h1:3mW5dnWauuF9wSWXNIY+PPgTNPlc/xQOQoG7XGic1Yk=
+github.com/gethinode/mod-fontawesome v1.5.0/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
 github.com/gethinode/mod-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=
 github.com/gethinode/mod-katex v1.0.1/go.mod h1:byAfpI3wuqNJIooTGVEGc1cjBhhCy4+CcK1H6495MYg=
 github.com/gethinode/mod-katex v1.0.2 h1:pIG4n3qLl/IVe7BEiwn+GL8r5lOCtF6FDxlcrPKdAXk=
 github.com/gethinode/mod-katex v1.0.2/go.mod h1:byAfpI3wuqNJIooTGVEGc1cjBhhCy4+CcK1H6495MYg=
+github.com/gethinode/mod-katex v1.0.3 h1:fvlUWqcUQqv2zRNM2kfmJ6GhXA816Tl1nfVrUkmBStI=
+github.com/gethinode/mod-katex v1.0.3/go.mod h1:byAfpI3wuqNJIooTGVEGc1cjBhhCy4+CcK1H6495MYg=
 github.com/gethinode/mod-leaflet v0.2.3 h1:QQI4h+IH0jZ7fx4q0um2YIEiYBoW3OAfW8qHzbRCDPk=
 github.com/gethinode/mod-leaflet v0.2.3/go.mod h1:uGggt87x4Fw7wBoJpSiUvNkYg+s/Ujne7klAX2rxMRk=
 github.com/gethinode/mod-leaflet v0.3.1 h1:H5MaOa+BB1KuVw7abTqfIn/SNzzRsAyx/WQoSe+2Ykc=
@@ -52,3 +70,17 @@ github.com/gethinode/mod-leaflet v0.3.3 h1:isnjja6VRFvVWBatYSouh46TXSJg2C4/E2BQT
 github.com/gethinode/mod-leaflet v0.3.3/go.mod h1:uGggt87x4Fw7wBoJpSiUvNkYg+s/Ujne7klAX2rxMRk=
 github.com/gethinode/mod-leaflet v0.3.4 h1:oY+YQ0JiJuhFQNrk9XgFdg0NMsTUQPXNfnILp4ia4r4=
 github.com/gethinode/mod-leaflet v0.3.4/go.mod h1:uGggt87x4Fw7wBoJpSiUvNkYg+s/Ujne7klAX2rxMRk=
+github.com/gethinode/mod-leaflet v0.3.5 h1:69Bv/6zRXhbcTzo7TMr58h3ry47srHRpM1k81LrLbYU=
+github.com/gethinode/mod-leaflet v0.3.5/go.mod h1:uGggt87x4Fw7wBoJpSiUvNkYg+s/Ujne7klAX2rxMRk=
+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=
+github.com/gethinode/mod-lottie v1.0.1/go.mod h1:erRCgSL2FCfKHI0jQbSpM+g0jXl7SjKVJrh7kWGteKs=
+github.com/gethinode/mod-lottie v1.0.2 h1:QM/PJqEl1UhNNoPx6y7pVtwev/mDxUyWNHLqDB76YzI=
+github.com/gethinode/mod-lottie v1.0.2/go.mod h1:erRCgSL2FCfKHI0jQbSpM+g0jXl7SjKVJrh7kWGteKs=
+github.com/gethinode/mod-lottie v1.1.0 h1:KnfOQ45xdv1tpsKCkF5OiE3QuT29ycppBfY6o+rWl/4=
+github.com/gethinode/mod-lottie v1.1.0/go.mod h1:erRCgSL2FCfKHI0jQbSpM+g0jXl7SjKVJrh7kWGteKs=
+github.com/gethinode/mod-lottie v1.2.0 h1:9S0Y4PlEO66dIvFxayatmDEf8WWxqbLNLi4z563i2gM=
+github.com/gethinode/mod-lottie v1.2.0/go.mod h1:erRCgSL2FCfKHI0jQbSpM+g0jXl7SjKVJrh7kWGteKs=
+github.com/gethinode/mod-lottie v1.3.0 h1:vQ8CXkjdp2IeFskTzu+ZnKOEio8GtN08urVK+oCH81E=
+github.com/gethinode/mod-lottie v1.3.0/go.mod h1:erRCgSL2FCfKHI0jQbSpM+g0jXl7SjKVJrh7kWGteKs=

hugo_stats.json

@@ -30,9 +30,9 @@
       "active",
       "align-content-center",
       "align-items-center",
+      "align-items-end",
       "align-self-center",
       "bg-body",
-      "bg-info",
       "bg-opacity-10",
       "bg-primary",
       "bottom-0",
@@ -42,27 +42,22 @@
       "btn-primary",
       "col",
       "col-12",
-      "col-lg-2",
-      "col-lg-4",
+      "col-6",
       "col-md-2",
-      "col-md-4",
+      "col-md-6",
       "col-md-8",
       "col-md-auto",
       "col-sm-12",
-      "col-sm-6",
       "collapse",
       "collapsed",
       "container-fluid",
       "container-xxl",
-      "d-block",
       "d-flex",
       "d-inline",
-      "d-lg-block",
       "d-md-block",
       "d-md-flex",
       "d-md-none",
       "d-none",
-      "d-sm-none",
       "display-1",
       "display-4",
       "dropdown",
@@ -89,7 +84,6 @@
       "fab",
       "fas",
       "feature",
-      "fixed-top",
       "flex-column",
       "flex-fill",
       "flex-grow-1",
@@ -97,18 +91,23 @@
       "footer",
       "form-control",
       "fs-3",
+      "fs-5",
       "fw-30",
       "fw-bold",
       "h-100",
+      "hstack",
       "img-fluid",
       "img-wrap",
       "invisible",
       "is-search",
       "justify-content-center",
+      "justify-content-end",
+      "justify-content-md-start",
+      "justify-content-start",
       "link-bg-footer",
       "link-secondary",
+      "main-content",
       "main-nav-toggler",
-      "mb-4",
       "me-auto",
       "middle-bar",
       "min-vh-100",
@@ -117,8 +116,10 @@
       "mt-3",
       "mt-5",
       "mx-auto",
+      "mx-md-0",
       "mx-md-2",
       "my-auto",
+      "my-md-auto",
       "nav-item",
       "nav-link",
       "navbar",
@@ -128,32 +129,35 @@
       "navbar-nav",
       "navbar-toggler",
       "no-js",
+      "order-0",
       "order-1",
-      "order-2",
-      "order-3",
-      "order-4",
-      "order-first",
-      "order-sm-2",
-      "order-sm-3",
+      "order-md-0",
+      "order-md-1",
       "p-0",
       "p-2",
       "p-3",
       "p-4",
+      "pb-4",
       "pb-5",
-      "pe-1",
+      "pb-md-0",
       "position-fixed",
       "position-relative",
+      "ps-1",
+      "pt-5",
+      "pt-md-3",
       "px-3",
       "px-4",
       "px-xxl-0",
       "py-2",
-      "py-5",
+      "py-3",
       "py-md-1",
       "rounded",
       "row",
       "row-cols-1",
+      "row-cols-2",
+      "row-cols-md-2",
+      "row-cols-sm-2",
       "row-cols-sm-3",
-      "row-cols-sm-4",
       "search",
       "search-input",
       "search-suggestions",
@@ -162,6 +166,8 @@
       "switch-mode-collapsed",
       "text-center",
       "text-decoration-none",
+      "text-md-start",
+      "text-muted",
       "text-secondary",
       "text-sm-start",
       "theme-icon",
@@ -183,4 +189,4 @@
       "toast-copied-code-message"
     ]
   }
-}
+}

i18n/en.yaml

@@ -25,6 +25,8 @@
   translation: "Articles"
 - id: more
   translation: "More {{ . }}"
+- id: emptyList
+  translation: "No articles found"
 
 # Sharing
 - id: shareLink
@@ -39,6 +41,8 @@
   translation: "Link"
 - id: code
   translation: "Code"
+- id: download
+  translation: "Download article"
 
 # Pagination
 - id: paginationNav

i18n/nl.yaml

@@ -23,6 +23,8 @@
   translation: "Artikelen"
 - id: more
   translation: "Meer {{ . }}"
+- id: emptyList
+  translation: "Geen artikelen gevonden"
 
 # Sharing
 - id: shareLink
@@ -37,6 +39,8 @@
   translation: "Link"
 - id: code
   translation: "Code"
+- id: download
+  translation: "Download artikel"
 
 # Pagination
 - id: paginationNav

layouts/_default/baseof.html

@@ -1,8 +1,25 @@
-{{- $section := .Section }}
+{{- define "partials/optional-scripts.html" -}}
+    {{- $modules := site.Params.modules.optional | intersect .Params.modules -}}
+    {{- range $index, $mod := $modules -}}
+        {{- $filename := printf "js/%s.bundle.js" $mod -}}
+        {{- $match := printf "js/modules/%s/**.js" $mod -}}
+        {{- $skipTemplate := false -}}
+        {{- if reflect.IsSlice site.Params.modules.disableTemplate -}}
+            {{- if in site.Params.modules.disableTemplate $mod}}
+                {{- $skipTemplate = true -}}
+            {{- end -}}
+        {{- end -}}
+
+        {{- partial "footer/scripts.html" (dict "filename" $filename "match" $match "header" false "skipTemplate" $skipTemplate "page" .) }}
+    {{- end -}}
+{{- end -}}
+
+{{- /* Set version-aware sidebar menu */ -}}
 {{- $version := partial "utilities/GetVersion.html" (dict "page" . "base" true) -}}
 {{- $.Scratch.Set "version" $version -}}
 {{ with partial "utilities/GetMenu" (dict "page" . "version" $version) }}{{ $.Scratch.Set "sidebar" . }}{{ end }}
 
+{{- /* Validate if current version is latest */ -}}
 {{- if and site.Params.docs.checkVersion $version -}}
     {{- if ne $version "latest" -}}
         {{- if partial "utilities/IsOlder" (dict "current" $version) -}}
@@ -12,10 +29,13 @@
     {{- end -}}
 {{- end -}}
 
+{{- /* Validate module configuration */ -}}
 {{- if and .IsPage (not (in .Site.Params.modules.core "bootstrap")) -}}
     {{- errorf "Bootstrap is a required module, please add it to 'modules.core' in your site parameters" -}}
 {{- end -}}
 
+{{- $section := .Section }}
+
 <!doctype html>
 <html lang="{{ .Site.Language.Lang }}" class="no-js">
     <head>
@@ -24,77 +44,25 @@
 
     <body>
         {{- partial "footer/scripts.html" (dict "filename" "js/critical.bundle.js" "match" "js/critical/**.js" "header" true "page" .) -}}
-        <div class="d-flex flex-column min-vh-100{{ if and .IsHome .Site.Params.home.style }} {{ .Site.Params.home.style }}{{ end }}">
-            <div class="{{ if .Site.Params.navigation.fixed }}mb-4{{ end }}">
-                {{- partial "assets/navbar.html" (dict
-                    "page" .
-                    "fixed" (string .Site.Params.navigation.fixed)
-                    "color" (.Site.Params.navigation.color)
-                    "style" (default "light" .Site.Params.navigation.style)
-                    "size" (default "md" .Site.Params.navigation.size))
-                -}}
-            </div>
-            {{ if .IsHome -}}
-                {{ if .Site.Params.home.fullCover -}}
-                    <div class="d-flex flex-fill {{ if .Site.Params.navigation.fixed }}mt-5{{ end }}">
-                        {{ block "featured" . }}{{ end -}}
-                    </div>
-                {{ else -}}
-                    <div class="{{ if .Site.Params.navigation.fixed }}mt-5{{ end }}">
-                        {{ block "featured" . }}{{ end -}}
-                    </div>
-                    <div class="d-flex flex-column flex-fill">
-                        {{ block "main" . }}{{ end -}}
-                    </div>
-                    {{ if not .Site.Params.main.footerBelowFold }}
-                        <div class="">
-                            {{- partial "footer/social.html" . -}}
-                            {{- partial "footer/footer.html" . -}}
-                        </div>
-                    {{ end }}
-                {{ end -}}
-            {{ else -}}
-                <div class="d-flex flex-column flex-fill {{ if .Site.Params.navigation.fixed }}mt-5{{ end }}">
-                    {{ block "main" . }}{{ end -}}
-                </div>
-                {{ if not .Site.Params.main.footerBelowFold }}
-                    <div class="">
-                        {{- partial "footer/social.html" . -}}
-                        {{- partial "footer/footer.html" . -}}
-                    </div>
-                {{ end }}
-            {{ end -}}
-        </div>
+        <div class="d-flex flex-column min-vh-100{{ if .IsHome }}{{ with .Site.Params.home.style }} {{ . }}{{ end }}{{ end }}">
+            {{- partial "assets/navbar.html" (dict
+                "page" .
+                "fixed" (string site.Params.navigation.fixed)
+                "color" site.Params.navigation.color
+                "style" (default "light" site.Params.navigation.style)
+                "size" (default "md" site.Params.navigation.size))
+            -}}
 
-        {{ if and .IsHome .Site.Params.home.fullCover -}}
-            <div class="">
+            <div class="flex-fill main-content{{ if .Site.Params.main.footerBelowFold }} fullscreen{{ end }} pb-4">
                 {{ block "main" . }}{{ end -}}
             </div>
-            <div class="">
-                {{- partial "footer/social.html" . -}}
-                {{- partial "footer/footer.html" . -}}
-            </div>
-        {{ else if .Site.Params.main.footerBelowFold }}
-            <div class="">
-                {{- partial "footer/social.html" . -}}
-                {{- partial "footer/footer.html" . -}}
-            </div>
-        {{ end }}
+
+            {{- partial "footer/social.html" . -}}
+            {{- partial "footer/footer.html" . -}}
+        </div>
 
         {{- partial "footer/toast-container.html" . -}}
         {{- partialCached "footer/scripts.html" (dict "header" false "page" . "core" true) }}
-        {{- $modules := site.Params.modules.optional | intersect .Params.modules -}}
-        {{- range $index, $mod := $modules -}}
-            {{- $filename := printf "js/%s.bundle.js" $mod -}}
-            {{- $match := printf "js/modules/%s/**.js" $mod -}}
-            {{- $skipTemplate := false -}}
-            {{- if reflect.IsSlice site.Params.modules.disableTemplate -}}
-                {{- if in site.Params.modules.disableTemplate $mod}}
-                    {{- $skipTemplate = true -}}
-                {{- end -}}
-            {{- end -}}
-
-            {{- partial "footer/scripts.html" (dict "filename" $filename "match" $match "header" false "skipTemplate" $skipTemplate "page" .) }}
-        {{- end -}}
+        {{- partial "partials/optional-scripts.html" . -}}
     </body>
 </html>

layouts/_default/list.html

@@ -1,12 +1,135 @@
 {{- define "main" -}}
-    {{- partial "assets/section-list.html" (dict 
-        "page" .
-        "section" .Type
-        "home" false
-        "nested" .Params.Nested
-        "title" (or .Title .Type)
-        "description" .Description
-        "content" .Content
-        "paginate" true)
-    -}}
-{{- end -}}
+    {{- $page := . -}}
+    {{- $orientation :=  site.Params.list.feature.orientation | default "horizontal" -}}
+    {{- $width := site.Params.list.feature.width | default 6 -}}
+    {{- $justify := site.Params.list.feature.justify | default "center" -}}
+    {{- $align := site.Params.list.feature.align | default "center" -}}
+    {{- $sections := slice -}}
+    {{- $sections = $sections | append $page.Type -}}
+    {{ with $page.Params.sections }}
+        {{ $sections = $sections | append . }}
+    {{ end }}
+    {{- $actions := $page.Params.actions -}}
+    {{- $headings := slice -}}
+    {{- $layout := $page.Params.layout -}}
+
+    {{ if $page.IsHome }}
+        {{- $orientation = or site.Params.home.feature.orientation $orientation -}}
+        {{- $width = or site.Params.home.feature.width $width -}}
+        {{- $justify = or site.Params.home.feature.justify $justify -}}
+        {{- $align = or site.Params.home.feature.align $align -}}
+        {{- $actions = (or $actions site.Params.featured.actions) -}}
+        {{- if not $page.Params.sections -}}
+            {{- with site.Params.home.sections }}
+                {{ $sections = $sections | append . }}
+            {{ else }}
+                {{ range $section := site.Sections }}
+                    {{ $sections = $sections | append $section.Type }}
+                {{ end }}
+            {{ end }}
+        {{- end -}}
+    {{ else }}
+        {{ $headings = $headings | append $page.Title }}
+        {{- range .Fragments.Headings }}
+            {{- range .Headings }}
+                {{- $headings = $headings | append .Title -}}
+            {{- end -}}
+        {{- end -}}
+    {{ end }}
+
+    {{/* Generate section content first to determine headings */}}
+    {{ $body := "" }}
+    {{- range $index, $section := $sections -}}
+        {{- $sectionPage := site.GetPage "section" $section -}}
+        {{- $sectionURL := $sectionPage.RelPermalink -}}
+        {{- $title := or $sectionPage.Title $sectionPage.Type -}}
+
+        {{- with (index site.Params.sections $section) -}}
+            {{- with index . "title" }}{{ $title = or . $title }}{{ end -}}
+        {{- end -}}
+    
+        {{- $thumbnail := (or (and (reflect.IsMap $sectionPage.Params.Thumbnail) $sectionPage.Params.Thumbnail.url) $sectionPage.Params.Thumbnail) -}}
+        {{- $icon := $sectionPage.Params.Icon -}}
+        {{- $content := $sectionPage.Content -}}
+        {{- $sectionTitle := strings.FirstUpper $sectionPage.Type -}}
+        {{- $moreTitle := "" -}}
+        {{- with (index site.Params.sections $section) -}}
+            {{- with index . "reference" }}{{ $moreTitle = . }}{{ end -}}
+        {{- end -}}
+        {{- $moreTitle = or $moreTitle (printf (T "more" (pluralize $sectionTitle))) -}}
+
+        {{- $sectionContent := trim (partial "assets/section-list.html" (dict 
+            "page" $page 
+            "section" $section 
+            "home" $page.IsHome
+            "simple" (eq $section $page.Section)
+            "nested" (and $page.IsHome (eq $section $page.Section))
+            "thumbnail" $thumbnail
+            "icon" $icon
+            "content" $content
+            "moreTitle" $moreTitle
+            "sectionURL" $sectionURL)) " \r\n"
+        -}}
+
+        {{ if $sectionContent }}
+            {{- if not $page.IsHome }}{{ $headings = $headings | append $title }}{{ end -}}
+            {{- $body = printf "%s%s" $body $sectionContent }}
+        {{ end }}
+    {{- end -}}
+
+    {{/* Display featured section */}}
+    {{- if or (eq $layout "featured") $page.IsHome -}}
+        {{- partial "list/featured.html" (dict 
+            "page" .
+            "headings" $headings
+            "actions" $actions
+            "orientation" $orientation
+            "width" $width
+            "justify" $justify
+            "align" $align) 
+        -}}
+    {{- end -}}
+
+    {{/* Display main content */}}
+    <div class="container-xxl px-4 px-xxl-0">
+        {{- if ne $layout "featured" -}}
+            {{ if and (not $page.IsHome) site.Params.navigation.breadcrumb }}
+                <div>{{ partial "assets/breadcrumb.html" $page }}</div>
+            {{ end -}}
+        {{- end -}}
+
+        <div class="row row-cols-1 row-cols-sm-2">
+            <div class="col col-sm-12 col-md-8">
+                {{ if not $page.IsHome }}
+                    {{ with $page.Title }}<p id="{{ anchorize . }}" class="display-4 mt-3{{ if and page.IsHome site.Params.home.centerHeadline }} text-center{{ end }}">{{ . }}</p>{{ end }}
+                {{ end }}
+                {{ if ($page.Params.menu) }}
+                    {{- partial "assets/section-menu.html" $page -}}
+                {{- end -}}
+                {{- $content := partial "utilities/ProcessContent" (dict "page" $page "raw" $page.RawContent) -}}
+                {{ $content | safeHTML }}
+                {{ if and (and (and $sections (eq (len $sections) 1)) (not $body)) (not $content) }}
+                    <p class="pt-4">{{- T "emptyList" }}.</p>
+                {{ end }}
+            </div>
+            {{ with $page.Params.contact }}
+                {{- $contact := site.GetPage . }}
+                {{- if not $contact }}
+                    {{- errorf "Error processing content file '%s' - Cannot find contact: %s" $page.File . -}}
+                {{- else -}}
+                    {{ $color := site.Params.contact.color | default "primary" }}
+                    {{ $style := site.Params.contact.style | default "shadow" }}
+                    <div class="col col-md-4 d-none d-md-block pt-5">
+                        {{- partial "assets/card.html" (dict "path" $page.Params.contact "color" $color "header" "none" "footer" "none" "ratio" "1x1" "class" (printf "w-75 mx-auto mt-4 %s" $style)) -}}
+                    </div>
+                    <div class="col col-sm-12 d-md-none pt-5">
+                        {{- partial "assets/card.html" (dict "path" $page.Params.contact "color" $color "header" "none" "footer" "none" "orientation" "horizontal" "class" $style) -}}
+                    </div>
+                {{- end }}
+            {{ end }}
+        </div>    
+    </div>
+
+    {{/* Display generated sections */}}
+    {{ $body | safeHTML }}
+{{- end -}}

layouts/_default/single.html

@@ -18,7 +18,7 @@
         {{- if gt (len (.GetTerms "tags")) 0 -}}
             <div class="mt-3">
                 <div class="d-none-dark">
-                    <div class="hstack gap-3">
+                    <div class="hstack gap-1">
                         {{ range (.GetTerms "tags") -}}
                             {{- $url := (path.Join .Page.RelPermalink) | relLangURL -}}
                             {{ partial "assets/button.html" (dict "href" $url "title" .LinkTitle "color" "light" "size" "sm") }}
@@ -84,7 +84,7 @@
         {{ end -}}
     {{ end }}
 
-    {{ partial "utilities/ProcessContent" (dict "page" .Page "raw" .RawContent )}}
+    {{ partial "utilities/ProcessContent" (dict "page" .Page "raw" .RawContent) }}
 {{ end -}}
 
 {{ define "partials/footer.html" -}}
@@ -99,7 +99,7 @@
                     {{ $next := . -}}
                     {{ with .OutputFormats.Get "html" -}}
                         <a class="next" href="{{ $next.RelPermalink }}">
-                            {{- partial "assets/icon.html" (dict "icon" "fas arrow-left") }}&nbsp;{{ $next.Title }}</a>
+                            {{- partial "assets/icon.html" (dict "icon" "fas arrow-left") }}&nbsp;{{ $next.LinkTitle }}</a>
                     {{- end -}}
                 {{ end -}}
             </div>
@@ -107,7 +107,7 @@
                 {{ with .PrevInSection -}}
                     {{ $prev := . -}}
                     {{ with .OutputFormats.Get "html" -}}
-                        <a class="previous" href="{{ $prev.RelPermalink }}">{{ $prev.Title }}&nbsp;{{- partial "assets/icon.html" (dict "icon" "fas arrow-right") }}</a>
+                        <a class="previous" href="{{ $prev.RelPermalink }}">{{ $prev.LinkTitle }}&nbsp;{{- partial "assets/icon.html" (dict "icon" "fas arrow-right") }}</a>
                     {{- end -}}
                 {{ end -}}
             </div>
@@ -120,6 +120,11 @@
 {{ end -}}
 
 {{ define "main" -}}
+    {{- $download := .Params.download -}}
+    {{- if and $download (not (fileExists (path.Join "static" $download))) -}}
+        {{- errorf "Cannot find download file for page '%s': %s" .File.Path $download -}}
+    {{- end -}}
+    
     {{- $menu := .Scratch.Get "sidebar" -}}
     {{- $version := .Scratch.Get "version" -}}
     {{- $sidebar := .Site.Params.navigation.sidebar | default true -}}
@@ -134,7 +139,7 @@
             </div>
         </div>
     
-        <div class="container-xxl px-3 px-xxl-0">
+        <div class="container-xxl p-4 px-xxl-0">
             <div class="row row-cols-md-2 row-cols-lg-3">
                 <div class="col col-md-3 col-lg-2 d-none pt-5 d-md-block sidebar-overflow sticky-top">
                     {{ partial "assets/sidebar" (dict "page" . "menu" $menu "version" $version) }}
@@ -146,12 +151,12 @@
                 </div>
                 <div class="col col-lg-2 d-none d-lg-block pt-5">
                     {{- if and .Site.Params.navigation.toc .Params.includeToc | default true -}}
-                        {{ partial "assets/toc.html" . -}}
+                        {{ partial "assets/toc.html" (dict "page" . "download" $download) -}}
                     {{ end -}}
                 </div>
             </div>
         </div>
-    {{ else }}
+    {{ else if $sidebar }}
         <div class="container-xxl px-3 px-xxl-0">
             <div class="row row-cols-1 row-cols-sm-3">
                 <div class="col col-md-2 d-none d-md-block"></div>
@@ -162,7 +167,22 @@
                 </div>
                 <div class="col col-md-2 d-none d-md-block">
                     {{- if and .Site.Params.navigation.toc .Params.includeToc | default true -}}
-                        {{ partial "assets/toc.html" . -}}
+                        {{ partial "assets/toc.html" (dict "page" . "download" $download) -}}
+                    {{ end -}}
+                </div>
+            </div>    
+        </div>
+    {{ else }}
+        <div class="container-xxl px-3 px-xxl-0">
+            <div class="row row-cols-1 row-cols-sm-2">
+                <div class="col col-sm-12 col-md-9">
+                    {{ partial "partials/header.html" . }}
+                    {{ partial "partials/body.html" . }}
+                    {{ partial "partials/footer.html" . }}
+                </div>
+                <div class="col col-md-3 d-none d-md-block">
+                    {{- if and .Site.Params.navigation.toc .Params.includeToc | default true -}}
+                        {{ partial "assets/toc.html" (dict "page" . "download" $download) -}}
                     {{ end -}}
                 </div>
             </div>    

layouts/index.html

@@ -1,40 +0,0 @@
-{{- define "featured" -}}
-    {{- partial "home/featured.html" . -}}
-{{- end -}}
-
-{{- define "main" -}}
-    {{- $page := . -}}
-    {{- $sections := site.Params.home.sections -}}
-    {{- if not $sections -}}
-        {{ range $section := site.Sections }}
-            {{ $sections = $sections | append $section.Type }}
-        {{ end }}
-    {{- end -}}
-
-    {{- range $index, $section := $sections -}}
-        {{- $sectionPage := site.GetPage "section" $section -}}
-        {{- $sectionURL := $sectionPage.RelPermalink -}}
-        {{- $title := or $sectionPage.Title $sectionPage.Type -}}
-        {{- $thumbnail := (or (and (reflect.IsMap $sectionPage.Params.Thumbnail) $sectionPage.Params.Thumbnail.url) $sectionPage.Params.Thumbnail) -}}
-        {{- $icon := $sectionPage.Params.Icon -}}
-        {{- $content := $sectionPage.Content -}}
-        {{- $sectionTitle := strings.FirstUpper $sectionPage.Type -}}
-        {{- $moreTitle := "" -}}
-        {{- with (index site.Params.sections $section) -}}
-            {{- with index . "reference" }}{{ $moreTitle = . }}{{ end -}}
-        {{- end -}}
-        {{- $moreTitle = or $moreTitle (printf (T "more" (pluralize $sectionTitle))) -}}
-
-        {{- partial "assets/section-list.html" (dict 
-            "page" $page 
-            "section" $section 
-            "home" true 
-            "nested" true 
-            "thumbnail" $thumbnail
-            "icon" $icon
-            "content" $content
-            "moreTitle" $moreTitle
-            "sectionURL" $sectionURL)
-        -}}
-    {{- end -}}
-{{- end -}}

layouts/partials/assets/breadcrumb.html

@@ -1,7 +1,7 @@
 <nav aria-label="breadcrumb">
     <ol class="breadcrumb">
         {{- range $index, $item := .Page.Ancestors.Reverse -}}
-            {{- $title := .Title -}}
+            {{- $title := .LinkTitle -}}
             {{- if .IsHome }}{{ $title = T "home" }}{{ end -}} 
             {{- $address := or .RelPermalink (.Params.Redirect | relLangURL) -}}
             {{ if $address }}
@@ -10,6 +10,6 @@
                 <li class="breadcrumb-item">{{ $title }}</li>
             {{ end }}
         {{- end -}}
-        <li class="breadcrumb-item active" aria-current="page">{{ .Page.Title }}</li>
+        <li class="breadcrumb-item active" aria-current="page">{{ .Page.LinkTitle }}</li>
     </ol>
 </nav>

layouts/partials/assets/button.html

@@ -28,6 +28,7 @@
     "tab"           Optional flag to indicate if an external link should open in a new tab, defaults to setting
                     "main.externalLinks.tab" in the site's parameters.
     "attributes"    Optional dictionary of key-value pairs added as custom attributes to the button element ('<a>').
+    "spacing"       Optional flag to add spacing to the inline button, defaults to "true".
 -->
 
 {{- $title := trim .title " \r\n" -}}
@@ -126,6 +127,8 @@
 {{- $target := "" -}}
 {{- $rel := "" -}}
 
+{{- $spacing := .spacing | default true -}}
+
 {{- if $isExternal -}}
     {{- if $tab -}}
         {{- $target = "_blank" -}}
@@ -140,7 +143,7 @@
 
 {{- $attributes := .attributes -}}
 
-<a aria-label="{{ or $label $title }}" {{ if ne $state "disabled" }}{{ with $href }}href="{{ . }}"{{ end }}{{ end -}}
+<a aria-label="{{ (or $label $title) | safeHTML }}" {{ if ne $state "disabled" }}{{ with $href }}href="{{ . }}"{{ end }}{{ end -}}
     {{- with $id }} id="{{ . }}"{{ end -}}
     {{- with $target }} target="{{ . }}"{{ end }}{{ with $rel }} rel="{{ . }}"{{ end -}}
     {{- with $toast }} data-toast-target="{{ $toast }}"{{ end -}}
@@ -157,7 +160,7 @@
     {{- end -}}
     >
     <div class="d-flex justify-content-{{ $justify }}">
-        <div class="my-auto">{{ $title }}</div>
+        <div class="my-auto">{{ $title | safeHTML }}</div>
         {{- with $icon }}<div class="align-self-center{{ if $title }}{{ if eq $order "first" }} order-first pe-1{{ else }} ps-1{{ end }}{{ end }}">{{ partial "assets/icon.html" (dict "icon" $icon) }}</div>{{ end }}
     </div>
 
@@ -167,4 +170,4 @@
             {{ with $label }}<span class="visually-hidden">{{ . }}</span>{{ end }}
         </span>
     {{- end -}}  
-</a>
+</a>{{ if $spacing }}&nbsp;{{- end }}

layouts/partials/assets/card-group.html

@@ -10,6 +10,7 @@
     "cards"         Optional string of rendered cards.
     "max"           Required maximum number of cards to display.
     "cols"          Required number of columns for the grid, must be a value between 1 and 5.
+    "gutter"        Gutter between columns in a group, either "0", "1", "2", "3", "4" (default), or "5".
     "title"         Optional title of the card group.
     "paginate"      Optional flag indicating if pagination should be added to the card group, if the list exceeds the
                     maximum number of cards to display. 
@@ -17,6 +18,8 @@
                     maximum number of cards to display.
     "hrefTitle"     Optional title of the button or hyperlink as companion to href.
     "separator"     Optional flag to indicate a horizontal line should be added between items on small screens.
+    "wrapper"       Optional class attributes of the wrapper element, e.g. "p-4 px-xxl-0".
+    "responsive"    Optional flag if the number of columns should be responsive, defaults to "true".
 
     In addition, the following arguments are passed to the individual cards.
     "class"         Optional class attribute of the card element, e.g. “w-50”.
@@ -28,6 +31,8 @@
     "footer"        Optional footer components of the card, displayed in small caps. Supported values are "full",
                     "publication", "tags", and "none" (default).
     "orientation"   Optional placecement of the thumbnail, either "stacked" (default), "horizontal", or "none".
+    "ratio"         Optional ratio of the thumbnail image, defaults to "16x9" (stacked orientation) or "1x1" (horizontal
+                    orientation).
 -->
 
 {{- $page := .page -}}
@@ -89,15 +94,31 @@
 {{- end -}}
 {{- $max = math.Min $max $count -}}
 
-{{- $cols := .cols -}}
-{{- if or (lt $cols 1) (gt $cols 5) -}}
-    {{- errorf "partial [assets/card-group.html] - Invalid value for param 'cols': %d" $cols -}}
+{{- $responsive := .responsive | default true -}}
+{{- with .responsive -}}
+    {{- if ne (printf "%T" .) "bool" -}}
+        {{- errorf "partial [assets/card-group.html] - Invalid value for param 'responsive'" -}}
+    {{- end -}}
+{{- end -}}
+
+{{- $cols := string .cols | default "3" -}}
+{{- $supportedCols := slice "0" "1" "2" "3" "4" "5" "auto" -}}
+{{- if not (in $supportedCols $cols) -}}
+    {{- errorf "partial [assets/card-group.html] - Invalid value for param 'cols': %s" $cols -}}
+{{- end -}}
+{{- $colGrid := "" -}}
+{{- if eq $cols "1" }}{{ $colGrid = "row-cols-1" -}}
+{{- else if eq $cols "2" }}{{ if $responsive }}{{ $colGrid = "row-cols-1 row-cols-sm-1 row-cols-md-2" }}{{ else }}{{ $colGrid = "row-cols-2" }}{{ end -}}
+{{- else if eq $cols "3" }}{{ if $responsive }}{{ $colGrid = "row-cols-1 row-cols-sm-2 row-cols-md-3" }}{{ else }}{{ $colGrid = "row-cols-3" }}{{ end -}}
+{{- else if eq $cols "4" }}{{ if $responsive }}{{ $colGrid = "row-cols-1 row-cols-sm-2 row-cols-md-4" }}{{ else }}{{ $colGrid = "row-cols-4" }}{{ end -}}
+{{- else if eq $cols "5" }}{{ if $responsive }}{{ $colGrid = "row-cols-1 row-cols-sm-3 row-cols-md-5" }}{{ else }}{{ $colGrid = "row-cols-5" }}{{ end -}}
+{{ end -}}
+
+{{- $gutter := .gutter | default "4" -}}
+{{- $supportedGutters := slice "0" "1" "2" "3" "4" "5" -}}
+{{- if not (in $supportedGutters $gutter) -}}
+    {{- errorf "partial [assets/card-group.html] - Invalid value for param 'gutter': %s" $gutter -}}
 {{- end -}}
-{{- $colGrid := "row-cols-1" -}}
-{{- if eq $cols 2 }}{{ $colGrid = "row-cols-1 row-cols-sm-1 row-cols-md-2" -}}
-{{- else if eq $cols 3 }}{{ $colGrid = "row-cols-1 row-cols-sm-2 row-cols-md-3" -}}
-{{- else if eq $cols 4 }}{{ $colGrid = "row-cols-1 row-cols-sm-2 row-cols-md-4" -}}
-{{- else if eq $cols 5 }}{{ $colGrid = "row-cols-1 row-cols-sm-3 row-cols-md-5" }}{{ end -}}
 
 {{- if not $paginate -}}
     {{- $list = first $max $list -}}
@@ -120,11 +141,13 @@
 {{- $header := .header -}}
 {{- $footer := .footer -}}
 {{- $orientation := .orientation -}}
+{{- $ratio := .ratio -}}
+{{- $wrapper := .wrapper | default "p-0" -}}
 
 {{- if and (eq $cols 1) (eq $orientation "horizontal") }}{{ $orientation = "horizontal-sm" }}{{ end -}}
 
-<div class="container-fluid p-4 px-xxl-0 ">
-    <div class="row {{ $colGrid }}">
+<div class="container-fluid {{ $wrapper }}">
+    <div class="row {{ $colGrid }} g-{{ $gutter }}">
         {{ range $index, $element := $list }}
             {{- $params := (dict
                 "class" (printf "h-100 %s" $class)
@@ -133,10 +156,11 @@
                 "header" $header
                 "footer" $footer
                 "orientation" $orientation
+                "ratio" $ratio
             ) -}}
             {{- $params = merge $params $element }}
 
-            <div class="col pt-3 pb-3">
+            <div class="col">
                 {{- partial "assets/card.html" $params -}}
             </div>
             {{- if and (lt $index (sub $max 1)) $separator -}}

layouts/partials/assets/card.html

@@ -11,12 +11,16 @@
                     "warning", "info", "light", "dark", "white", "black", "body", or "body-tertiary". By default, no
                     color is specified.
     "padding":      Optional padding of the content, either "0", "1", "2", "3", "4", "5", or "auto" (default).
+    "gutter"        Gutter between columns in a group, either "0" (default), "1", "2", "3", "4", or "5".
     "header"        Optional header components of the card, displayed in small caps. Supported values are "full"
                     (default), "publication", "tags", and "none".
     "footer"        Optional footer components of the card, displayed in small caps. Supported values are "full",
                     "publication", "tags", and "none" (default).
     "description"   Optional description of the card.
     "thumbnail"     Optional thumbnail image url, displayed on top or the left of the card.
+    "ratio"         Optional ratio of the thumbnail image, defaults to "16x9" (stacked orientation) or "1x1" (horizontal
+                    orientation).
+    "alt"           Optional alternate text for the thumbnail, uses "title" by default.
     "icon"          Optional Font Awesome icon, displayed on top or the left of the card.
     "orientation"   Optional placecement of the thumbnail or icon, either "stacked" (default), "horizontal",
                     "horizontal-sm" or "none".
@@ -32,12 +36,12 @@
     {{- if $href -}}
         <a href="{{ $href }}" class="{{ if $color }}link-bg-{{ $color }}{{ else }}card-body-link{{ end }} stretched-link">
                 <p class="card-title fs-5 fw-bold">{{ $title }}</p>
-            {{ with $description }}<p class="card-text mb-4 {{ if $color }}link-bg-{{ $color }}{{ else }}card-body-link{{ end }}">{{ . }}</p>{{ end -}}
+            {{ with $description }}<p class="card-text {{ if $color }}link-bg-{{ $color }}{{ else }}card-body-link{{ end }}">{{ . }}</p>{{ end -}}
         </a>
     {{- else -}}
         <div>
-            <p class="card-title fs-5 fw-bold">{{ $title }}</p>
-            {{ with $description }}<p class="card-text mb-4">{{ . }}</p>{{ end -}}
+            {{ with $title }}<p class="card-title fs-5 fw-bold">{{ . }}</p>{{ end -}}
+            {{ with $description }}<p class="card-text">{{ . }}</p>{{ end -}}
         </div>
     {{- end -}}
 {{- end -}}
@@ -82,9 +86,11 @@
 {{- end }}
 
 {{- $title := .title -}}
+{{- $alt := .alt -}}
 {{- $href := .href -}}
 {{- $description := .description -}}
 {{- $thumbnail := .thumbnail -}}
+{{- $ratio := .ratio -}}
 {{- $icon := .icon -}}
 
 {{- $color := "" -}}
@@ -126,6 +132,12 @@
     {{- errorf "partial [assets/card.html] - Invalid value for param 'padding': %s" $padding -}}
 {{- end -}}
 
+{{- $gutter := .gutter | default "0" -}}
+{{ $supportedGutters:= slice "0" "1" "2" "3" "4" "5" -}}
+{{ if not (in $supportedGutters $gutter) -}}
+    {{- errorf "partial [assets/card.html] - Invalid value for param 'gutter': %s" $gutter -}}
+{{ end -}}
+
 {{- $orientation := "stacked" -}}
 {{- with .orientation }}{{ $orientation = . }}{{ end -}}
 {{- $supportedOrientations := slice "stacked" "horizontal" "horizontal-sm" "none" -}}
@@ -134,15 +146,16 @@
 {{- end -}}
 {{- if eq $orientation "none" }}{{ $thumbnail = "" }}{{ $icon = "" }}{{ end -}}
 
+{{ if ne $gutter "0" }}<div class="g-{{ $gutter }}">{{ end }}
 {{- if hasPrefix $orientation "horizontal" -}}
     <div class="card {{ with $color }}bg-{{ . }} text-bg-{{ . }}{{ end }} {{ $class }}">
         <div class="row g-0 row-cols-1 h-100">
             <div class="col-4{{ if eq  $orientation "horizontal-sm" }} col-md-2{{ end }}">
                 {{- if $thumbnail -}}
-                    {{- partial "assets/image.html" (dict "url" $thumbnail "ratio" "1x1" "outerClass" "h-100 card-img-wrap" "innerClass" "rounded-start card-img-h100" "title" $title) -}}
+                    {{- partial "assets/image.html" (dict "url" $thumbnail "ratio" (or $ratio "1x1") "outerClass" "h-100 card-img-wrap" "innerClass" "rounded-start card-img-h100" "title" $title) -}}
                 {{- else if $icon -}}
-                    <div class="p-{{ $padding }} h-100 fa-wrapper d-flex align-items-center justify-content-center">
-                        {{- partial "assets/icon.html" (dict "icon" (printf "%s fa-fluid text-secondary fa-fw" $icon)) -}}
+                    <div class="card-icon p-{{ $padding }} h-100 fa-wrapper d-flex align-items-center justify-content-center">
+                        {{- partial "assets/icon.html" (dict "icon" (printf "%s fa-fluid fa-fw" $icon)) -}}
                     </div>
                 {{- end -}}
             </div>
@@ -160,10 +173,10 @@
 {{- else -}}
     <div class="card {{ with $color }}bg-{{ . }} text-bg-{{ . }}{{ end }} {{ $class }}">
         {{- if $thumbnail -}}
-            {{- partial "assets/image.html" (dict "url" $thumbnail "ratio" "16x9" "outerClass" "card-img-wrap" "innerClass" "card-img-top" "title" $title) -}}
+            {{- partial "assets/image.html" (dict "url" $thumbnail "ratio" (or $ratio "16x9") "outerClass" "card-img-wrap" "innerClass" "card-img-top" "title" (or $alt $title)) -}}
         {{- else if $icon -}}
-            <div class="p-{{ $padding }}">
-                {{- partial "assets/icon.html" (dict "icon" (printf "%s fa-4x text-secondary" $icon)) -}}
+            <div class="card-icon  p-{{ $padding }}">
+                {{- partial "assets/icon.html" (dict "icon" (printf "%s fa-4x" $icon)) -}}
             </div>
         {{- end -}}
         <div class="card-body d-flex flex-column p-{{ $padding }}">
@@ -173,3 +186,4 @@
         </div>
     </div>
 {{- end -}}
+{{ if ne $gutter "0" }}</div>{{ end }}

layouts/partials/assets/nav.html

@@ -9,6 +9,7 @@
     "class"         Optional class attribute of the tab group, e.g. “nav-fill”.
     "pane"          Optional style of the panes, either "none" (default) or "persona".
     "width"         Optional responsive width of the tab group, either "50" or "100" (default).
+    "wrap"          Optional flag to enable word wrapping of tab titles, defaults to false.
 
     In addition, the following arguments are passed to the individual tabs.
     "class"         Optional class attribute of the tab element, e.g. “w-50”.
@@ -54,6 +55,7 @@
 {{- $title := .title -}}
 {{- $class := .class -}}
 {{- $color := .color -}}
+{{- $wrap := .wrap | default false -}}
 
 {{ $supportedFlags := slice "true" "false" -}}
 {{ $verticalParam := "false" -}}
@@ -81,7 +83,7 @@
     <div class="nav{{ with $type }} nav-{{ . }}{{ end }}{{ with $class }} {{ . }}{{ end }}{{ if $vertical }} flex-column{{ end }}" id="nav-{{ $id }}" role="tablist"{{ if $vertical }} aria-orientation="vertical"{{ end }}>
         {{- range $index, $item := $list -}}
             {{ $show := eq $index 0}}
-            <button class="nav-link text-nowrap{{ if $show }} active{{ end }}" id="nav-{{ $id }}-btn-{{ $index }}" data-bs-toggle="pill" data-bs-target="#nav-{{ $id }}-{{ $index }}" 
+            <button class="nav-link {{ if not $wrap }} text-nowrap{{ end }}{{ if $show }} active{{ end }}" id="nav-{{ $id }}-btn-{{ $index }}" data-bs-toggle="pill" data-bs-target="#nav-{{ $id }}-{{ $index }}" 
                     type="button" role="tab" aria-controls="nav-{{ $id }}-{{ $index }}" aria-selected="{{ if eq $index 0 }}true{{ else }}false{{ end }}">
                 {{ $item.Title }}
             </button>

layouts/partials/assets/section-header.html

@@ -20,27 +20,6 @@
     {{- end -}}
 {{- end -}}
 
-<div class="container-fluid p-4 px-xxl-0">
-    {{ with $title }}<p class="display-4 mt-3{{ if and page.IsHome site.Params.home.centerHeadline }} text-center{{ end }}">{{ . }}</p>{{ end }}
-    {{ with $description }} <p class="lead mb-5">{{ . }}</p>{{ end }}
-    {{- if $content -}}
-        <div class="row row-cols-1 row-cols-lg-3 pt-5">
-            <div class="col col-lg-3 d-none d-lg-block"></div>
-            <div class="col col-sm-12 col-lg-6 text-center">
-                <div class="row row-cols-1{{ if ne $sectionHeader "justify-content-center" }} row-cols-sm-2{{ end }} row-gap-5 p-0 align-items-center flex-fill">
-                    {{- if eq $sectionHeader "justify-content-center" -}}
-                        <div class="col p-0 w-50 mx-auto pb-5">{{ partial "partials/section-header-img.html" (dict "title" $title "thumbnail" $thumbnail "icon" $icon )}}</div>
-                        <div class="col fs-md-5 fs-6">{{ $content }}</div>
-                    {{- else if eq $sectionHeader "justify-content-end" -}}
-                        <div class="col p-0">{{ partial "partials/section-header-img.html" (dict "title" $title "thumbnail" $thumbnail "icon" $icon )}}</div>
-                        <div class="col fs-md-5 fs-6 text-sm-start">{{ $content }}</div>
-                    {{- else -}}
-                        <div class="col fs-md-5 fs-6 text-sm-start">{{ $content }}</div>
-                        <div class="col p-0">{{ partial "partials/section-header-img.html" (dict "title" $title "thumbnail" $thumbnail "icon" $icon )}}</div>
-                    {{- end -}}
-                </div>
-            </div>
-            <div class="col col-lg-3 d-none d-lg-block"></div>
-        </div>
-    {{- end -}}
-</div>
+{{ with $title }}<p id="{{ anchorize . }}" class="display-4 pt-4{{ if and page.IsHome site.Params.home.centerHeadline }} text-center{{ end }}">{{ . }}</p>{{ end }}
+{{ with $description }} <p class="lead mb-5">{{ . }}</p>{{ end }}
+{{ $content }}

layouts/partials/assets/section-list.html

@@ -14,7 +14,9 @@
 {{- $moreTitle := .moreTitle -}}
 {{- $sectionURL := .sectionURL -}}
 {{- $nested := .nested | default true -}}
+{{- $simple := .simple | default false -}}
 {{- $paginate := true -}}
+{{- $kind := .kind | default "regular" -}}
 {{- $sort := "date" -}}
 {{- $order := "desc" -}}
 {{- $separator := false -}}
@@ -32,6 +34,8 @@
 {{- $type := "pills" -}}
 {{- $vertical := "false" -}}
 {{- $width := 100 -}}
+{{- $ratio := "" -}}
+{{- $wrap := false -}}
 
 {{- with (index site.Params.sections $section) -}}
     {{- with index . "title" }}{{ $title = or $.title . }}{{ end -}}
@@ -54,13 +58,25 @@
     {{- with index . "type" }}{{ $type = . }}{{ end -}}
     {{- with index . "vertical" }}{{ $vertical = . }}{{ end -}}
     {{- with index . "width" }}{{ $width = . }}{{ end -}}
+    {{- with index . "kind" }}{{ $kind = . }}{{ end -}}
+    {{- with index . "ratio" }}{{ $ratio = . }}{{ end -}}
+    {{- with index . "wrap" }}{{ $wrap = . }}{{ end -}}
 {{- end -}}
 {{ if ne (printf "%T" $nested) "bool" }}
     {{ errorf "partial [assets/section-list.html] - Invalid value for param 'nested'"}}
 {{ end }}
 
-{{ $list := "" }}
-{{ if $nested }}
+{{ $list := slice }}
+{{ if eq $kind "taxonomy" }}
+    {{ $filter := page.Params.filter }}
+    {{ with $filter }}
+        {{ with index site.Taxonomies $section $filter }}
+            {{ $list = .Pages }}
+        {{ end }}
+    {{ else }}
+        {{ $list = where site.Pages (printf ".Params.%s" $section) "!=" nil }}
+    {{ end }}
+{{ else if $nested }}
     {{ $list = where site.RegularPages "Type" "in" $section }}
 {{ else if $home }}
     {{ $sectionPage := site.GetPage "section" $section }}
@@ -88,12 +104,18 @@
         {{- $max = int (math.Min $homepage $max) -}}
     {{ end -}}
 
+    {{ if $simple }}
+        {{ $title = "" }}
+        {{ $background = "" }}
+    {{ end }}
+
     {{- $params := (dict 
         "page" $page
         "list" $list
         "title" $title
         "icon" $icon
         "thumbnail" $thumbnail
+        "ratio" $ratio
         "sectionHeader" $sectionHeader
         "description" $description
         "content" $content
@@ -103,8 +125,8 @@
     -}}
     {{- $partial := "" -}}
 
-    <div class="container-fluid {{ with $background }} bg-{{ . }}{{  end }}">
-        <div class="container-xxl flex-fill p-0">
+    <div class="container-fluid {{ with $background }} bg-{{ . }}{{ end }} p-0">
+        <div class="container-xxl flex-fill p-4 px-xxl-0 pb-5">
             {{- partial "assets/section-header.html" $params -}}
             
             {{ if eq $layout "card" }}
@@ -131,6 +153,7 @@
                     "type" $type
                     "vertical" $vertical
                     "width" $width
+                    "wrap" $wrap
                     ) 
                 -}}
             {{- else -}}

layouts/partials/assets/section-menu.html

@@ -0,0 +1,20 @@
+{{- $page := . -}}
+{{ $items := $page.Parent.Sections }}
+{{ if not $page.Parent.Section }}
+    {{ $items = $page.Sections }}
+{{ end }}
+
+{{- if gt (len $items) 0 }}
+    <nav class="navbar navbar-expand navbar-services p-0 fs-5">
+        <div class="container-fluid p-0 pb-3">
+            <div class="collapse navbar-collapse" id="navbarNav">
+                <ul class="navbar-nav">
+                    {{- range $items }}
+                        {{ $active := eq $page.RelPermalink .RelPermalink }}
+                        <li class="nav-item"><a class="nav-link{{ if $active }} active{{ end }}" href="{{ .RelPermalink }}">{{ .Title }}</a></li>
+                    {{- end }}
+                </ul>
+            </div>
+        </div>
+    </nav>
+{{- end }}

layouts/partials/assets/sharing.html

@@ -6,7 +6,7 @@
         {{- if .Site.Params.sharing.reverse }}{{ $order = "desc" }}{{ else }}{{ $order = "asc" }}{{ end -}}
         {{- $sort := .Site.Params.sharing.sort | default "weight" -}}
         {{- $list = sort $list $sort $order -}}
-        <div class="py-3 text-body-secondary hstack gap-2">
+        <div class="py-3 text-body-secondary hstack gap-1">
             {{ T "shareLink" "" }}
             {{- range $index, $item := $list -}}
                 {{- $url := $item.url -}}
@@ -21,11 +21,11 @@
                     {{- $url = "#!" -}}
                     {{- partial "assets/toast.html" (dict "id" $target "message" (printf "%s %s" (T "link")  (T "copiedToClipboard"))) -}}
                 {{- end -}}
-                {{ partial "assets/button.html" (dict "toast" $target "clipboard" $clipboard "href" $url "icon" (printf "%s fa-fw" $item.icon) "class" "btn-social p-0" "label" (T "shareLink" $item.name)) }}
+                {{ partial "assets/button.html" (dict "toast" $target "clipboard" $clipboard "href" $url "icon" (printf "%s fa-fw" $item.icon) "class" "btn-social p-0" "label" (T "shareLink" $item.name) "spacing" false) }}
             {{- end -}}
             {{ if .Site.Params.sharing.webshare }}
                 {{ $attr := dict "data-sharing-title" .Title "data-sharing-description" .Description "data-sharing-url" .Permalink }}
-                {{ partial "assets/button.html" (dict "href" "#!" "icon" "fas share-nodes fa-fw" "id" "btn-webshare" "class" "btn-social p-0" "attributes" $attr "label" (T "shareLink" (T "shareSystem"))) }}
+                {{ partial "assets/button.html" (dict "href" "#!" "icon" "fas share-nodes fa-fw" "id" "btn-webshare" "class" "btn-social p-0" "attributes" $attr "label" (T "shareLink" (T "shareSystem")) "spacing" false) }}
             {{- end -}}
         </div>
     {{- end -}}

layouts/partials/assets/sidebar.html

@@ -9,9 +9,10 @@
     {{- $level := .level -}}
     {{- $baseURL := .baseURL -}}
     {{- $group := .group -}}
+    {{- $data := .menu -}}
 
     {{- $doc_slug := $group.title | urlize -}}
-    {{- $href := printf "%s/" (relLangURL (path.Join $baseURL $doc_slug)) -}}
+    {{- $href := or $group.link (printf "%s/" (relLangURL (path.Join $baseURL $doc_slug))) -}}
     {{- $collapsed := strings.HasPrefix $page.RelPermalink $href -}}
 
     <li class="mb-1">
@@ -28,6 +29,7 @@
                             "level" (add $level 1)
                             "baseURL" $href
                             "group" $item
+                            "menu" $data
                             )
                         }}
                     {{- else -}}
@@ -37,6 +39,8 @@
                             "level" $level
                             "baseURL" $href
                             "title" $item.title
+                            "href" $item.link
+                            "menu" $data
                             )
                         }}
                     {{ end -}}
@@ -47,15 +51,17 @@
 {{ end -}}
 
 {{- define "partials/sidebar/item.html" -}}
-    {{ $page := .page }}
-    {{ $sectionBreak := .sectionBreak }}
+    {{- $page := .page -}}
+    {{- $sectionBreak := .sectionBreak -}}
     {{- $level := .level -}}
-    {{ $baseURL := .baseURL}}
-    {{ $title := .title}}
+    {{- $baseURL := .baseURL -}}
+    {{- $title := .title -}}
+    {{- $href := .href -}}
+    {{- $data := .menu -}}
 
     {{- $doc_slug := $title | urlize -}}
-    {{- $href := printf "%s/" (relLangURL (path.Join $baseURL $doc_slug)) -}}
-    {{ $active := eq $page.RelPermalink $href }}
+    {{- $href := or $href (printf "%s/" (relLangURL (path.Join $baseURL $doc_slug))) -}}
+    {{- $active := eq (strings.TrimSuffix "/" $page.RelPermalink) (strings.TrimSuffix "/" $href) -}}
 
     {{ if eq $level 0}}
         <li class="mt-1 mb-1 {{ if $sectionBreak }}border-top{{ end }}"></li>
@@ -63,17 +69,27 @@
         <li>
             <ul class="btn-toggle-nav list-unstyled fw-bold pb-1">
                 <li>
-                    <a href="{{ $href }}" class="sidebar-item text-decoration-none rounded {{ if $active }}active{{ end }}">
-                        {{ $title }}
-                    </a>      
+                    {{ $class := "sidebar-item text-decoration-none rounded" }}
+                    {{ if $active }}{{ $class = printf "%s active" $class }}{{ end }}
+                    {{ $link := partial "utilities/link.html" (dict "destination" $href "text" $title "class" $class "page" $page) }}
+                    {{ if $link }}
+                        {{ print $link | safeHTML }}
+                    {{ else }}
+                        {{- errorf "partial [utilities/sidebar.html] - Invalid link in file: %s" ($page.Scratch.Get "sidebarFilename") -}}
+                    {{ end }}
                 </li>
             </ul>
         </li>
     {{ else }}
         <li>
-            <a href="{{ $href }}" class="sidebar-item text-decoration-none rounded small {{ if $active }}active{{ end }}">
-                {{ $title }}
-            </a>      
+            {{ $class := "sidebar-item text-decoration-none rounded small" }}
+            {{ if $active }}{{ $class = printf "%s active" $class }}{{ end }}
+            {{ $link := partial "utilities/link.html" (dict "destination" $href "text" $title "class" $class "page" $page) }}
+            {{ if $link }}
+                {{ print $link | safeHTML }}
+            {{ else }}
+                {{- errorf "partial [utilities/sidebar.html] - Invalid link in file: %s" ($page.Scratch.Get "sidebarFilename") -}}
+            {{ end }}
         </li>
     {{ end }}
 {{ end -}}
@@ -94,6 +110,7 @@
                     "level" (add $level 1)
                     "baseURL" $baseURL
                     "group" $item
+                    "menu" $data
                     )
                 }}
             {{- else }}
@@ -103,6 +120,8 @@
                     "level" $level
                     "baseURL" $baseURL
                     "title" $item.title
+                    "href" $item.link
+                    "menu" $data
                     )
                 }}
             {{- end }}

layouts/partials/assets/toc-main.html

@@ -0,0 +1,20 @@
+{{ $headings := .headings | default slice }}
+{{- range .Fragments.Headings }}
+    {{- range .Headings }}
+        {{- $headings = $headings | append .Title -}}
+    {{- end -}}
+{{- end -}}
+
+{{- if gt (len $headings) 1 }}
+<nav class="navbar navbar-expand navbar-services p-0 fs-5">
+    <div class="container-fluid p-0 pb-3 border-bottom">
+        <div class="collapse navbar-collapse" id="navbarNav">
+                <ul class="navbar-nav">
+                    {{- range $headings }}
+                        <li class="nav-item"><a class="nav-link" href="#{{ anchorize . }}">{{ . }}</a></li>
+                    {{- end }}
+                </ul>
+        </div>
+    </div>
+</nav>
+{{- end }}

layouts/partials/assets/toc.html

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

layouts/partials/footer/social.html

@@ -7,27 +7,29 @@
 
 {{ if gt .Site.Menus.social 0 }}
     {{- $tab := site.Params.main.externalLinks.tab -}}
-    <div class="container-fluid">
-        <div class="row row-cols-1 row-cols-sm-4 bg-primary p-3 bg-opacity-{{ .Site.Params.style.themeOpacity | default "25" | safeHTML }} align-items-center">
-            <div class="col col-md-2 d-none d-md-block"></div>
-            <div class="col col-sm-6 col-md-4">
-                {{ if gt .Site.Menus.social 0 }}
-                    <div class="fs-3 fw-bold">{{ or .Site.Params.footer.socialTitle .Site.Params.social.title }}</div>
-                    <p>{{ or .Site.Params.footer.socialCaption .Site.Params.social.caption }}</p>
-                {{ end }}
+    <div class="container-fluid bg-primary bg-opacity-{{ .Site.Params.style.themeOpacity | default "25" | safeHTML }}">
+        <div class="container-xxl px-4 px-xxl-0">
+            <div class="row row-cols-2 py-3 align-items-center">
+                <div class="col col-6">
+                    <div class="row justify-content-end p-0">
+                        <div class="col-12 col-md-8 p-0">
+                            <div class="fs-3 fw-bold">{{ or .Site.Params.footer.socialTitle .Site.Params.social.title }}</div>
+                            <p>{{ or .Site.Params.footer.socialCaption .Site.Params.social.caption }}</p>
+                        </div>
+                    </div>
+                </div>
+                <div class="col col-6 text-sm-start">
+                    {{ range .Site.Menus.social -}}
+                        <a href="{{ .URL }}" {{ if $tab }} target="_blank" rel="noopener noreferrer"{{ end }} aria-label="{{ .Name | safeHTML }}" class="text-decoration-none link-secondary d-inline p-2">
+                            {{ if hasPrefix .Pre "<i" }}
+                                {{ .Pre | safeHTML }}
+                            {{ else }}
+                                {{ partial "assets/icon.html" (dict "icon" (printf "%s fa-2x" .Pre) )}}
+                            {{ end }}
+                        </a>
+                    {{ end -}}
+                </div>
             </div>
-            <div class="col text-sm-start text-center col-sm-6 col-md-4">
-                {{ range .Site.Menus.social -}}
-                    <a href="{{ .URL }}" {{ if $tab }} target="_blank" rel="noopener noreferrer"{{ end }} aria-label="{{ .Name | safeHTML }}" class="text-decoration-none link-secondary d-inline p-2">
-                        {{ if hasPrefix .Pre "<i" }}
-                            {{ .Pre | safeHTML }}
-                        {{ else }}
-                            {{ partial "assets/icon.html" (dict "icon" (printf "%s fa-2x" .Pre) )}}
-                        {{ end }}
-                    </a>
-                {{ end -}}
-            </div>
-            <div class="col col-md-2 d-none d-md-block"></div>
         </div>
     </div>
 {{ end }}

layouts/partials/head/head.html

@@ -3,7 +3,7 @@
     <meta charset="utf-8">
     <meta name="viewport" content="width=device-width, initial-scale=1">
     {{ hugo.Generator}}
-    {{ partial "head/stylesheet.html" -}}
+    {{ partialCached "head/stylesheet-core.html" . -}}
     {{- $modules := site.Params.modules.optional | intersect .Page.Params.modules -}}
     {{- range $index, $mod := $modules -}}
         {{- $source := printf "scss/%s.scss" $mod -}}

layouts/partials/head/stylesheet-core.html

@@ -0,0 +1,3 @@
+{{/* Wrapper for the stylesheet partial with default arguments. */}}
+{{/* Added to avoid interference with the argument of partialCached. */}}
+{{ partial "head/stylesheet.html" -}}

layouts/partials/head/stylesheet.html

@@ -1,5 +1,14 @@
+{{- $transpiler := site.Params.main.build.transpiler | default "libsass" -}}
+{{- $supportedTranspilers := slice "libsass" "dartsass" -}}
+{{- if not (in $supportedTranspilers $transpiler) -}}
+    {{- errorf "partial [head/stylesheet.html] - Invalid value for param 'transpiler': %s" $transpiler -}}
+{{- end -}}
+
 {{- $absoluteURL := site.Params.main.canonifyAssetsURLs | default false -}}
-{{- $source := .source | default "scss/app.scss" -}}
+{{- $source := .source }}
+{{- if not $source -}}
+    {{- if eq $transpiler "dartsass" }}{{ $source = "scss/app-dart.scss" }}{{ else }}{{ $source = "scss/app.scss" }}{{ end -}}
+{{- end -}}
 {{- $target := .target | default "css/main.css" -}}
 {{- $page := .page -}}
 {{- $core := .core | default true -}}
@@ -21,6 +30,7 @@
 {{- if site.Params.navigation.fixed }}{{ $navbarOffset = site.Params.navigation.offset | default "4em" }}{{ end }}
 {{- $vars := dict 
     "theme-font"              (default "Inter" site.Params.style.themeFont)
+    "font-size-base"          (default "1rem" site.Params.style.fontSizeBase)
     "primary"                 (default "#007bff" site.Params.style.primary)
     "secondary"               (default "#6c757d" site.Params.style.secondary)
     "success"                 (default "#198754" site.Params.style.success)
@@ -36,22 +46,24 @@
     "dark-mode-tint"          (default "0%" site.Params.style.darkModeTint)
 -}}
 
-{{- $options := (dict "transpiler" "libsass" "targetPath" $target "enableSourceMap" (not hugo.IsProduction) "vars" $vars) -}}
+{{- $options := (dict "transpiler" $transpiler "targetPath" $target "enableSourceMap" (not hugo.IsProduction) "vars" $vars) -}}
 {{- $bundle := partial "utilities/bundle" (dict "match" $source "filename" (printf "scss/bundle-%d.scss" now.UnixNano) "modules" $modules "basepath" "scss" "debugging" site.Params.debugging.showSCSS) -}}
 
-{{- $css := $bundle | resources.ExecuteAsTemplate $target . | toCSS $options -}}
+{{- if gt ($bundle.Content | len) 0 }}
+    {{- $css := $bundle | resources.ExecuteAsTemplate $target . | toCSS $options -}}
 
-{{ if $core }}
-    {{- partial "head/icons.html" (dict "css" $css) -}}
-{{ end }}
-{{- if site.Params.style.purge -}}
-    {{- $post_options := dict "config" "config" -}}
-    {{- $css = $css | resources.PostCSS $post_options -}}
-{{- end -}}
+    {{ if $core }}
+        {{- partial "head/icons.html" (dict "css" $css) -}}
+    {{ end }}
+    {{- if site.Params.style.purge -}}
+        {{- $post_options := dict "config" "config" -}}
+        {{- $css = $css | resources.PostCSS $post_options -}}
+    {{- end -}}
 
-{{- if not hugo.IsProduction -}}
-    <link rel="stylesheet" href="{{ if $absoluteURL }}{{ $css.Permalink }}{{ else }}{{ $css.RelPermalink }}{{ end }}">
-{{- else -}}
-    {{- $css = $css | fingerprint | resources.PostProcess -}}
-    <link rel="stylesheet" href="{{ if $absoluteURL }}{{ $css.Permalink }}{{ else }}{{ $css.RelPermalink }}{{ end }}" integrity="{{ $css.Data.Integrity }}" crossorigin="anonymous">
+    {{- if not hugo.IsProduction -}}
+        <link rel="stylesheet" href="{{ if $absoluteURL }}{{ $css.Permalink }}{{ else }}{{ $css.RelPermalink }}{{ end }}">
+    {{- else -}}
+        {{- $css = $css | fingerprint | resources.PostProcess -}}
+        <link rel="stylesheet" href="{{ if $absoluteURL }}{{ $css.Permalink }}{{ else }}{{ $css.RelPermalink }}{{ end }}" integrity="{{ $css.Data.Integrity }}" crossorigin="anonymous">
+    {{- end -}}
 {{- end -}}

layouts/partials/home/featured.html

@@ -1,21 +0,0 @@
-<div class="container-fluid flex-fill feature">
-    <div class="row row-cols-1 row-cols-sm-4 h-100 bg-primary px-4 py-5 bg-opacity-{{ .Site.Params.style.themeOpacity | default "25" | safeHTML }} align-items-center">
-        <div class="col col-lg-2 d-none d-lg-block bg-info order-1"></div>
-        <div class="col col-sm-6 col-lg-4 text-center text-sm-start order-3 order-sm-2">
-            <p class="display-4">{{ .Title }}</p>
-            <p>{{ .Content }}<p>
-        </div>
-        <div class="col text-sm-start text-center col-sm-6 col-lg-4 order-2 order-sm-3">
-            {{- $thumbnail := (or (and (reflect.IsMap .Params.Thumbnail) .Params.Thumbnail.url) .Params.Thumbnail) -}}
-            {{- $thumbnail = or $thumbnail .Site.Params.home.featurePhoto -}}
-            {{ if .Site.Params.home.featurePhoto }}
-                {{ warnf "DEPRECATED: parameter `Params.home.featurePhoto` has been deprecated in release v0.18"}}
-            {{ end }}
-            {{- if $thumbnail -}}
-                {{- partial "assets/image.html" (dict "url" $thumbnail "ratio" "16x9" "outerClass" "img-wrap" "innerClass" "rounded" "title" .Site.Title) -}}
-            {{ end }}
-            <div class="pb-5 d-block d-sm-none"></div>
-        </div>
-        <div class="col col-lg-2 d-none d-lg-block bg-info order-4"></div>
-    </div>
-</div>

layouts/partials/list/featured.html

@@ -0,0 +1,93 @@
+{{- $page := .page -}}
+{{- $headings := .headings -}}
+{{- $orientation := .orientation | default "stacked" -}}
+{{- $actions := .actions -}}
+{{- $width := .width | default 6 }}
+{{- if or (lt $width 1) (gt $width 12) -}}
+    {{- $width = 6 -}}
+    {{- warnf "partial [list/featured.html] - Invalid column width: %d" $width -}}
+{{ end -}}
+{{- $justify := .justify | default "center" -}}
+{{- $supportedJustify := slice "start" "end" "center" "between" "around" "evenly" -}}
+{{- if not (in $supportedJustify $justify) -}}
+    {{- errorf "partial [list/featured.html] - Invalid value for param 'justify': %s" $justify -}}
+{{- end -}}
+{{- $align := .align | default "center" -}}
+{{- $supportedAlign := slice "start" "end" "center" -}}
+{{- if not (in $supportedAlign $align) -}}
+    {{- errorf "partial [list/featured.html] - Invalid value for param 'align': %s" $align -}}
+{{- end -}}
+{{- $breadcrumb := and (not $page.IsHome) site.Params.navigation.breadcrumb -}}
+
+{{- define "partials/list/featured-body.html" }}
+    {{- $page := .page -}}
+    {{- $headings := .headings -}}
+    {{- $orientation := .orientation | default "stacked" -}}
+    {{- $actions := .actions -}}
+    {{- $align := .align | default "center" -}}
+
+    <div class="text-{{ $align }}">
+        {{ with $page.Title }}<p class="display-4">{{ . }}</p>{{ end }}
+        <span class="fs-5 text-muted">{{ $page.Description }}</span>
+
+        {{ if $actions }}
+            <div class="hstack{{ if gt (len $actions) 1 }} gap-3{{ end }} justify-content-{{ $align}} pt-5 pt-md-3">
+                {{ range $actions }}
+                    {{ partial "assets/button.html" (dict "href" .url "icon" .icon "title" .title "outline" .outline "order" "last" "justify" "start") }}
+                {{ end }}
+            </div>
+        {{ end }}
+    </div>
+{{- end -}}
+
+{{- define "partials/list/featured-illustration.html" }}
+    {{- $page := .page -}}
+    {{- $style := printf "img-wrap mx-auto mx-md-0 %s" .style -}}
+
+    {{ if $page.Params.icon }}
+        {{- $icon := (or (and (reflect.IsMap $page.Params.Icon) $page.Params.Icon.url) $page.Params.Icon) -}}
+        {{- $mode := and (reflect.IsMap $page.Params.Icon) $page.Params.Icon.mode -}}
+        {{ if eq (lower (path.Ext $icon)) ".json" }}
+            {{ partial "assets/animation.html" (dict "data" $icon "mode" $mode "loop" false "hover" true "class" "col-6 mx-auto text-center") }}
+        {{ else }}
+            {{ partial "assets/icon.html" (dict "icon" "mode" $mode $icon "wrapper" "col-6 mx-auto text-center")}}
+        {{ end }}
+    {{ else }}
+        {{- $thumbnail := (or (and (reflect.IsMap $page.Params.Thumbnail) $page.Params.Thumbnail.url) $page.Params.Thumbnail) -}}
+        {{- if $thumbnail }}
+            {{ partial "assets/image.html" (dict "url" $thumbnail "ratio" "16x9" "outerClass" $style "innerClass" "rounded" "title" .Site.Title) }}
+        {{ end }}
+    {{ end }}
+{{- end -}}
+
+<div class="container-fluid p-0 {{ with site.Params.home.feature.color }} bg-{{ . }} bg-opacity-{{ site.Params.style.themeOpacity | default "25" | safeHTML }}{{ end }}">
+    <div class="container-xxl {{ if $breadcrumb }} pb-4 px-4 {{ else }} p-4 {{ end }} px-xxl-0 {{ if site.Params.home.fullCover }} fullscreen{{ end }} d-flex flex-column">
+        {{ if $breadcrumb }}
+            <div>{{ partial "assets/breadcrumb.html" $page }}</div>
+        {{ end -}}
+
+        {{ if eq $orientation "stacked" }}
+            <div class="row justify-content-center flex-fill">
+                <div class="col-12 col-md-{{ $width }} m-auto text-center">
+                    {{ partial "partials/list/featured-illustration.html" (dict "page" $page "style" "pb-4") }}
+                    {{ partial "partials/list/featured-body.html" (dict "page" $page "headings" $headings "orientation" $orientation "actions" $actions) }}
+                </div>
+            </div>
+        {{ else }}
+            <div class="flex-fill row row-cols-1 row-cols-md-2 justify-content-{{ $justify }}">
+                <div class="col col-12 col-md-{{ $width }} order-1 order-md-0 my-md-auto">
+                    {{ partial "partials/list/featured-body.html" (dict "page" $page "headings" $headings "orientation" $orientation "actions" $actions "align" $align) }}
+                </div>
+                <div class="col col-12 col-md-{{ if gt $width 6 }}{{ sub 12 $width }}{{ else }}{{ $width }}{{ end }} order-0 order-md-1 text-center my-md-auto">
+                    {{ partial "partials/list/featured-illustration.html" (dict "page" $page "style" "pb-4 pb-md-0") }}
+                </div>
+            </div>
+        {{ end }}
+
+        {{ with $headings }}
+            <div class="col col-12 p-0 pt-5">
+                {{ partial "assets/toc-main.html" (dict "headings" .) }}
+            </div>
+        {{ end }}
+    </div>
+</div>

layouts/partials/utilities/GetArg.html

@@ -7,7 +7,8 @@
 {{ $page := .page -}}
 {{ $arg := .arg -}}
 {{ $merge := .merge -}}
-{{ $val := $page.Get $arg }}
+{{ $val := "" }}
+{{ with $page.Get $arg }}{{ $val = . }}{{ end }}
 
 {{- with $page.Parent -}}
     {{ with .Get $arg }}

layouts/partials/utilities/GetMenu.html

@@ -1,12 +1,17 @@
 {{- $page := .page -}}
 {{- $version := .version -}}
+{{- $sidebarFilename := "" -}}
 
 {{- $menu := "" -}}
 {{- if $page.IsPage -}}
-    {{- $menu = index site.Data (printf "%s-%s" $page.Section $version) -}}
+    {{- $sidebarFilename = printf "%s-%s" $page.Section $version -}}
+    {{- $menu = index site.Data $sidebarFilename -}}
     {{ if not $menu }}
-        {{ $menu = index site.Data $page.Section }}
+        {{- $sidebarFilename = $page.Section -}}
+        {{ $menu = index site.Data $sidebarFilename }}
     {{ end }}
 {{- end -}}
 
+{{ if $menu }}{{ with $sidebarFilename }}{{ $page.Scratch.Set "sidebarFilename" (path.Join "data" .) }}{{ end }}{{ end -}}
+
 {{- return $menu -}}

layouts/partials/utilities/ProcessContent.html

@@ -9,5 +9,5 @@
 {{- if site.Params.debugging.purgeHTMLComments -}}
     {{- $raw = replaceRE "<!--(.|\n)*?-->" "" $raw -}}
 {{- end -}}
-{{ $content := $raw | $page.RenderString | safeHTML }}
+{{ $content := emojify $raw | $page.RenderString }}
 {{ return $content }}

layouts/partials/utilities/link.html

@@ -3,6 +3,7 @@
     {{- errorf "partial [utilities/link.html] - Missing param 'destination'" -}}
 {{- end -}}
 
+{{- $error := false -}}
 {{- $target := "" -}}
 {{- $rel := "" -}}
 {{- $case := .case | default true }}
@@ -55,6 +56,7 @@
 
     {{- if not $ref -}}
         {{- errorf "partial [utilities/link.html] - Cannot find page: %s" $destination -}}
+        {{- $error = true -}}
     {{- else -}}
         {{- $destination = $ref.RelPermalink -}}
         {{- with $anchor }}{{ $destination = printf "%s#%s" (strings.TrimSuffix "/" $destination) . -}}{{ end -}}
@@ -69,4 +71,6 @@
     {{- end -}}
 {{- end -}}
 
-<a {{ with $class }}class="{{ . }}" {{ end }}href="{{ $destination | safeURL }}"{{ with $target }} target="{{ . }}"{{ end }}{{ with $rel }} rel="{{ . }}"{{ end }}>{{ $text }}</a>
+{{ if not $error -}}
+    <a {{ with $class }}class="{{ . }}" {{ end }}href="{{ $destination | safeURL }}"{{ with $target }} target="{{ . }}"{{ end }}{{ with $rel }} rel="{{ . }}"{{ end }}>{{ $text }}</a>
+{{- end }}

layouts/shortcodes/abbr.html

@@ -0,0 +1,68 @@
+<!-- 
+    Creates an HTML element that shows the long form of an abbrevitation. The abbreviation data is centrally stored in a
+    data file. By default, the shortcode uses "abbr.yaml" with translation support.
+    
+    The data file is expected to store key-value pairs, where "id" is the lower-case abbrevation and "long" its long
+    form. The following example illustrates this using YML:
+
+    - id: css
+      long: "Cascading Style Sheets"
+
+    The shortcode supports the following arguments:
+    "key"           Required case-insensitive key of the abbreviation. In shorthand notation, this is the first (and
+                    only) matched argument.
+    "data"          Optional filename of the abbrevation input. It defaults to "abbr.yaml" with translation support.
+                    You can omit the file extension. The file should reside in the "data" folder. The data supports
+                    language extensions. For example, "abbr.en.yaml" refers to the English translation of the
+                    abbrevation data. The filename "abbr.yaml" is used when no suitable translation is found.
+    "class"         Optional class attribute of the abbr element. For example, specify "initialism" for a slightly
+                    smaller font size.
+-->
+
+{{ $error := false }}
+
+{{ $key := "" }}
+{{- if .IsNamedParams }}{{ $key = .Get "key" }}{{ else }}{{ $key = .Get 0 }}{{ end }}
+
+{{ if not $key -}}
+    {{ errorf "Missing param 'key': %s" .Position -}}
+    {{ $error = true }}
+{{ end -}}
+
+{{- $data := .Get "data" | default "abbr" -}}
+{{ if not $data -}}
+    {{ errorf "Missing param 'data': %s" .Position -}}
+    {{ $error = true }}
+{{ end -}}
+
+{{- $class := .Get "class" | default "" -}}
+
+{{ if not $error }}
+    {{/* Try language-specific file first */}}
+    {{ $path := path.Join (path.Dir $data) (printf "%s.%s" (path.BaseName $data) .Page.Language.Lang) (path.Ext $data) }}
+    {{ $entries := index site.Data $path }}
+    {{/* Use exact provided path as backup */}}
+    {{ if not $entries -}}
+        {{ $entries = index site.Data $data }}
+    {{ end }}
+    {{ if not $entries -}}
+        {{ errorf "Invalid abbrevation data '%s': %s" $data .Position -}}
+        {{ $error = true }}
+    {{ end -}}
+
+    {{ $title := "" }}
+    {{ if not $error }}
+        {{ $elements := (where $entries "id" (lower $key)) }}
+        {{ if gt (len $elements) 0 }}
+            {{ $title = index (index $elements 0) "long" }}
+        {{ end -}}
+        {{ if not $title -}}
+            {{ errorf "Cannot find value for '%s': %s" $key .Position -}}
+            {{ $error = true }}
+        {{ end -}}
+    {{ end }}
+
+    {{ if not $error }}
+        <abbr {{ with $class }}class="{{ . }}"{{ end }} title="{{ $title }}">{{ $key }}</abbr>
+    {{ end }}
+{{ end }}

layouts/shortcodes/accordion-item.html

@@ -12,7 +12,7 @@
 {{- end -}}
 
 {{- $id := .Ordinal -}}
-{{ $header := .Get "header" -}}
+{{ $header := .Get "header" | default "" -}}
 {{ if not $header -}}
     {{ if .Parent }}
         {{ errorf "Missing value for param 'header': %s" .Parent.Position -}}
@@ -21,7 +21,7 @@
     {{ end }}
 {{ end -}}
 
-{{ $class := .Get "class" -}}
+{{ $class := .Get "class" | default "" -}}
 {{ $body := trim .Inner " \r\n" -}}
 {{ if not $body -}}
     {{ if .Parent }}

layouts/shortcodes/accordion.html

@@ -10,7 +10,7 @@
 {{ with .Get "id" }}
     {{ $id = . }}
 {{ end }}
-{{- $class := .Get "class" -}}
+{{- $class := .Get "class" | default "" -}}
 
 {{- $openParam := "false" -}}
 {{- $open := false -}}

layouts/shortcodes/alert.html

@@ -49,7 +49,7 @@
     {{ $error = true -}}
 {{ end -}}
 
-{{- $class := .Get "class" -}}
+{{- $class := .Get "class" | default "" -}}
 
 {{- if not $error -}}
     <div class="d-flex alert alert-{{ $color }} {{ if $dismissible }}alert-dismissible fade show{{ end }}{{ with $class }} {{ . }}{{ end }}" role="alert">

layouts/shortcodes/badge.html

@@ -7,8 +7,8 @@
 -->
 
 {{- $error := false -}}
-{{- $title := .Get "title" -}}
-{{- $class := .Get "class" -}}
+{{- $title := .Get "title" | default "" -}}
+{{- $class := .Get "class" | default "" -}}
 {{- $color := "secondary" -}}
 {{- with .Get "color" }}{{ $color = . }}{{ end -}}
 {{- $supportedColors := slice "primary" "secondary" "success" "danger" "warning" "info" "light" "dark" "white" "black" -}}

layouts/shortcodes/breadcrumb.html

@@ -5,7 +5,7 @@
 
 {{- $error := false -}}
 {{- $page := . -}}
-{{- $path := .Get "path"}}
+{{- $path := .Get "path" | default "" }}
 {{- if $path -}}
     {{- $page = .Site.GetPage $path -}}
     {{- if not $page -}}

layouts/shortcodes/button.html

@@ -26,12 +26,13 @@
                     "main.externalLinks.cue" in the site's parameters.
     "tab"           Optional flag to indicate if an external link should open in a new tab, defaults to setting
                     "main.externalLinks.tab" in the site's parameters.
+    "spacing"       Optional flag to add spacing to the inline button, defaults to "true".
 -->
 
 {{ $error := false }}
 {{ $type := "button" -}}
 
-{{- $icon := .Get "icon" }}
+{{- $icon := .Get "icon" | default "" }}
 {{ $title := trim .Inner " \r\n" | .Page.RenderString -}}
 {{ if not (or $title $icon) -}}
     {{ errorf "Missing icon or inner element text: %s" .Position -}}
@@ -71,17 +72,17 @@
     {{ errorf "Invalid value for param 'outline': %s" .Position -}}
 {{ end -}}
 
-{{ $badge := .Get "badge" -}}
-{{ $label := .Get "aria-label" -}}
-{{ $tooltip := .Get "tooltip" -}}
-{{ $collapse := .Get "collapse" -}}
-{{ $href := .Get "href" -}}
-{{ $relref := .Get "relref" }}
-{{ $id := .Get "id" -}}
+{{ $badge := .Get "badge" | default "" -}}
+{{ $label := .Get "aria-label" | default "" -}}
+{{ $tooltip := .Get "tooltip" | default "" -}}
+{{ $collapse := .Get "collapse" | default "" -}}
+{{ $href := .Get "href" | default "" -}}
+{{ $relref := .Get "relref" | default "" -}}
+{{ $id := .Get "id" | default "" -}}
 {{ if $relref }}
     {{ $href = relref . $relref }}
 {{ end }}
-{{ $class := .Get "class" -}}
+{{ $class := .Get "class" | default "" -}}
 
 {{ $placement := "top" -}}
 {{ with .Get "placement" }}{{ $placement = . }}{{ end -}}
@@ -91,7 +92,7 @@
     {{ $error = true }}
 {{ end -}}
 
-{{- $toast := .Get "toast" -}}
+{{- $toast := .Get "toast" | default "" -}}
 
 {{- $order := "last" -}}
 {{- with .Get "order" }}{{ $order = . }}{{ end -}}
@@ -112,6 +113,8 @@
 {{- $cue := .Get "cue" | default site.Params.main.externalLinks.cue -}}
 {{- $tab := .Get "tab" | default site.Params.main.externalLinks.tab -}}
 
+{{- $spacing := .Get "spacing" | default (not .Parent) -}}
+
 {{ if not $error }}
     {{- $output := partial "assets/button.html" (dict 
         "type" $type
@@ -133,7 +136,8 @@
         "justify" $justify
         "cue" $cue
         "tab" $tab
-        "toast" $toast)
+        "toast" $toast
+        "spacing" $spacing)
     -}}
 
     {{- if .Parent -}}

layouts/shortcodes/card-group.html

@@ -8,7 +8,9 @@
     "cols"          Required number of columns for the grid, must be a value between 1 and 5.
     "title"         Optional title of the card group.
     "separator"     Optional flag to indicate a horizontal line should be added between items on small screens.
-    "gutter"        Gutter between columns in a group, either "0", "1", "2", "3" (default), "4", or "5".
+    "gutter"        Gutter between columns in a group, either "0", "1", "2", "3", "4" (default), or "5".
+    "wrapper"       Optional class attributes of the wrapper element, e.g. "p-4 px-xxl-0".
+    "responsive"    Optional flag if the number of columns should be responsive, defaults to "true".
 
     In addition, the following arguments are passed to the individual cards.
     "class"         Optional class attribute of the card element, e.g. “w-50”.
@@ -22,24 +24,35 @@
     "orientation"   Optional placecement of the thumbnail, either "stacked" (default), "horizontal", or "none".
 -->
 
-{{- $cols := 3 -}}
-{{ with .Get "cols" }}{{ $cols = int . }}{{ end -}}
-{{- $title := .Get "title" -}}
-{{- $separator := .Get "separator" -}}
-{{- $class := .Get "class" -}}
-{{- $wrapper := .Get "wrapper" -}}
-{{- $color := .Get "color" -}}
+{{- $cols := .Get "cols" | default "3" -}}
+{{- $gutter := .Get "gutter" | default "4" -}}
+{{- $title := .Get "title" | default "" -}}
+{{- $separator := .Get "separator" | default "" -}}
+{{- $class := .Get "class" | default "" -}}
+{{- $wrapper := .Get "wrapper" | default "" -}}
+{{- $responsive := .Get "responsive" | default true -}}
+{{- $color := .Get "color" | default "" -}}
 {{- $padding := .Get "padding" | default "3" -}}
-{{- $header := .Get "header" -}}
-{{- $footer := .Get "footer" -}}
-{{- $orientation := .Get "orientation" -}}
+{{- $header := .Get "header" | default "" -}}
+{{- $footer := .Get "footer" | default "" -}}
+{{- $orientation := .Get "orientation" | default "" -}}
+
+{{ $inner := .Scratch.Get "inner" }}
+{{ $input := trim .Inner " \r\n" }}
+{{ if $input }}
+    {{ $input = replace $input "\n" "\n  " }}
+    {{ warnf "Unexpected inner content: %s\r\n      %s" .Position $input }}
+{{ end }}
 
 {{- partial "assets/card-group.html" (dict 
     "page" .Page
-    "cards" .Inner
+    "cards" $inner
     "cols" $cols
+    "gutter" $gutter
     "title" $title
     "separator" $separator
+    "wrapper" $wrapper
+    "responsive" $responsive
     "class" $class
     "color" $color
     "padding" $padding

layouts/shortcodes/card.html

@@ -1,5 +1,5 @@
 <!-- 
-    Displays a Bootstrap card that links to a page. Any inner text is used as description The shortcode supports the
+    Displays a Bootstrap card that links to a page. Any inner text is used as description. The shortcode supports the
     following arguments:
     "path"          Optional path of the page. If omitted, specify the title, icon, thumbnail, and body as needed. 
     "title"         Optional title of the card.
@@ -8,19 +8,20 @@
                     "warning", "info", "light", "dark", "white", "black", "body", or "body-tertiary". By default, no
                     color is specified.
     "padding"       Optional padding of the content, either "0", "1", "2", "3", "4", "5", or "auto" (default).
-    "gutter"        Gutter between columns in a group, either "0", "1", "2", "3" (default), "4", or "5".
+    "gutter"        Gutter between columns in a group, either "0" (default), "1", "2", "3", "4", or "5".
     "header"        Optional header components of the card, displayed in small caps. Supported values are "full"
                     (default), "publication", "tags", and "none".
     "footer"        Optional footer components of the card, displayed in small caps. Supported values are "full",
                     "publication", "tags", and "none" (default).
     "orientation"   Optional placecement of the thumbnail, either "stacked" (default), "horizontal", or "none".
     "thumbnail"     Optional thumbnail image url, displayed on top or the left of the card.
+    "alt"           Optional alternate text for the thumbnail, uses "title" by default.
     "icon"          Optional Font Awesome icon, displayed on top or the left of the card.
 -->
 
 {{ $error := false }}
 
-{{ $path := .Get "path" }}
+{{ $path := or (.Get "path") "" }}
 {{ $page := .Page }}
 {{ with $path }}
     {{ $page = $.Site.GetPage $path }}
@@ -59,7 +60,7 @@
     {{ $error = true -}}
 {{ end -}}
 
-{{- $gutter := partial "utilities/GetArg" (dict "page" . "arg" "gutter") | default "3" -}}
+{{- $gutter := partial "utilities/GetArg" (dict "page" . "arg" "gutter") | default "0" -}}
 {{ $supportedGutters:= slice "0" "1" "2" "3" "4" "5" -}}
 {{ if not (in $supportedGutters $gutter) -}}
     {{ errorf "Invalid value for param 'gutter': %s" .Position -}}
@@ -81,24 +82,40 @@
 {{ end -}}
 
 {{ $description := trim .Inner " \r\n" | .Page.RenderString | safeHTML }}
-{{ $title := .Get "title" }}
-{{ $icon := .Get "icon" }}
-{{ $thumbnail := .Get "thumbnail" }}
+{{ $title := .Get "title" | default "" -}}
+{{ $alt := .Get "alt" | default "" -}}
+{{ $icon := .Get "icon" | default "" -}}
+{{ $thumbnail := .Get "thumbnail" | default "" -}}
+
+{{ if .Parent }}
+    {{ $class = (printf "h-100 %s" $class) }}
+{{ end }}
 
 {{ if not $error -}}
-    <div class="g-{{ $gutter }}">
-        {{- partial "assets/card.html" (dict 
-            "path" $path
-            "title" $title
-            "class" (printf "h-100 %s" $class)
-            "color" $color
-            "padding" $padding
-            "header" $header
-            "footer" $footer
-            "orientation" $orientation
-            "description" $description
-            "icon" $icon
-            "thumbnail" $thumbnail
-        ) -}}
-    </div>
+    {{- $output := partial "assets/card.html" (dict 
+        "path" $path
+        "title" $title
+        "class" $class
+        "gutter" $gutter
+        "color" $color
+        "padding" $padding
+        "header" $header
+        "footer" $footer
+        "orientation" $orientation
+        "description" $description
+        "icon" $icon
+        "thumbnail" $thumbnail
+        "alt" $alt
+    ) -}}
+
+    {{ with .Parent }}
+        {{ $current := .Scratch.Get "inner" }}
+        {{ if $current }}
+            {{ .Scratch.Set "inner" (print $current $output) }}
+        {{ else }}
+            {{ .Scratch.Set "inner" $output }}
+        {{ end }}
+    {{ else }}
+        {{ print $output | safeHTML }}
+    {{ end }}
 {{ end -}}

layouts/shortcodes/carousel.html

@@ -14,7 +14,7 @@
     {{ $id = . }}
 {{ end }}
 
-{{ $class := .Get "class" -}}
+{{ $class := .Get "class" | default "" -}}
 
 {{ $inner := .Scratch.Get "inner" }}
 {{ $input := trim .Inner " \r\n" }}

layouts/shortcodes/collapse.html

@@ -4,12 +4,12 @@
     "class"         Optional class attribute of the inner panel element, e.g. “p-3”.
 -->
 
-{{ $id := .Get "id" -}}
+{{ $id := .Get "id" | default "" -}}
 {{ if not $id -}}
     {{ errorf "Missing value for param 'id': %s" .Position -}}
 {{ end -}}
 
-{{ $class := .Get "class" }}
+{{ $class := .Get "class" | default "" }}
 
 {{- $body := trim .Inner " \r\n" -}}
 {{ if not $body -}}

layouts/shortcodes/command.html

@@ -8,9 +8,9 @@
     "class"         Optional class attribute of the command element.
 -->
 
-{{- $host := .Get "host" -}}
-{{- $user := .Get "user" -}}
-{{- $prompt := .Get "prompt" -}}
+{{- $host := .Get "host" | default "" -}}
+{{- $user := .Get "user" | default "" -}}
+{{- $prompt := .Get "prompt" | default "" -}}
 {{- $filter := "(out)" -}}
 {{- $input := trim .Inner " \t\r\n" -}}
 
@@ -70,7 +70,7 @@
     {{- $output = (replace $output "<span class=\"c\">#" "<span class=\"c\">" | safeHTML) -}}
 {{- end -}}
 
-{{- $class := .Get "class" -}}
+{{- $class := .Get "class" | default "" -}}
 
 <div class="mb-3 syntax-highlight{{ with $class }} {{ . }}{{ end }}">
     {{- $output -}}

layouts/shortcodes/docs.html

@@ -19,9 +19,9 @@
     "class"         Optional class argument of the tab control.
 -->
 
-{{- $name := .Get "name" -}}
+{{- $name := .Get "name" | default "" -}}
 {{- $basePath := .Site.Params.docs.basePath -}}
-{{- $file := .Get "file" }}
+{{- $file := .Get "file" | default "" -}}
 {{- if hasPrefix $file "./" -}}
     {{- $file = path.Clean $file -}}
 {{- else -}}
@@ -68,7 +68,7 @@
     {{ errorf "Invalid value for param 'full': %s" $fullParam -}}
 {{ end -}}
 
-{{- $class := .Get "class" -}}
+{{- $class := .Get "class" | default "" -}}
 
 {{- /* If any parameters are missing, print an error and exit */ -}}
 {{- if or (not $name) (not $file) -}}

layouts/shortcodes/example.html

@@ -11,8 +11,8 @@
     "class"         Optional class attributes of the element's container.
 -->
 
-{{- $id := .Get "id" -}}
-{{- $class := .Get "class" -}}
+{{- $id := .Get "id" | default "" -}}
+{{- $class := .Get "class" | default "" -}}
 {{- $lang := .Get "lang" | default "markdown" -}}
 {{- $show_markup := .Get "show_markup" | default true -}}
 {{- $show_preview := .Get "show_preview" | default true -}}

layouts/shortcodes/file.html

@@ -14,7 +14,7 @@
 -->
 
 {{- $basePath := .Site.Params.docs.basePath -}}
-{{- $file := .Get "path" }}
+{{- $file := .Get "path" | default "" -}}
 {{- if hasPrefix $file "./" -}}
     {{- $file = path.Clean $file -}}
 {{- else -}}
@@ -47,7 +47,7 @@
     {{ errorf "Invalid value for param 'full': %s" $fullParam -}}
 {{ end -}}
 
-{{- $class := .Get "class" -}}
+{{- $class := .Get "class" | default "" -}}
 
 {{- /* If any parameters are missing, print an error and exit */ -}}
 {{- if not $file -}}

layouts/shortcodes/image.html

@@ -16,19 +16,19 @@
 -->
 
 {{- if isset .Params "src" -}}
-    {{ $url := .Get "src" -}}
+    {{ $url := .Get "src" | default "" -}}
     {{- $validRatios := slice "1x1" "3x2" "4x3" "16x9" "21x9" -}}
-    {{ $ratio := .Get "ratio" -}}
+    {{ $ratio := .Get "ratio" | default "" -}}
     {{ if $ratio -}}
         {{ if not (in $validRatios $ratio) -}}
             {{ errorf "Invalid value for param 'ratio': %s" .Position -}}
         {{ end -}}
     {{ end -}}
     
-    {{- $class := .Get "class" -}}
-    {{- $wrapper := .Get "wrapper" -}}
-    {{ $title := .Get "title" -}}
-    {{ $caption := .Get "caption" -}}
+    {{- $class := .Get "class" | default "" -}}
+    {{- $wrapper := .Get "wrapper" | default "" -}}
+    {{ $title := .Get "title" | default "" -}}
+    {{ $caption := .Get "caption" | default "" -}}
     {{ $supportedFlags := slice "true" "false" -}}
     {{ $modeParam := "false" -}}
     {{ $mode := false -}}

layouts/shortcodes/img.html

@@ -12,9 +12,9 @@
 {{ if not .Parent }}
     {{ errorf "The img shortcode should be contained within a carousel shortcode: %s" .Position }}
 {{ else }}
-    {{- $src := .Get "src" -}}
+    {{- $src := .Get "src" | default "" -}}
     {{- if $src -}}
-        {{- $caption := .Get "caption" -}}
+        {{- $caption := .Get "caption" | default "" -}}
         {{- $ratio := partial "utilities/GetArg" (dict "page" . "arg" "ratio") -}}
         {{- $portrait := partial "utilities/GetArg" (dict "page" . "arg" "portrait") | default false -}}
         {{- $active := eq .Ordinal 0 -}}

layouts/shortcodes/kbd.html

@@ -0,0 +1,25 @@
+<!-- 
+    Adds a keyboard input element. The shortcode supports the following arguments:
+    "title"         Required title of the keyboard input. In shorthand notation, this is the first (and only) matched
+                    argument.
+    "class"         Optional class attributes of the keyboard input element.
+    "color"         Optional theme color of the element, either "primary", "secondary" (default), "success",
+                    "danger", "warning", "info", "light", "dark", "white", or "black".
+-->
+
+{{- $error := false -}}
+{{- $title := "" -}}
+{{- if .IsNamedParams }}{{ $title = .Get "title" }}{{ else }}{{ $title = .Get 0 }}{{ end }}
+{{- $class := .Get "class" | default "" -}}
+{{- $color := "" -}}
+{{- with .Get "color" }}{{ $color = . }}{{ end -}}
+{{- $supportedColors := slice "primary" "secondary" "success" "danger" "warning" "info" "light" "dark" "white" "black" -}}
+{{- if and $color (not (in $supportedColors $color)) -}}
+    {{- errorf "Invalid value for param 'color': %s" .Position -}}
+{{- end -}}
+
+{{- if not $title }}
+    {{ errorf "Missing title: %s" .Position -}}
+{{ else -}}
+    <kbd {{ if or $color $class }}class="{{ with $color }}text-bg-{{ . }}{{ end }}{{ with $class }} {{ . }}{{ end }}"{{ end }}>{{ $title | plainify }}</kbd>
+{{ end -}}

layouts/shortcodes/link.html

@@ -30,13 +30,13 @@
 {{- $anchor := "" -}}
 
 {{ if .IsNamedParams }}
-    {{ $href = .Get "href" }}
-    {{ $name = .Get "name" }}
-    {{ $url = .Get "url" }}
-    {{ $cue = .Get "cue" | default site.Params.main.externalLinks.cue }}
-    {{ $tab = .Get "tab" | default site.Params.main.externalLinks.tab }}
-    {{ $case = .Get "case" | default true }}
-    {{- $class := .Get "class" -}}
+    {{- $href = .Get "href" | default "" -}}
+    {{- $name = .Get "name" | default "" -}}
+    {{- $url = .Get "url" | default "" -}}
+    {{- $cue = .Get "cue" | default site.Params.main.externalLinks.cue -}}
+    {{- $tab = .Get "tab" | default site.Params.main.externalLinks.tab -}}
+    {{- $case = .Get "case" | default true -}}
+    {{- $class = .Get "class" | default "" -}}
 {{ else }}
     {{ $href = .Get 0 }}
 {{ end }}
@@ -63,8 +63,7 @@
             {{- $url = index $segments 0 -}}            
             {{- $anchor = index $segments 1 -}}            
             {{ if not $url }}
-                {{- $url = strings.TrimSuffix "/" .Page.RelPermalink -}}
-                {{- with .Page.Language }}{{ $url = strings.TrimPrefix (path.Join "/" .Lang) $url}}{{ end -}}
+                {{ $url = .Page.File.Path }}
             {{ end }}
         {{ end }}
     {{ else }}

layouts/shortcodes/mark.html

@@ -0,0 +1,23 @@
+<!-- 
+    Highlights text by applying a background color. The shortcode supports the following arguments:
+    "color":        Optional theme color of the highlight, either "primary", "secondary", "success", "danger",
+                    "warning", "info", "light", "dark", "white" or "black". By default, the highlight uses the color of
+                    the HTML mark function.
+    "class":        Optional class attribute of the highlight element.
+-->
+
+{{- $error := false -}}
+{{ $color := .Get "color" | default "" -}}
+{{ $supportedColors := slice "primary" "secondary" "success" "danger" "warning" "info" "light" "dark" -}}
+{{ if and $color (not (in $supportedColors $color)) -}}
+    {{ errorf "Invalid value for param 'color': %s" .Position -}}
+    {{ $error = true -}}
+{{ end -}}
+
+{{- $class := .Get "class" | default "" -}}
+
+{{- if $color }}{{ $class = printf "%s text-bg-%s" $class $color }}{{ end -}}
+
+{{- if not $error -}}
+    <mark{{ with $class }} class="{{ . }}"{{ end }}>{{ trim .Inner " \r\n" | .Page.RenderString -}}</mark>
+{{- end -}}

layouts/shortcodes/nav-item.html

@@ -22,12 +22,12 @@
         {{- $fade = true -}}
     {{- end -}}
 
-    {{- $header := .Get "header" -}}
+    {{- $header := .Get "header" | default "" -}}
     {{- if not $header -}}
         {{- errorf "Missing value for param 'header': %s" .Parent.Position -}}
     {{- end -}}
 
-    {{- $class := .Get "class" -}}
+    {{- $class := .Get "class" | default "" -}}
     {{- $body := trim .Inner " \r\n" | .Page.RenderString -}}
 
     {{- $supportedFlags := slice "true" "false" -}}

layouts/shortcodes/nav.html

@@ -4,7 +4,8 @@
     "type"          Optional type of the tab group, either "tabs", "pills", or "underline".
     "vertical"      Optional flag to show vertical tabs instead of horizontal tabs (default).
     "fade"          Optional flag to make tab panes fade in.
-    "class":        Optional class attribute of the tab group, e.g. “nav-fill”.
+    "class"         Optional class attribute of the tab group, e.g. “nav-fill”.
+    "wrap"          Optional flag to enable word wrapping of tab titles, defaults to false.
 -->
 
 {{- $id := printf "nav-%d" .Ordinal -}}
@@ -12,8 +13,8 @@
     {{ $id = . }}
 {{ end }}
 
-{{- $class := .Get "class" -}}
-{{ $type := .Get "type" -}}
+{{- $class := .Get "class" | default "" -}}
+{{ $type := .Get "type" | default "" -}}
 {{ $supportedNavTypes := slice "tabs" "pills" "underline" -}}
 {{ if $type }}
     {{ if not (in $supportedNavTypes $type) -}}
@@ -37,6 +38,13 @@
     {{ errorf "Invalid value for param 'fade': %s" $fadeParam -}}
 {{- end -}}
 
+{{ $wrapParam := "false" -}}
+{{- $wrap := false -}}
+{{ with .Get "wrap" }}{{ $wrapParam = . }}{{ end -}}
+{{ if not (in $supportedFlags $wrapParam) -}}
+    {{ errorf "Invalid value for param 'wrap': %s" $wrapParam -}}
+{{- end -}}
+
 {{- if and (eq $type "tabs") $vertical -}}
     {{- errorf "Tabs do not support vertical layout" -}}
 {{- end -}}
@@ -68,7 +76,7 @@
     {{- range $index, $item := $items -}}
         {{- $header := partial "utilities/GetVal.html" $item -}}
         {{- $itemDisabled := in $disabled $index -}}
-        <button class="nav-link text-nowrap{{ if eq $index $showID }} active{{ end }} {{ if $itemDisabled}} disabled {{end }}" id="{{ $id }}-btn-{{ $index }}" data-bs-toggle="pill" data-bs-target="#{{ $id }}-{{ $index }}" 
+        <button class="nav-link{{ if not $wrap }} text-nowrap{{ end }}{{ if eq $index $showID }} active{{ end }}{{ if $itemDisabled}} disabled {{end }}" id="{{ $id }}-btn-{{ $index }}" data-bs-toggle="pill" data-bs-target="#{{ $id }}-{{ $index }}" 
                 type="button" role="tab" aria-controls="{{ $id }}-{{ $index }}" aria-selected="{{ if eq $index 0 }}true{{ else }}false{{ end }}">
             {{ $header }}
         </button>

layouts/shortcodes/navbar.html

@@ -27,7 +27,7 @@
     {{ $id = . }}
 {{ end }}
 
-{{ $path := .Get "path" }}
+{{ $path := .Get "path" | default "" }}
 {{ $page := .Site.GetPage $path }}
 {{ if not $page }}
     {{ errorf "Invalid or missing value for param 'path': %s" $path -}}
@@ -86,7 +86,7 @@
 {{ $title := "" -}}
 {{ with .Get "title" }}{{ $title = . }}{{ end -}}
 
-{{- $class := .Get "class" -}}
+{{- $class := .Get "class" | default "" -}}
 
 {{ if not $error -}}
     {{- partial "assets/navbar.html" (dict 

layouts/shortcodes/persona.html

@@ -9,14 +9,14 @@
 
 {{- $error := false -}}
 
-{{- $path := .Get "path" -}}
+{{- $path := .Get "path" | default "" -}}
 {{- $page := .Site.GetPage $path -}}
 {{- if not $page -}}
     {{- errorf "Invalid or missing value for param 'path': %s" .Position -}}
     {{- $error = true -}}
 {{- end -}}
 
-{{- $class := .Get "class" -}}
+{{- $class := .Get "class" | default "" -}}
 
 {{- $color := "" -}}
 {{- with .Get "color" }}{{ $color = . }}{{ end -}}

layouts/shortcodes/release.html

@@ -10,11 +10,10 @@
 -->
 
 {{- $error := false -}}
-{{- $version := .Get "version" -}}
+{{- $version := .Get "version" | default "" -}}
 {{- $inline := false -}}
 
-{{- $state := "new" -}}
-{{- with .Get "state" }}{{ $state = . }}{{ end -}}
+{{- $state := .Get "state" | default "new" -}}
 {{- $supportedStates := slice "new" "deprecated" -}}
 {{- if not (in $supportedStates $state) -}}
     {{- errorf "Invalid value for param 'state': %s" .Position -}}
@@ -84,7 +83,7 @@
     {{- $error = true -}}
 {{- end -}}
 
-{{- $class := .Get "class" -}}
+{{- $class := .Get "class" | default "" -}}
 
 {{- if not $error -}}
     {{- if not $inline }}<div class="pb-3">{{ end -}}
@@ -98,7 +97,8 @@
         "icon" $icon
         "tooltip" $tooltip
         "order" "first"
-        "class" (trim (printf "rounded-2 fw-semibold %s" $class) " "))
+        "class" (trim (printf "rounded-2 fw-semibold %s" $class) " ")
+        "spacing" $inline)
     -}} 
     {{- if not $inline }}</div>{{ end -}}
 {{- end -}}

layouts/shortcodes/sub.html

@@ -0,0 +1,7 @@
+<!-- 
+    Displays text as subscript, provided as unnamed argument.
+-->
+
+{{- $text := .Get 0 | default "" -}}
+
+<sub>{{ $text | .Page.RenderString -}}</sub>

layouts/shortcodes/sup.html

@@ -0,0 +1,7 @@
+<!-- 
+    Displays text as superscript, provided as unnamed argument.
+-->
+
+{{- $text := .Get 0 | default "" -}}
+
+<sup>{{ $text | .Page.RenderString -}}</sup>

layouts/shortcodes/timeline.html

@@ -3,21 +3,30 @@
     
     Show items ordered on a vertical timelime. The shortcode supports the following arguments:
     "data"          Required filename of the timeline input. You can omit the file extension. The file should reside in
-                    the "data" folder.
+                    the "data" folder. The data supports language extensions. For example, "timeline.en.yaml" refers to
+                    the English translation of the timeline data. The filename "timeline.yaml" is used when no suitable
+                    translation is found.
     "background"    Optional border color of the connector dots, defaults to the body background color. If set, uses a
                     subtle background color that is adaptive to the current color mode.
     "class"         Optional class attribute of the timeline's container.
 -->
 
 {{ $error := false }}
+{{- $page := .Page -}}
 
-{{- $data := .Get "data" -}}
+{{- $data := .Get "data" | default "" -}}
 {{ if not $data -}}
     {{ errorf "Missing param 'data': %s" .Position -}}
     {{ $error = true }}
 {{ end -}}
 
-{{ $entries := index site.Data $data }}
+{{/* Try language-specific file first */}}
+{{ $path := path.Join (path.Dir $data) (printf "%s.%s" (path.BaseName $data) .Page.Language.Lang) (path.Ext $data) }}
+{{ $entries := index site.Data $path }}
+{{/* Use exact provided path as backup */}}
+{{ if not $entries -}}
+    {{ $entries = index site.Data $data }}
+{{ end }}
 {{ if not $entries -}}
     {{ errorf "Invalid timeline data '%s': %s" $data .Position -}}
     {{ $error = true }}
@@ -31,7 +40,7 @@
     {{ $error = true -}}
 {{ end -}}
 
-{{- $class := .Get "class" -}}
+{{- $class := .Get "class" | default "" -}}
 
 <!-- Inline partial to render icon -->
 {{- define "partials/timeline-icon.html" -}}
@@ -51,6 +60,7 @@
 <!-- Inline partial to render icon -->
 {{- define "partials/timeline-panel.html" -}}
     {{- $col := default 6 .col -}}
+    {{- $page := .page -}}
     {{- $content := .content -}}
     {{- $color := .color -}}
     {{- $title := .title -}}
@@ -79,7 +89,7 @@
                     {{ $datestr := (partial "utilities/date.html" (dict "date" $date "format" "long")) -}}
                     <p class="mb-0"><small class="text-body-secondary text-uppercase">{{ $datestr -}}</small></p>
                 {{ end }}
-                <p class="mt-3 mb-0">{{ $content | .Page.RenderString }}</p>
+                <p class="mt-3 mb-0">{{ $content | $page.RenderString }}</p>
             </div>
         </div>
     </div>    
@@ -90,11 +100,11 @@
     {{ range $index, $item := $entries }}
         <div class="row timeline timeline-{{ $item.color }} timeline-dot g-0 ">
             {{ if eq (mod $index 2) 1 }}
-                {{ partial "partials/timeline-panel.html" (dict "content" $item.content "color" $item.color "title" $item.title "badge" $item.badge "date" $item.date "url" $item.url "direction" "start") }}
+                {{ partial "partials/timeline-panel.html" (dict "page" $page "content" $item.content "color" $item.color "title" $item.title "badge" $item.badge "date" $item.date "url" $item.url "direction" "start") }}
                 {{ partial "partials/timeline-icon.html" (dict "icon" $item.icon "direction" "start") }}
             {{ else }}
                 {{ partial "partials/timeline-icon.html" (dict "icon" $item.icon "direction" "end") }}
-                {{ partial "partials/timeline-panel.html" (dict "content" $item.content "color" $item.color "title" $item.title "badge" $item.badge "date" $item.date "url" $item.url "direction" "end") }}
+                {{ partial "partials/timeline-panel.html" (dict "page" $page "content" $item.content "color" $item.color "title" $item.title "badge" $item.badge "date" $item.date "url" $item.url "direction" "end") }}
             {{ end }}
         </div>
         <div class="row timeline g-0 p-3"> </div>
@@ -106,7 +116,7 @@
     {{ range $index, $item := $entries }}
         <div class="row timeline-sm timeline-{{ $item.color }} timeline-dot g-0">
             {{ partial "partials/timeline-icon.html" (dict "icon" $item.icon "direction" "end" "col" 3) }}
-            {{ partial "partials/timeline-panel.html" (dict "content" $item.content "color" $item.color "title" $item.title "badge" $item.badge "date" $item.date "url" $item.url "direction" "end" "col" 9) }}
+            {{ partial "partials/timeline-panel.html" (dict "page" $page "content" $item.content "color" $item.color "title" $item.title "badge" $item.badge "date" $item.date "url" $item.url "direction" "end" "col" 9) }}
         </div>
         <div class="row timeline-sm g-0 p-3"> </div>
     {{ end }}

layouts/shortcodes/toast.html

@@ -8,10 +8,10 @@
 {{- $error := false -}}
 {{- $id := printf "toast-message-%d" .Ordinal -}}
 {{- with .Get "id" }}{{ $id = . }}{{ end -}}
-{{ $header := .Get "header" -}}
+{{ $header := .Get "header" | default "" -}}
 {{ $message := trim .Inner " \r\n" | .Page.RenderString -}}
 
-{{- $class := .Get "class" -}}
+{{- $class := .Get "class" | default "" -}}
 
 {{ if not $message -}}
     {{ errorf "Missing inner element text: %s" .Position -}}

layouts/shortcodes/tooltip.html

@@ -6,6 +6,7 @@
     "href"          Required address for the button or hyperlink.
     "placement"     Optional position of the tooltip: "top" (default), "bottom", "left", or "right". 
     "class"         Optional class attribute of the tooltip's button element.
+    "spacing"       Optional flag to add spacing to the inline tooltip, defaults to "true".
 -->
 
 {{ $error := false }}
@@ -25,9 +26,9 @@
     {{ $error = true }}
 {{ end -}}
 
-{{ $tooltip := .Get "title" -}}
+{{ $tooltip := .Get "title" | default "" -}}
 
-{{ $href := .Get "href" -}}
+{{ $href := .Get "href" | default "" -}}
 {{ if not $href -}}
     {{ errorf "Missing value for param 'href': %s" .Position -}}
     {{ $error = true }}
@@ -41,10 +42,21 @@
     {{ $error = true }}
 {{ end -}}
 
-{{- $class := .Get "class" -}}
+{{- $class := .Get "class" | default "" -}}
+
+{{- $spacing := .Get "spacing" | default true -}}
 
 {{ if not $error }}
     <div class="d-inline-flex">
-        {{- partial "assets/button.html" (dict "type" $type "title" $title "color" $color "tooltip" $tooltip "href" $href "placement" $placement "class" $class) -}}
+        {{- partial "assets/button.html" (dict 
+            "type" $type
+            "title" $title
+            "color" $color
+            "tooltip" $tooltip
+            "href" $href
+            "placement" $placement
+            "class" $class
+            "spacing" $spacing) 
+        -}}
     </div>
 {{ end }}

layouts/tags/list.html

@@ -34,7 +34,7 @@
                                     <p class="text-body-secondary mt-5">{{ $year }}</p>
                                     {{ $.Scratch.Set "lastYear" $year }}
                                 {{ end }}
-                                <a href="{{ (path.Join .Page.RelPermalink) | relLangURL }}">{{ if .Draft }}{{ T "draft" | upper }}: {{end}}{{ .Title | .Page.RenderString }}</a>
+                                <a href="{{ (path.Join .Page.RelPermalink) | relLangURL }}">{{ if .Draft }}{{ T "draft" | upper }}: {{ end }}{{ .Title | .Page.RenderString }}</a>
                             </div>
                         </div>
                     {{ end }}

netlify.toml

@@ -1,19 +1,15 @@
 # toml-docs-start netlify
 [build]
     publish = "exampleSite/public"
-    # functions = "functions"
-
-[build.environment]
-    NODE_VERSION = "18.17.0"
-    NPM_VERSION = "9.6.7"
-
-[context.production]
     command = "npm run build:example"
 
-[context.production.environment]
-    HUGO_VERSION = "0.110.0"
+[build.environment]
+    DART_SASS_VERSION = "1.69.0"
+    HUGO_VERSION = "0.119.0"
     HUGO_ENV = "production"
     HUGO_ENABLEGITINFO = "true"
+    NODE_VERSION = "18.18.2"
+    NPM_VERSION = "9.8.1"
 # toml-docs-end netlify
 
 [[headers]]
@@ -74,4 +70,20 @@
     targetPort = 1313
     port = 8888
     publish = "public"
-    autoLaunch = false
+    autoLaunch = false
+
+# toml-docs-start plugins
+[[plugins]]
+    package = "@gethinode/netlify-plugin-dartsass"
+
+[[plugins]]
+    package = "netlify-plugin-hugo-cache-resources"
+	[plugins.inputs]
+	# Redirected in exampleSite/config/_default/hugo.toml
+	# srcdir = ""
+
+[[plugins]]
+    package = "@netlify/plugin-lighthouse"
+    # [plugins.inputs]
+    # output_path = "reports/lighthouse.html"
+# toml-docs-end plugins

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gethinode/hinode",
-  "version": "0.19.0-alpha",
+  "version": "0.21.0-alpha3",
   "description": "Hinode is a clean documentation and blog theme for Hugo, an open-source static site generator",
   "keywords": [
     "hugo",
@@ -20,7 +20,8 @@
     "prestart": "npm run -s mod:vendor",
     "start": "hugo server --bind=0.0.0.0 --disableFastRender --printI18nWarnings",
     "start:example": "npm run -s prestart && hugo server --bind=0.0.0.0 --disableFastRender --printI18nWarnings -s exampleSite",
-    "start:prod": "npm run -s prestart  && hugo server --bind=0.0.0.0 --disableFastRender --printI18nWarnings -e production",
+    "start:prod": "npm run -s prestart  && hugo server --bind=0.0.0.0 --disableFastRender --printI18nWarnings --minify -e production",
+    "start:example:prod": "npm run -s prestart  && hugo server --bind=0.0.0.0 --disableFastRender --printI18nWarnings --minify -e production -s exampleSite",
     "prebuild": "npm run clean:public && npm run -s mod:vendor",
     "build": "hugo --gc --minify",
     "build:cache": "npm run -s prebuild && hugo config | grep cachedir && hugo --gc --minify -e ci",
@@ -67,24 +68,27 @@
   "homepage": "https://gethinode.com",
   "devDependencies": {
     "@fullhuman/postcss-purgecss": "^5.0.0",
-    "autoprefixer": "^10.4.15",
+    "@gethinode/netlify-plugin-dartsass": "^0.2.0",
+    "@netlify/plugin-lighthouse": "^5.0.0",
+    "autoprefixer": "^10.4.16",
     "cssnano": "^6.0.1",
     "cssnano-preset-advanced": "^6.0.1",
-    "eslint": "^8.47.0",
+    "eslint": "^8.51.0",
     "eslint-config-standard": "^17.1.0",
     "eslint-plugin-import": "^2.28.1",
-    "eslint-plugin-n": "^16.0.2",
+    "eslint-plugin-n": "^16.2.0",
     "eslint-plugin-promise": "^6.1.1",
-    "hugo-bin": "^0.113.0",
-    "markdownlint-cli2": "^0.9.0",
+    "hugo-bin": "^0.115.0",
+    "markdownlint-cli2": "^0.10.0",
+    "netlify-plugin-hugo-cache-resources": "^0.2.1",
     "npm-run-all": "^4.1.5",
     "postcss-cli": "^10.1.0",
     "purgecss-whitelister": "^2.4.0",
     "replace-in-files-cli": "^2.2.0",
-    "rimraf": "^5.0.1",
+    "rimraf": "^5.0.5",
     "shx": "^0.3.4",
     "stylelint": "^15.10.3",
-    "stylelint-config-standard-scss": "^10.0.0"
+    "stylelint-config-standard-scss": "^11.0.0"
   },
   "optionalDependencies": {
     "fsevents": "*"

theme.toml

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