Merge pull request #532 from gethinode/develop

Support custom icons
Bump package version
2025-10-07 10:04:22 +00:00 · 2023-09-25 08:12:58 +02:00 · 2023-09-25 07:39:01 +02:00 · 2023-09-25 07:38:54 +02:00 · 2023-09-25 07:38:11 +02:00 · 2023-09-25 07:34:08 +02:00
38 changed files with 3963 additions and 362 deletions
--- a/.github/release.yml
+++ b/.github/release.yml
@@ -14,7 +14,7 @@ changelog:
      labels:
        - Semver-Minor
        - enhancement
-    - title: 🐛 Bug fixes
+    - title: 🐛 Bug Fixes
      labels:
        - fix
        - bugfix
--- a/.github/workflows/lint-build.yml
+++ b/.github/workflows/lint-build.yml
@@ -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:  |
--- a/.stylelintignore
+++ b/.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
--- a/assets/scss/app-dart.scss
+++ b/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";
--- a/assets/scss/common/_variables-dart.scss
+++ b/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;
--- a/assets/scss/common/_variables.scss
+++ b/assets/scss/common/_variables.scss
@@ -7,6 +7,7 @@ $navbar-toggler-focus-width:    0 !default;

 // scss-docs-start font
 $font-family-sans-serif:        $theme-font, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji" !default;
+$font-size-base:                $font-size-base !default;;
 $headings-font-weight:          600 !default;
 $font-weight-lighter:           lighter !default;
 $font-weight-light:             200 !default;
@@ -22,8 +23,8 @@ strong {
 $black:                       #000 !default;
 $btn-toggle-color:              $black !default;

-$carousel-dark-indicator-active-bg:  #ffffff !default;
-$carousel-dark-caption-color:        #ffffff !default;
+$carousel-dark-indicator-active-bg:  #fff !default;
+$carousel-dark-caption-color:        #fff !default;
 $carousel-dark-control-icon-filter:  invert(0) grayscale(100) !default;

 // scss-docs-start color-mode
--- a/assets/scss/components/_syntax-dart.scss
+++ b/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
--- a/assets/scss/components/_table.scss
+++ b/assets/scss/components/_table.scss
@@ -1,11 +1,13 @@
@if $enable-dark-mode {
    @include color-mode(dark) {
        .table-striped, .table-striped-columns {
-            --bs-table-striped-bg: var(--bs-tertiary-color);
+            --bs-table-striped-bg: var(--bs-tertiary-bg);
+            --bs-table-striped-color: var(--bs-body-color);
        }

        .table-hover {
-            --bs-table-hover-bg: var(--bs-tertiary-color);
+            --bs-table-hover-bg: var(--bs-tertiary-bg);
+            --bs-table-striped-color: var(--bs-body-color);
        }
    }
 }
--- a/config/_default/hugo.toml
+++ b/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
--- a/config/_default/params.toml
+++ b/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]
@@ -143,6 +145,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
--- a/exampleSite/assets/svgs/custom/activity.svg
+++ b/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>
--- a/exampleSite/config/_default/params.toml
+++ b/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]
--- a/exampleSite/content/en/blog/bootstrap-elements.md
+++ b/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 -->

--- a/exampleSite/content/en/blog/components.md
+++ b/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.
--- a/exampleSite/go.sum
+++ b/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,18 @@ 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-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-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=
--- a/exampleSite/hugo_stats.json
+++ b/exampleSite/hugo_stats.json
@@ -69,6 +69,8 @@
      "bg-opacity-10",
      "bg-primary",
      "bg-primary-subtle",
+      "bi",
+      "bi-activity",
      "border",
      "border-0",
      "border-1",
@@ -134,6 +136,7 @@
      "container",
      "container-fluid",
      "container-xxl",
+      "custom",
      "d-block",
      "d-flex",
      "d-grid",
@@ -164,6 +167,7 @@
      "fa-2x",
      "fa-2xs",
      "fa-4x",
+      "fa-activity",
      "fa-arrow-left",
      "fa-arrow-right",
      "fa-bootstrap",
@@ -245,6 +249,7 @@
      "link-secondary",
      "link-success",
      "link-warning",
+      "lottie-animation",
      "m-0",
      "main-nav-toggler",
      "mb-0",
@@ -264,7 +269,6 @@
      "mt-3",
      "mt-5",
      "mt-auto",
-      "multi-docs-collapse-14",
      "multi-docs-collapse-15",
      "multi-file-collapse-1",
      "mx-auto",
@@ -421,9 +425,9 @@
      "accordéon",
      "alert",
      "alerte",
