Merge pull request #555 from gethinode/develop

Refine base layout

.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:  |

.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/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-indicator-active-bg:  #fff !default;
-$carousel-dark-caption-color:        #ffffff !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;

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/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 = "5.5rem"
-    offset = "3.8em"
     search = true
     breadcrumb = true
     toc = true
@@ -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

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

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

@@ -241,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 -->
 

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/components.md

@@ -11,11 +11,21 @@ thumbnail:
   authorURL: https://unsplash.com/@ryoji__iwata
   origin: Unsplash
   originURL: https://unsplash.com/photos/5siQcvSxCP8
-modules: ["katex", "leaflet"]
+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.

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

@@ -8,4 +8,4 @@
   long: "Scalable Vector Graphics"
 
 - id: ci/cd
-  long: "Continous Integration/Continuous Deployment"
+  long: "Continuous Integration/Continuous Deployment"

exampleSite/go.sum

@@ -1,11 +1,17 @@
 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=
@@ -14,8 +20,28 @@ github.com/gethinode/mod-fontawesome v1.3.0 h1:oudeDBlAKu8vqYxumWuq5SG5F5itm33Ng
 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=

exampleSite/hugo_stats.json

@@ -65,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",
@@ -96,6 +97,7 @@
       "card-body-link",
       "card-body-margin",
       "card-emphasize",
+      "card-icon",
       "card-img-top",
       "card-img-wrap",
       "card-text",
@@ -118,7 +120,6 @@
       "col-6",
       "col-8",
       "col-9",
-      "col-lg-2",
       "col-lg-4",
       "col-lg-8",
       "col-md-10",
@@ -134,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",
@@ -164,6 +165,7 @@
       "fa-2x",
       "fa-2xs",
       "fa-4x",
+      "fa-activity",
       "fa-arrow-left",
       "fa-arrow-right",
       "fa-bootstrap",
@@ -215,6 +217,7 @@
       "g-0",
       "g-3",
       "g-4",
+      "gap-1",
       "gap-2",
       "gap-3",
       "gradient",
@@ -245,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",
@@ -267,10 +271,12 @@
       "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",
@@ -286,13 +292,11 @@
       "navbar-toggler",
       "next",
       "no-js",
+      "order-0",
       "order-1",
-      "order-2",
-      "order-3",
-      "order-4",
       "order-first",
-      "order-sm-2",
+      "order-md-0",
-      "order-sm-3",
+      "order-md-1",
       "p-0",
       "p-1",
       "p-2",
@@ -300,7 +304,9 @@
       "p-4",
       "pb-2",
       "pb-3",
+      "pb-4",
       "pb-5",
+      "pb-md-0",
       "pe-3",
       "position-absolute",
       "position-fixed",
@@ -310,13 +316,15 @@
       "ps-1",
       "ps-3",
       "ps-xl-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",
@@ -328,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",
@@ -363,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",
@@ -420,8 +430,10 @@
       "accordéon",
       "alert",
       "alerte",
+      "animation",
       "badge",
       "barre-de-navigation",
+      "blog",
       "body-docs-collapse-15",
       "body-file-collapse-1",
       "bouton",
@@ -460,6 +472,7 @@
       "leaflet-map-0",
       "lien",
       "link",
+      "lottie-animation-0",
       "map",
       "mark",
       "nav",
@@ -475,6 +488,9 @@
       "navbar-sample-collapse",
       "navigation",
       "notification",
+      "projecten",
+      "projects",
+      "projets",
       "publication",
       "release",
       "réduire",

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-bootstrap v1.2.1 // indirect
-	github.com/gethinode/mod-flexsearch v1.4.0 // indirect
+	github.com/gethinode/mod-flexsearch v1.4.1 // indirect
-	github.com/gethinode/mod-fontawesome v1.3.1 // indirect
+	github.com/gethinode/mod-fontawesome v1.5.0 // indirect
-	github.com/gethinode/mod-katex v1.0.2 // indirect
+	github.com/gethinode/mod-katex v1.0.3 // indirect
-	github.com/gethinode/mod-leaflet v0.3.4 // indirect
+	github.com/gethinode/mod-leaflet v0.3.5 // indirect
+	github.com/gethinode/mod-lottie v1.2.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=
@@ -42,12 +48,20 @@ github.com/gethinode/mod-fontawesome v1.3.0 h1:oudeDBlAKu8vqYxumWuq5SG5F5itm33Ng
 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=