+      "animation",
      "badge",
      "barre-de-navigation",
-      "body-docs-collapse-14",
      "body-docs-collapse-15",
      "body-file-collapse-1",
      "bouton",
@@ -448,7 +452,6 @@
      "fichier",
      "fil-dariane",
      "file",
-      "footer-docs-collapse-14",
      "footer-docs-collapse-15",
      "footer-file-collapse-1",
      "formula-katex",
@@ -463,6 +466,7 @@
      "leaflet-map-0",
      "lien",
      "link",
+      "lottie-animation-0",
      "map",
      "mark",
      "nav",
@@ -495,4 +499,4 @@
      "tooltip"
    ]
  }
-}
+}
--- a/exampleSite/static/gatin.json
+++ b/exampleSite/static/gatin.json
--- a/go.mod
+++ b/go.mod
@@ -3,9 +3,10 @@ module github.com/gethinode/hinode
 go 1.19

 require (
-	github.com/gethinode/mod-bootstrap v1.1.1 // indirect
-	github.com/gethinode/mod-flexsearch v1.4.0 // indirect
-	github.com/gethinode/mod-fontawesome v1.3.1 // indirect
+	github.com/gethinode/mod-bootstrap v1.2.1 // indirect
+	github.com/gethinode/mod-flexsearch v1.4.1 // indirect
+	github.com/gethinode/mod-fontawesome v1.4.0 // indirect
 	github.com/gethinode/mod-katex v1.0.2 // 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.0.1 // indirect
 )
--- a/go.sum
+++ b/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,6 +48,10 @@ 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-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=
@@ -56,3 +66,9 @@ 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=
--- a/hugo_stats.json
+++ b/hugo_stats.json
@@ -16,7 +16,6 @@
      "link",
      "meta",
      "nav",
-      "ol",
      "p",
      "path",
      "script",
@@ -38,12 +37,9 @@
      "bg-primary",
      "bottom-0",
      "bottom-bar",
-      "breadcrumb",
-      "breadcrumb-item",
      "btn",
      "btn-close",
      "btn-primary",
-      "btn-social",
      "col",
      "col-12",
      "col-lg-2",
@@ -84,17 +80,12 @@
      "fa-circle-half-stroke",
      "fa-ellipsis",
      "fa-face-frown",
-      "fa-facebook",
      "fa-fw",
      "fa-github",
-      "fa-link",
      "fa-linkedin",
      "fa-medium",
      "fa-moon",
-      "fa-share-nodes",
      "fa-sun",
-      "fa-whatsapp",
-      "fa-x-twitter",
      "fab",
      "fas",
      "feature",
@@ -108,21 +99,16 @@
      "fs-3",
      "fw-30",
      "fw-bold",
-      "gap-2",
      "h-100",
-      "hstack",
      "img-fluid",
      "img-wrap",
      "invisible",
      "is-search",
      "justify-content-center",
-      "lead",
      "link-bg-footer",
      "link-secondary",
      "main-nav-toggler",
-      "mb-3",
      "mb-4",
-      "mb-5",
      "me-auto",
      "middle-bar",
      "min-vh-100",
@@ -161,13 +147,11 @@
      "px-4",
      "px-xxl-0",
      "py-2",
-      "py-3",
      "py-5",
      "py-md-1",
      "rounded",
      "row",
      "row-cols-1",
-      "row-cols-2",
      "row-cols-sm-3",
      "row-cols-sm-4",
      "search",
@@ -176,13 +160,10 @@
      "shadow",
      "svg-inline--fa",
      "switch-mode-collapsed",
-      "text-body-secondary",
      "text-center",
      "text-decoration-none",
-      "text-end",
      "text-secondary",
      "text-sm-start",
-      "text-uppercase",
      "theme-icon",
      "theme-icon-active",
      "toast",
@@ -197,11 +178,9 @@
    "ids": [
      "-theme",
      "-theme-collapsed",
-      "btn-webshare",
      "navbar-0-collapse",
      "toast-container",
-      "toast-copied-code-message",
-      "toast-message-email-4"
+      "toast-copied-code-message"
    ]
  }
-}
+}
--- a/layouts/_default/list.html
+++ b/layouts/_default/list.html
@@ -1,7 +1,5 @@
 {{- define "main" -}}
-    <!-- Ignore empty content, see https://github.com/gohugoio/hugo/issues/11406 -->
-    {{- $content := "" -}}
-    {{- if .Content }}{{ $content = partial "utilities/ProcessContent" (dict "page" .Page "raw" .RawContent) }}{{ end -}}
+    {{- $content := partial "utilities/ProcessContent" (dict "page" .Page "raw" .RawContent) -}}
    {{- partial "assets/section-list.html" (dict 
        "page" .
        "section" .Type
--- a/layouts/_default/single.html
+++ b/layouts/_default/single.html
@@ -84,8 +84,7 @@
        {{ end -}}
    {{ end }}

-    <!-- Ignore empty content, see https://github.com/gohugoio/hugo/issues/11406 -->
-    {{- if .Content }}{{ partial "utilities/ProcessContent" (dict "page" .Page "raw" .RawContent) }}{{ end -}}
+    {{ partial "utilities/ProcessContent" (dict "page" .Page "raw" .RawContent) }}
 {{ end -}}

 {{ define "partials/footer.html" -}}
@@ -100,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>
@@ -108,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>
--- a/layouts/partials/assets/breadcrumb.html
+++ b/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>
--- a/layouts/partials/assets/button.html
+++ b/layouts/partials/assets/button.html
@@ -140,7 +140,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 +157,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>

--- a/layouts/partials/assets/sidebar.html
+++ b/layouts/partials/assets/sidebar.html
@@ -9,9 +9,10 @@
    {{- $level := .level -}}
    {{- $baseURL := .baseURL -}}
    {{- $group := .group -}}
+    {{- $data := .menu -}}

    {{- $doc_slug := $group.title | urlize -}}
-    {{- $href := printf "%s/" (relLangURL (path.Join $baseURL $doc_slug)) -}}
+    {{- $href := or $group.link (printf "%s/" (relLangURL (path.Join $baseURL $doc_slug))) -}}
    {{- $collapsed := strings.HasPrefix $page.RelPermalink $href -}}

    <li class="mb-1">
@@ -28,6 +29,7 @@
                            "level" (add $level 1)
                            "baseURL" $href
                            "group" $item
+                            "menu" $data
                            )
                        }}
                    {{- else -}}
@@ -37,6 +39,8 @@
                            "level" $level
                            "baseURL" $href
                            "title" $item.title
+                            "href" $item.link
+                            "menu" $data
                            )
                        }}
                    {{ end -}}
@@ -47,15 +51,17 @@
 {{ end -}}

 {{- define "partials/sidebar/item.html" -}}
-    {{ $page := .page }}
-    {{ $sectionBreak := .sectionBreak }}
+    {{- $page := .page -}}
+    {{- $sectionBreak := .sectionBreak -}}
    {{- $level := .level -}}
-    {{ $baseURL := .baseURL}}
-    {{ $title := .title}}
+    {{- $baseURL := .baseURL -}}
+    {{- $title := .title -}}
+    {{- $href := .href -}}
+    {{- $data := .menu -}}

    {{- $doc_slug := $title | urlize -}}
-    {{- $href := printf "%s/" (relLangURL (path.Join $baseURL $doc_slug)) -}}
-    {{ $active := eq $page.RelPermalink $href }}
+    {{- $href := or $href (printf "%s/" (relLangURL (path.Join $baseURL $doc_slug))) -}}
+    {{- $active := eq (strings.TrimSuffix "/" $page.RelPermalink) (strings.TrimSuffix "/" $href) -}}

    {{ if eq $level 0}}
        <li class="mt-1 mb-1 {{ if $sectionBreak }}border-top{{ end }}"></li>
@@ -63,17 +69,27 @@
        <li>
            <ul class="btn-toggle-nav list-unstyled fw-bold pb-1">
                <li>
-                    <a href="{{ $href }}" class="sidebar-item text-decoration-none rounded {{ if $active }}active{{ end }}">
-                        {{ $title }}
-                    </a>      
+                    {{ $class := "sidebar-item text-decoration-none rounded" }}
+                    {{ if $active }}{{ $class = printf "%s active" $class }}{{ end }}
+                    {{ $link := partial "utilities/link.html" (dict "destination" $href "text" $title "class" $class "page" $page) }}
+                    {{ if $link }}
+                        {{ print $link | safeHTML }}
+                    {{ else }}
+                        {{- errorf "partial [utilities/sidebar.html] - Invalid link in file: %s" ($page.Scratch.Get "sidebarFilename") -}}
+                    {{ end }}
                </li>
            </ul>
        </li>
    {{ else }}
        <li>
-            <a href="{{ $href }}" class="sidebar-item text-decoration-none rounded small {{ if $active }}active{{ end }}">
-                {{ $title }}
-            </a>      
+            {{ $class := "sidebar-item text-decoration-none rounded small" }}
+            {{ if $active }}{{ $class = printf "%s active" $class }}{{ end }}
+            {{ $link := partial "utilities/link.html" (dict "destination" $href "text" $title "class" $class "page" $page) }}
+            {{ if $link }}
+                {{ print $link | safeHTML }}
+            {{ else }}
+                {{- errorf "partial [utilities/sidebar.html] - Invalid link in file: %s" ($page.Scratch.Get "sidebarFilename") -}}
+            {{ end }}
        </li>
    {{ end }}
 {{ end -}}