@@ -56,3 +70,15 @@ 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=

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-6",
-      "col-lg-4",
       "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-md-0",
-      "order-3",
+      "order-md-1",
-      "order-4",
-      "order-first",
-      "order-sm-2",
-      "order-sm-3",
       "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",

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="d-flex flex-column min-vh-100{{ if .IsHome }}{{ with .Site.Params.home.style }} {{ . }}{{ end }}{{ end }}">
-            <div class="{{ if .Site.Params.navigation.fixed }}mb-4{{ end }}">
+            {{- partial "assets/navbar.html" (dict
-                {{- partial "assets/navbar.html" (dict
+                "page" .
-                    "page" .
+                "fixed" (string site.Params.navigation.fixed)
-                    "fixed" (string .Site.Params.navigation.fixed)
+                "color" site.Params.navigation.color
-                    "color" (.Site.Params.navigation.color)
+                "style" (default "light" site.Params.navigation.style)
-                    "style" (default "light" .Site.Params.navigation.style)
+                "size" (default "md" site.Params.navigation.size))
-                    "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>
 
-        {{ if and .IsHome .Site.Params.home.fullCover -}}
+            <div class="flex-fill main-content{{ if .Site.Params.main.footerBelowFold }} fullscreen{{ end }} pb-4">
-            <div class="">
                 {{ block "main" . }}{{ end -}}
             </div>
-            <div class="">
+
-                {{- partial "footer/social.html" . -}}
+            {{- partial "footer/social.html" . -}}
-                {{- partial "footer/footer.html" . -}}
+            {{- partial "footer/footer.html" . -}}
-            </div>
+        </div>
-        {{ else if .Site.Params.main.footerBelowFold }}
-            <div class="">
-                {{- partial "footer/social.html" . -}}
-                {{- partial "footer/footer.html" . -}}
-            </div>
-        {{ end }}
 
         {{- partial "footer/toast-container.html" . -}}
         {{- partialCached "footer/scripts.html" (dict "header" false "page" . "core" true) }}
-        {{- $modules := site.Params.modules.optional | intersect .Params.modules -}}
+        {{- partial "partials/optional-scripts.html" . -}}
-        {{- 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 -}}
     </body>
 </html>

layouts/_default/list.html

@@ -1,13 +1,135 @@
 {{- define "main" -}}
-    {{- $content := partial "utilities/ProcessContent" (dict "page" .Page "raw" .RawContent) -}}
+    {{- $page := . -}}
-    {{- partial "assets/section-list.html" (dict 
+    {{- $orientation :=  site.Params.list.feature.orientation | default "horizontal" -}}
-        "page" .
+    {{- $width := site.Params.list.feature.width | default 6 -}}
-        "section" .Type
+    {{- $justify := site.Params.list.feature.justify | default "center" -}}
-        "home" false
+    {{- $align := site.Params.list.feature.align | default "center" -}}
-        "nested" .Params.Nested
+    {{- $sections := slice -}}
-        "title" (or .Title .Type)
+    {{- $sections = $sections | append $page.Type -}}
-        "description" .Description
+    {{ with $page.Params.sections }}
-        "content" $content
+        {{ $sections = $sections | append . }}
-        "paginate" true)
+    {{ 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 and (ne $layout "featured") (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") }}
@@ -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

@@ -31,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 -}}
@@ -139,7 +141,8 @@
 {{- $header := .header -}}
 {{- $footer := .footer -}}
 {{- $orientation := .orientation -}}
-{{- $wrapper := .wrapper | default "p-4 px-xxl-0" -}}
+{{- $ratio := .ratio -}}
+{{- $wrapper := .wrapper | default "p-0" -}}
 
 {{- if and (eq $cols 1) (eq $orientation "horizontal") }}{{ $orientation = "horizontal-sm" }}{{ end -}}
 
@@ -153,6 +156,7 @@
                 "header" $header
                 "footer" $footer
                 "orientation" $orientation
+                "ratio" $ratio
             ) -}}
             {{- $params = merge $params $element }}
 

layouts/partials/assets/card.html

@@ -18,6 +18,8 @@
                     "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",
@@ -88,6 +90,7 @@
 {{- $href := .href -}}
 {{- $description := .description -}}
 {{- $thumbnail := .thumbnail -}}
+{{- $ratio := .ratio -}}
 {{- $icon := .icon -}}
 
 {{- $color := "" -}}
@@ -149,10 +152,10 @@
         <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">
+                    <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 text-secondary fa-fw" $icon)) -}}
+                        {{- partial "assets/icon.html" (dict "icon" (printf "%s fa-fluid fa-fw" $icon)) -}}
                     </div>
                 {{- end -}}
             </div>
@@ -170,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" (or $alt $title)) -}}
+            {{- partial "assets/image.html" (dict "url" $thumbnail "ratio" (or $ratio "16x9") "outerClass" "card-img-wrap" "innerClass" "card-img-top" "title" (or $alt $title)) -}}
         {{- else if $icon -}}
-            <div class="p-{{ $padding }}">
+            <div class="card-icon  p-{{ $padding }}">
-                {{- partial "assets/icon.html" (dict "icon" (printf "%s fa-4x text-secondary" $icon)) -}}
+                {{- partial "assets/icon.html" (dict "icon" (printf "%s fa-4x" $icon)) -}}
             </div>
         {{- end -}}
         <div class="card-body d-flex flex-column p-{{ $padding }}">

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 id="{{ anchorize . }}" class="display-4 pt-4{{ if and page.IsHome site.Params.home.centerHeadline }} text-center{{ end }}">{{ . }}</p>{{ end }}
-    {{ 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 }}
-    {{ with $description }} <p class="lead mb-5">{{ . }}</p>{{ end }}
+{{ $content }}
-    {{- 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>

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 := "" }}
+{{ $list := slice }}
-{{ if $nested }}
+{{ 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-fluid {{ with $background }} bg-{{ . }}{{ end }} p-0">
-        <div class="container-xxl flex-fill 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 }}
+    {{- $page := .page -}}
-    {{ $sectionBreak := .sectionBreak }}
+    {{- $sectionBreak := .sectionBreak -}}
     {{- $level := .level -}}
-    {{ $baseURL := .baseURL}}
+    {{- $baseURL := .baseURL -}}
-    {{ $title := .title}}
+    {{- $title := .title -}}
+    {{- $href := .href -}}
+    {{- $data := .menu -}}
 
     {{- $doc_slug := $title | urlize -}}
-    {{- $href := printf "%s/" (relLangURL (path.Join $baseURL $doc_slug)) -}}
+    {{- $href := or $href (printf "%s/" (relLangURL (path.Join $baseURL $doc_slug))) -}}
-    {{ $active := eq $page.RelPermalink $href }}
+    {{- $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 }}">
+                    {{ $class := "sidebar-item text-decoration-none rounded" }}
-                        {{ $title }}
+                    {{ if $active }}{{ $class = printf "%s active" $class }}{{ end }}
-                    </a>      
+                    {{ $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 }}">
+            {{ $class := "sidebar-item text-decoration-none rounded small" }}
-                {{ $title }}
+            {{ if $active }}{{ $class = printf "%s active" $class }}{{ end }}
-            </a>      
+            {{ $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) -}}
+{{- $page := .page -}}
-{{ if (gt $items 1) -}}
+{{- $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="container-fluid bg-primary bg-opacity-{{ .Site.Params.style.themeOpacity | default "25" | safeHTML }}">
-        <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="container-xxl px-4 px-xxl-0">
-            <div class="col col-md-2 d-none d-md-block"></div>
+            <div class="row row-cols-2 py-3 align-items-center">
-            <div class="col col-sm-6 col-md-4">
+                <div class="col col-6">
-                {{ if gt .Site.Menus.social 0 }}
+                    <div class="row justify-content-end p-0">
-                    <div class="fs-3 fw-bold">{{ or .Site.Params.footer.socialTitle .Site.Params.social.title }}</div>
+                        <div class="col-12 col-md-8 p-0">
-                    <p>{{ or .Site.Params.footer.socialCaption .Site.Params.social.caption }}</p>
+                            <div class="fs-3 fw-bold">{{ or .Site.Params.footer.socialTitle .Site.Params.social.title }}</div>
-                {{ end }}
+                            <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 }}
+    {{ if $core }}
-    {{- partial "head/icons.html" (dict "css" $css) -}}
+        {{- partial "head/icons.html" (dict "css" $css) -}}
-{{ end }}
+    {{ end }}
-{{- if site.Params.style.purge -}}
+    {{- if site.Params.style.purge -}}
-    {{- $post_options := dict "config" "config" -}}
+        {{- $post_options := dict "config" "config" -}}
-    {{- $css = $css | resources.PostCSS $post_options -}}
+        {{- $css = $css | resources.PostCSS $post_options -}}
-{{- end -}}
+    {{- end -}}
 
-{{- if not hugo.IsProduction -}}
+    {{- if not hugo.IsProduction -}}
-    <link rel="stylesheet" href="{{ if $absoluteURL }}{{ $css.Permalink }}{{ else }}{{ $css.RelPermalink }}{{ end }}">
+        <link rel="stylesheet" href="{{ if $absoluteURL }}{{ $css.Permalink }}{{ else }}{{ $css.RelPermalink }}{{ end }}">
-{{- else -}}
+    {{- else -}}
-    {{- $css = $css | fingerprint | resources.PostProcess -}}
+        {{- $css = $css | fingerprint | resources.PostProcess -}}
-    <link rel="stylesheet" href="{{ if $absoluteURL }}{{ $css.Permalink }}{{ else }}{{ $css.RelPermalink }}{{ end }}" integrity="{{ $css.Data.Integrity }}" crossorigin="anonymous">
+        <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,90 @@
+{{- $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 -}}
+
+{{- 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 -}}
+
+    {{ with $page.Params.icon }}
+        {{ if eq (lower (path.Ext .)) ".json" }}
+            {{ partial "assets/animation.html" (dict "data" . "loop" false "hover" true "class" "col-6 mx-auto text-center") }}
+        {{ else }}
+            {{ partial "assets/icon.html" (dict "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 {{ with site.Params.home.feature.color }} bg-{{ . }} bg-opacity-{{ site.Params.style.themeOpacity | default "25" | safeHTML }}{{ end }}">
+    <div class="container-xxl p-4 px-xxl-0{{ if site.Params.home.fullCover }} fullscreen{{ end }} d-flex flex-column">
+        {{ if and (not $page.IsHome) site.Params.navigation.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/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/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/button.html

@@ -26,6 +26,7 @@
                     "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 }}
@@ -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.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.
@@ -87,11 +87,15 @@
 {{ $icon := .Get "icon" | default "" -}}
 {{ $thumbnail := .Get "thumbnail" | default "" -}}
 
+{{ if .Parent }}
+    {{ $class = (printf "h-100 %s" $class) }}
+{{ end }}
+
 {{ if not $error -}}
     {{- $output := partial "assets/card.html" (dict 
         "path" $path
         "title" $title
-        "class" (printf "h-100 %s" $class)
+        "class" $class
         "gutter" $gutter
         "color" $color
         "padding" $padding

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 -}}
@@ -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/release.html

@@ -97,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/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 }}
@@ -43,8 +44,19 @@
 
 {{- $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]
+[build.environment]
-    HUGO_VERSION = "0.110.0"
+    DART_SASS_VERSION = "1.69.0"
+    HUGO_VERSION = "0.119.0"
     HUGO_ENV = "production"
     HUGO_ENABLEGITINFO = "true"
+    NODE_VERSION = "18.18.0"
+    NPM_VERSION = "9.8.1"
 # toml-docs-end netlify
 
 [[headers]]
@@ -75,3 +71,19 @@
     port = 8888
     publish = "public"
     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",
+  "version": "0.21.0-alpha2",
   "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.48.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.114.2",
+    "hugo-bin": "^0.115.0",
-    "markdownlint-cli2": "^0.9.2",
+    "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": "*"