@@ -94,6 +110,7 @@
                    "level" (add $level 1)
                    "baseURL" $baseURL
                    "group" $item
+                    "menu" $data
                    )
                }}
            {{- else }}
@@ -103,6 +120,8 @@
                    "level" $level
                    "baseURL" $baseURL
                    "title" $item.title
+                    "href" $item.link
+                    "menu" $data
                    )
                }}
            {{- end }}
--- a/layouts/partials/head/head.html
+++ b/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 -}}
--- a/layouts/partials/head/stylesheet-core.html
+++ b/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" -}}
--- a/layouts/partials/head/stylesheet.html
+++ b/layouts/partials/head/stylesheet.html
@@ -1,5 +1,14 @@
+{{- $transpiler := site.Params.main.build.transpiler | default "libsass" -}}
+{{- $supportedTranspilers := slice "libsass" "dartsass" -}}
+{{- if not (in $supportedTranspilers $transpiler) -}}
+    {{- errorf "partial [head/stylesheet.html] - Invalid value for param 'transpiler': %s" $transpiler -}}
+{{- end -}}
+
 {{- $absoluteURL := site.Params.main.canonifyAssetsURLs | default false -}}
-{{- $source := .source | default "scss/app.scss" -}}
+{{- $source := .source }}
+{{- if not $source -}}
+    {{- if eq $transpiler "dartsass" }}{{ $source = "scss/app-dart.scss" }}{{ else }}{{ $source = "scss/app.scss" }}{{ end -}}
+{{- end -}}
 {{- $target := .target | default "css/main.css" -}}
 {{- $page := .page -}}
 {{- $core := .core | default true -}}
@@ -21,6 +30,7 @@
 {{- if site.Params.navigation.fixed }}{{ $navbarOffset = site.Params.navigation.offset | default "4em" }}{{ end }}
 {{- $vars := dict 
    "theme-font"              (default "Inter" site.Params.style.themeFont)
+    "font-size-base"          (default "1rem" site.Params.style.fontSizeBase)
    "primary"                 (default "#007bff" site.Params.style.primary)
    "secondary"               (default "#6c757d" site.Params.style.secondary)
    "success"                 (default "#198754" site.Params.style.success)
@@ -36,22 +46,24 @@
    "dark-mode-tint"          (default "0%" site.Params.style.darkModeTint)
 -}}

-{{- $options := (dict "transpiler" "libsass" "targetPath" $target "enableSourceMap" (not hugo.IsProduction) "vars" $vars) -}}
+{{- $options := (dict "transpiler" $transpiler "targetPath" $target "enableSourceMap" (not hugo.IsProduction) "vars" $vars) -}}
 {{- $bundle := partial "utilities/bundle" (dict "match" $source "filename" (printf "scss/bundle-%d.scss" now.UnixNano) "modules" $modules "basepath" "scss" "debugging" site.Params.debugging.showSCSS) -}}

-{{- $css := $bundle | resources.ExecuteAsTemplate $target . | toCSS $options -}}
+{{- if gt ($bundle.Content | len) 0 }}
+    {{- $css := $bundle | resources.ExecuteAsTemplate $target . | toCSS $options -}}

-{{ if $core }}
-    {{- partial "head/icons.html" (dict "css" $css) -}}
-{{ end }}
-{{- if site.Params.style.purge -}}
-    {{- $post_options := dict "config" "config" -}}
-    {{- $css = $css | resources.PostCSS $post_options -}}
-{{- end -}}
+    {{ if $core }}
+        {{- partial "head/icons.html" (dict "css" $css) -}}
+    {{ end }}
+    {{- if site.Params.style.purge -}}
+        {{- $post_options := dict "config" "config" -}}
+        {{- $css = $css | resources.PostCSS $post_options -}}
+    {{- end -}}

-{{- if not hugo.IsProduction -}}
-    <link rel="stylesheet" href="{{ if $absoluteURL }}{{ $css.Permalink }}{{ else }}{{ $css.RelPermalink }}{{ end }}">
-{{- else -}}
-    {{- $css = $css | fingerprint | resources.PostProcess -}}
-    <link rel="stylesheet" href="{{ if $absoluteURL }}{{ $css.Permalink }}{{ else }}{{ $css.RelPermalink }}{{ end }}" integrity="{{ $css.Data.Integrity }}" crossorigin="anonymous">
+    {{- if not hugo.IsProduction -}}
+        <link rel="stylesheet" href="{{ if $absoluteURL }}{{ $css.Permalink }}{{ else }}{{ $css.RelPermalink }}{{ end }}">
+    {{- else -}}
+        {{- $css = $css | fingerprint | resources.PostProcess -}}
+        <link rel="stylesheet" href="{{ if $absoluteURL }}{{ $css.Permalink }}{{ else }}{{ $css.RelPermalink }}{{ end }}" integrity="{{ $css.Data.Integrity }}" crossorigin="anonymous">
+    {{- end -}}
 {{- end -}}
--- a/layouts/partials/utilities/GetMenu.html
+++ b/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 -}}
--- a/layouts/partials/utilities/link.html
+++ b/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 }}
--- a/layouts/shortcodes/card.html
+++ b/layouts/shortcodes/card.html
@@ -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
--- a/layouts/shortcodes/link.html
+++ b/layouts/shortcodes/link.html
@@ -30,13 +30,13 @@
 {{- $anchor := "" -}}

 {{ if .IsNamedParams }}
-    {{ $href = .Get "href" | default "" -}}
-    {{ $name = .Get "name" | default "" -}}
-    {{ $url = .Get "url" | default "" -}}
-    {{ $cue = .Get "cue" | default site.Params.main.externalLinks.cue -}}
-    {{ $tab = .Get "tab" | default site.Params.main.externalLinks.tab -}}
-    {{ $case = .Get "case" | default true }}
-    {{- $class := .Get "class" | default "" -}}
+    {{- $href = .Get "href" | default "" -}}
+    {{- $name = .Get "name" | default "" -}}
+    {{- $url = .Get "url" | default "" -}}
+    {{- $cue = .Get "cue" | default site.Params.main.externalLinks.cue -}}
+    {{- $tab = .Get "tab" | default site.Params.main.externalLinks.tab -}}
+    {{- $case = .Get "case" | default true -}}
+    {{- $class = .Get "class" | default "" -}}
 {{ else }}
    {{ $href = .Get 0 }}
 {{ end }}
--- a/layouts/shortcodes/nav.html
+++ b/layouts/shortcodes/nav.html
@@ -4,7 +4,7 @@
    "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”.
 -->

 {{- $id := printf "nav-%d" .Ordinal -}}
--- a/layouts/tags/list.html
+++ b/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 }}
--- a/netlify.toml
+++ b/netlify.toml
@@ -1,19 +1,15 @@
 # toml-docs-start netlify
 [build]
    publish = "exampleSite/public"
-    # functions = "functions"
-
-[build.environment]
-    NODE_VERSION = "18.17.0"
-    NPM_VERSION = "9.6.7"
-
-[context.production]
    command = "npm run build:example"

-[context.production.environment]
-    HUGO_VERSION = "0.110.0"
+[build.environment]
+    DART_SASS_VERSION = "1.68.0"
+    HUGO_VERSION = "0.118.2"
    HUGO_ENV = "production"
    HUGO_ENABLEGITINFO = "true"
+    NODE_VERSION = "18.18.0"
+    NPM_VERSION = "9.8.1"
 # toml-docs-end netlify

 [[headers]]
@@ -74,4 +70,20 @@
    targetPort = 1313
    port = 8888
    publish = "public"
-    autoLaunch = false
+    autoLaunch = false
+
+# toml-docs-start plugins
+[[plugins]]
+    package = "@gethinode/netlify-plugin-dartsass"
+
+[[plugins]]
+    package = "netlify-plugin-hugo-cache-resources"
+	[plugins.inputs]
+	# Redirected in exampleSite/config/_default/hugo.toml
+	# srcdir = ""
+
+[[plugins]]
+    package = "@netlify/plugin-lighthouse"
+    # [plugins.inputs]
+    # output_path = "reports/lighthouse.html"
+# toml-docs-end plugins
--- a/package-lock.json
+++ b/package-lock.json
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@gethinode/hinode",
-  "version": "0.19.0-beta3",
+  "version": "0.20.5",
  "description": "Hinode is a clean documentation and blog theme for Hugo, an open-source static site generator",
  "keywords": [
    "hugo",
@@ -67,16 +67,19 @@
  "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.49.0",
    "eslint-config-standard": "^17.1.0",
    "eslint-plugin-import": "^2.28.1",
-    "eslint-plugin-n": "^16.0.2",
+    "eslint-plugin-n": "^16.1.0",
    "eslint-plugin-promise": "^6.1.1",
    "hugo-bin": "^0.114.2",
-    "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",
@@ -84,7 +87,7 @@
    "rimraf": "^5.0.1",
    "shx": "^0.3.4",
    "stylelint": "^15.10.3",
-    "stylelint-config-standard-scss": "^10.0.0"
+    "stylelint-config-standard-scss": "^11.0.0"
  },
  "optionalDependencies": {
    "fsevents": "*"
--- a/theme.toml
+++ b/theme.toml
@@ -6,7 +6,7 @@ homepage = "https://gethinode.com"
 demosite = "https://demo.gethinode.com"
 tags = ["blog", "documentation", "minimal", "modern", "customizable", "search", "bootstrap"]
 features = ["security aware", "fast by default", "seo-ready", "development tools", "bootstrap framework", "netlify-ready", "full text search", "page layouts", "versioned documentation"]
-min_version = "0.110.0"
+min_version = "0.118.0" # fixes Hugo issue #11406

 [author]
  name = "Mark Dumay"
Author	SHA1	Message	Date
Mark Dumay	529b0db71d	Merge pull request #532 from gethinode/develop Support custom icons	2023-09-25 08:12:58 +02:00
mark	bd142ac66d	Bump package version	2023-09-25 07:39:01 +02:00
mark	3749937799	Add custom icon example	2023-09-25 07:38:54 +02:00
mark	16d309cc34	Update build stats	2023-09-25 07:38:11 +02:00
Mark Dumay	5315bc950a	Merge pull request #531 from gethinode/main Sync with main	2023-09-25 07:34:08 +02:00
Mark Dumay	2dbf6a9faf	Merge pull request #530 from gethinode/hugo-mod-dependencies Update Hugo module dependencies	2023-09-25 07:22:20 +02:00
markdumay	a67e38bd1b	fix: update Hugo module dependencies	2023-09-25 05:14:37 +00:00
Mark Dumay	4688176216	Merge pull request #529 from gethinode/develop Add animation support	2023-09-24 06:31:05 +02:00
mark	dbee9aafd7	Prevent processing of empty scss bundles	2023-09-24 05:58:27 +02:00
mark	8c20617b1a	Bump dependencies	2023-09-23 17:27:24 +02:00
Mark Dumay	9e2ed6480d	Merge branch 'main' into develop	2023-09-23 17:08:35 +02:00
mark	7ef1b1aba9	Remove newlines	2023-09-23 17:07:51 +02:00
mark	b74071d4cf	Bump package release	2023-09-23 16:59:17 +02:00
mark	dc7578a5c3	Add animation support	2023-09-23 16:58:38 +02:00
Mark Dumay	2227cf5fe2	Standardize capitalization	2023-09-22 07:21:31 +02:00
Mark Dumay	1296595ff7	Merge pull request #528 from gethinode/develop Support configurable font size	2023-09-22 07:19:59 +02:00
Mark Dumay	94f0b7599d	Merge branch 'main' into develop	2023-09-22 07:07:04 +02:00
mark	481d3099eb	Bump package release	2023-09-22 07:06:31 +02:00
mark	d9a718d934	Support configurable font size	2023-09-22 07:05:09 +02:00
github-actions[bot]	e396bcce82	Merge pull request #527 from gethinode/dependabot/npm_and_yarn/autoprefixer-10.4.16 Bump autoprefixer from 10.4.15 to 10.4.16	2023-09-21 13:59:34 +00:00
dependabot[bot]	b80b45f126	Bump autoprefixer from 10.4.15 to 10.4.16 Bumps [autoprefixer](https://github.com/postcss/autoprefixer) from 10.4.15 to 10.4.16. - [Release notes](https://github.com/postcss/autoprefixer/releases) - [Changelog](https://github.com/postcss/autoprefixer/blob/main/CHANGELOG.md) - [Commits](https://github.com/postcss/autoprefixer/compare/10.4.15...10.4.16) --- updated-dependencies: - dependency-name: autoprefixer dependency-type: direct:development update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] <support@github.com>	2023-09-21 13:51:27 +00:00
Mark Dumay	b9a9a84982	Merge pull request #526 from gethinode/develop Fix height for stand-alone cards	2023-09-20 15:57:30 +02:00
Mark Dumay	32a582dc66	Merge branch 'main' into develop	2023-09-20 06:58:50 +02:00
mark	ce7362a6f5	Fix height for stand-alone cards	2023-09-20 06:58:25 +02:00
Mark Dumay	c3541f0368	Merge pull request #525 from gethinode/develop Use link title in navigation	2023-09-20 06:58:12 +02:00
Mark Dumay	fa9da5147d	Merge branch 'main' into develop	2023-09-20 06:25:03 +02:00
mark	9905581b63	Use link title in navigation controls	2023-09-20 06:23:40 +02:00
mark	4fe871d5c1	Use link title in breadcrumb by default	2023-09-20 06:04:01 +02:00
mark	4e5e39624b	Improve layout	2023-09-20 06:02:54 +02:00
github-actions[bot]	7174c8ac39	Merge pull request #524 from gethinode/dependabot/npm_and_yarn/markdownlint-cli2-0.10.0 Bump markdownlint-cli2 from 0.9.2 to 0.10.0	2023-09-18 13:57:58 +00:00
dependabot[bot]	37c26de1ce	Bump markdownlint-cli2 from 0.9.2 to 0.10.0 Bumps [markdownlint-cli2](https://github.com/DavidAnson/markdownlint-cli2) from 0.9.2 to 0.10.0. - [Changelog](https://github.com/DavidAnson/markdownlint-cli2/blob/main/CHANGELOG.md) - [Commits](https://github.com/DavidAnson/markdownlint-cli2/compare/v0.9.2...v0.10.0) --- updated-dependencies: - dependency-name: markdownlint-cli2 dependency-type: direct:development update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] <support@github.com>	2023-09-18 13:51:02 +00:00
Mark Dumay	a56030eb53	Merge pull request #523 from gethinode/develop Fix rendering of button title	2023-09-16 19:53:53 +02:00
mark	686a54b666	Standardize args documentation	2023-09-16 14:51:28 +02:00
mark	3f3c19aeaa	Bump package version	2023-09-16 14:51:23 +02:00
Mark Dumay	0ff114b51d	Merge branch 'main' into develop	2023-09-16 14:48:21 +02:00
mark	f8deb13215	Fix rendering of button title	2023-09-16 07:12:27 +02:00
github-actions[bot]	b4669878a6	Merge pull request #521 from gethinode/dependabot/npm_and_yarn/eslint-8.49.0 Bump eslint from 8.48.0 to 8.49.0	2023-09-11 13:39:10 +00:00
dependabot[bot]	68210961be	Bump eslint from 8.48.0 to 8.49.0 Bumps [eslint](https://github.com/eslint/eslint) from 8.48.0 to 8.49.0. - [Release notes](https://github.com/eslint/eslint/releases) - [Changelog](https://github.com/eslint/eslint/blob/main/CHANGELOG.md) - [Commits](https://github.com/eslint/eslint/compare/v8.48.0...v8.49.0) --- updated-dependencies: - dependency-name: eslint dependency-type: direct:development update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] <support@github.com>	2023-09-11 13:31:01 +00:00
github-actions[bot]	6af0d9b062	Merge pull request #522 from gethinode/dependabot/npm_and_yarn/eslint-plugin-n-16.1.0 Bump eslint-plugin-n from 16.0.2 to 16.1.0	2023-09-11 13:30:16 +00:00
dependabot[bot]	ad401a8747	Bump eslint-plugin-n from 16.0.2 to 16.1.0 Bumps [eslint-plugin-n](https://github.com/eslint-community/eslint-plugin-n) from 16.0.2 to 16.1.0. - [Release notes](https://github.com/eslint-community/eslint-plugin-n/releases) - [Commits](https://github.com/eslint-community/eslint-plugin-n/compare/16.0.2...16.1.0) --- updated-dependencies: - dependency-name: eslint-plugin-n dependency-type: direct:development update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] <support@github.com>	2023-09-11 13:20:31 +00:00
Mark Dumay	e0ca123aa2	Merge pull request #520 from gethinode/develop Support sidebar links	2023-09-08 12:53:52 +02:00
Mark Dumay	ef3636befe	Merge branch 'main' into develop	2023-09-08 10:31:13 +02:00
mark	5635f895df	Fix #510	2023-09-08 10:30:23 +02:00
Mark Dumay	779f9b11a7	Merge pull request #519 from gethinode/hugo-mod-dependencies Update Hugo module dependencies	2023-09-08 06:24:08 +02:00
markdumay	b0b8e9d684	fix: update Hugo module dependencies	2023-09-08 03:15:41 +00:00
Mark Dumay	b4f7163913	Merge pull request #518 from gethinode/develop Bump package version	2023-09-07 06:39:09 +02:00
Mark Dumay	6ef4738619	Merge branch 'main' into develop	2023-09-07 06:28:24 +02:00
mark	333e4c3e07	Bump package version	2023-09-07 06:27:53 +02:00
Mark Dumay	705900dd27	Merge pull request #517 from gethinode/develop Add Netlify plugins	2023-09-06 16:28:59 +02:00
Mark Dumay	363b6293af	Merge branch 'main' into develop	2023-09-06 16:12:53 +02:00
mark	97ef22d3fb	Bump package version	2023-09-06 16:10:12 +02:00
mark	f7fa573347	Configure plugins	2023-09-06 16:09:36 +02:00
Mark Dumay	971b61fe8a	Merge pull request #516 from gethinode/develop Fix base settings	2023-09-06 10:36:39 +02:00
mark	303a611913	Restore base settings	2023-09-06 10:28:34 +02:00
Mark Dumay	066a9f1722	Merge pull request #515 from gethinode/main Sync with main	2023-09-06 10:27:23 +02:00
Mark Dumay	ac5cddf448	Merge pull request #512 from gethinode/hugo-mod-dependencies Update Hugo module dependencies	2023-09-06 10:15:39 +02:00
Mark Dumay	d6bea30b24	Merge branch 'main' into hugo-mod-dependencies	2023-09-06 08:09:48 +02:00
Mark Dumay	ac05154eec	Merge pull request #514 from markdumay/dart Add support for Dart Sass	2023-09-06 08:08:56 +02:00
Mark Dumay	ff579b0cfc	Merge branch 'main' into dart	2023-09-06 07:43:30 +02:00
Mark Dumay	13ede1b2a4	Add Dart Sass installation	2023-09-06 07:42:50 +02:00
Mark Dumay	51c7706af2	Add Dart Installation	2023-09-06 07:41:39 +02:00
Mark Dumay	5a3c2c298b	Merge branch 'main' into dart	2023-09-06 07:25:17 +02:00
mark	608e8609c6	Fix linting issues	2023-09-06 07:21:08 +02:00
mark	60edf6d444	Optimize stylesheet processing	2023-09-06 07:16:50 +02:00
mark	28c79f30a2	Address Dart Sass warnings and variable handling	2023-09-06 07:15:03 +02:00
mark	89fcd7413f	Update dependencies	2023-09-06 07:11:20 +02:00
markdumay	5741027a54	fix: update Hugo module dependencies	2023-09-06 03:15:29 +00:00
github-actions[bot]	6598ca5335	Merge pull request #509 from gethinode/dependabot/npm_and_yarn/stylelint-config-standard-scss-11.0.0 Bump stylelint-config-standard-scss from 10.0.0 to 11.0.0	2023-09-04 13:19:24 +00:00
dependabot[bot]	5024bac01e	Bump stylelint-config-standard-scss from 10.0.0 to 11.0.0 Bumps [stylelint-config-standard-scss](https://github.com/stylelint-scss/stylelint-config-standard-scss) from 10.0.0 to 11.0.0. - [Release notes](https://github.com/stylelint-scss/stylelint-config-standard-scss/releases) - [Changelog](https://github.com/stylelint-scss/stylelint-config-standard-scss/blob/main/CHANGELOG.md) - [Commits](https://github.com/stylelint-scss/stylelint-config-standard-scss/compare/v10.0.0...v11.0.0) --- updated-dependencies: - dependency-name: stylelint-config-standard-scss dependency-type: direct:development update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] <support@github.com>	2023-09-04 13:14:00 +00:00
mark	499a481baa	Set default transpiler	2023-09-03 13:05:17 +02:00
mark	7d4ab6ff58	Support configurable transpiler	2023-09-03 13:02:47 +02:00
mark	9c93d5e336	Adjust package version	2023-09-03 09:00:57 +02:00
mark	19af20457e	Add dart-sass installation to build command	2023-09-03 08:49:22 +02:00
mark	1cdc165b1c	Update base URL	2023-09-03 08:40:30 +02:00
Mark Dumay	ede8fe8066	Merge pull request #507 from gethinode/develop Fix issues with table and link	2023-09-02 16:26:15 +02:00
mark	51046d9646	Bump package version	2023-09-02 15:44:31 +02:00
mark	f2fd933f50	Update build stats	2023-09-02 15:43:08 +02:00
mark	8d16d50171	Increase min required version of Hugo	2023-09-02 15:42:49 +02:00
mark	3e3e2486ee	Remove workaround for incorrect raw content	2023-09-02 15:42:17 +02:00
Mark Dumay	780707d821	Merge branch 'main' into develop	2023-09-02 15:31:43 +02:00
mark	8ac0f752ba	Fix class init of link shortcode	2023-09-02 09:36:54 +02:00
mark	180641a72b	Refine table colors in dark mode	2023-09-02 09:06:07 +02:00