Merge pull request #693 from gethinode/validation

Refine argument validation of modules

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2023 Mark Dumay
+Copyright (c) 2024 Mark Dumay
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

config/_default/hugo.toml

@@ -1,6 +1,6 @@
 # toml-docs-start main
 title = "Hinode"
-copyright = "Copyright © 2023 Mark Dumay."
+copyright = "Copyright © 2024 Mark Dumay."
 paginate = 9
 enableGitInfo = true
 # toml-docs-end main
@@ -132,4 +132,6 @@ home = ["HTML", "RSS", "REDIR"]
     path = "github.com/gethinode/mod-leaflet"
   [[module.imports]]
     path = "github.com/gethinode/mod-lottie"
+  [[module.imports]]
+    path = "github.com/gethinode/mod-utils"
 # toml-docs-end modules

config/postcss.config.js

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

data/structures/accordion.yml

@@ -6,7 +6,7 @@ arguments:
     type: string
     optional: true
     comment: >-
-      ID of the accordion, defaults to “accordion-n” with a sequential number n.
+      ID of the accordion, defaults to `accordion-n` with a sequential number n.
   always-open:
     type: bool
     optional: true
@@ -15,4 +15,4 @@ arguments:
   class:
     type: string
     optional: true
-    comment: Class attribute of the accordion, e.g. “w-50”.
+    comment: Class attribute of the accordion, e.g. `w-50`.

data/structures/badge.yml

@@ -3,7 +3,7 @@ comment: >-
 arguments:
   title:
     type: string
-    optional: true
+    optional: false
     comment: >-
       Title of the badge.
   class:

data/structures/button.yml

@@ -12,7 +12,7 @@ arguments:
     type: string
     optional: true
     comment: >-
-      Class attribute of the button element, e.g. “p-5”.
+      Class attribute of the button element, e.g. `p-5`.
   color:
     type: select
     optional: true
@@ -48,7 +48,7 @@ arguments:
   id:
     type: string
     optional: true
-    comment: ID of the button, to be used in the DOM.
+    comment: Identifier of the button, to be used in the DOM.
   state:
     type: select
     optional: true
@@ -61,7 +61,7 @@ arguments:
         - active
         - inactive
   size:
-    type: string
+    type: select
     optional: true
     default: md
     comment: Size of the button.
@@ -85,7 +85,12 @@ arguments:
     comment: >-         
       Assistive label for the button or badge. The label is applied
       to the badge instead of the button when a badge has been defined.
-      The default value of the button aria-label is its title.
+      The default value of the button's assistive label is its title.
+  aria-label:
+    type: string
+    optional: true
+    comment: Alias for label.
+    group: shortcode
   tooltip:
     type: string
     optional: true
@@ -108,7 +113,7 @@ arguments:
         - link
         - button
   placement:
-    type: string
+    type: select
     optional: true
     default: top
     comment: Position of the tooltip.
@@ -134,7 +139,7 @@ arguments:
         - first
         - last
   justify:
-    type: string
+    type: select
     optional: true
     default: center
     comment: Justification of the button title and icon.
@@ -149,7 +154,7 @@ arguments:
   toast:
     type: string
     optional: true
-    comment: ID of the toast to display when the button is clicked.
+    comment: Identifier (ID) of the toast to display when the button is clicked.
   clipboard:
     type:
       - string
@@ -174,6 +179,7 @@ arguments:
     comment: >-
       Dictionary of key-value pairs added as custom attributes to the button
       element ('<a>').
+    group: partial
   spacing:
     type: bool
     optional: true

data/structures/card-group.yml

@@ -11,11 +11,11 @@ arguments:
       - '*hugolib.pageForShortcode'
     optional: true
     comment: Context of the current page.
+    group: partial
   title:
     type: string
     optional: true
-    comment: >-
-      Title of the card, replaces the title of the referenced page (if any).
+    comment: Title of the card group.
   gutter:
     type: int
     optional: true
@@ -24,20 +24,24 @@ arguments:
     options:
       min: 0
       max: 5
+    release: v0.19.0
   list:
     type:
       - page.Pages
       - resource.Resources
     optional: true
     comment: Array of pages to be rendered as cards.
+    group: partial
   cards:
     type: string
     optional: true
     comment: String of rendered cards.
+    group: partial
   max:
     type: int
     optional: true
     comment: Maximum number of cards to display.
+    group: partial
   cols:
     type: select
     optional: true
@@ -51,23 +55,27 @@ arguments:
         - "4"
         - "5"
         - "auto"
+    release: v0.19.0
   paginate:
     type: bool
     optional: true
     comment: >-
       Flag indicating if pagination should be added to the card group, if the
       list exceeds the maximum number of cards to display. 
+    group: partial
   href:
     type: string
     optional: true
     comment: >-
-      address for the button or hyperlink. If set, a button is added if the
+      Address for the button or hyperlink. If set, a button is added if the
       list exceeds the maximum number of cards to display.
+    group: partial
   hrefTitle:
     type: string
     optional: true
     comment: >-
       Title of the button or hyperlink as companion to href.
+    group: partial
   separator:
     type: bool
     optional: true

data/structures/card.yml

@@ -108,15 +108,14 @@ arguments:
       - string
       - template.HTML
     optional: true
-    parent: cascade
     comment: >-
       Description of the card.
     group: partial
   loading:
     type: select
     optional: true
-    default: eager
     parent: cascade
+    default: eager
     comment: >-
       Loading behavior of the image. The loading of lazily loaded images is
       deferred until the image is within scrolling range of the viewport. This
@@ -130,7 +129,6 @@ arguments:
   thumbnail:
     type: path
     optional: true
-    parent: cascade
     comment: >-
       Thumbnail image url, displayed on top or the left of the card.
   ratio:
@@ -157,7 +155,6 @@ arguments:
   icon:
     type: string
     optional: true
-    parent: cascade
     comment: >-
       Font Awesome icon, displayed on top or the left of the card.
   orientation:

data/structures/carousel-item.yml

@@ -24,6 +24,7 @@ arguments:
         - 4x3
         - 16x9
         - 21x9
+    group: partial
   portrait:
     type: bool
     optional: true
@@ -32,6 +33,7 @@ arguments:
       Flag to adjust the ratio from landscape to portrait. The image itself
       is not rotated, only the crop area is adjusted. Not applicable to vector
       graphics.
+    group: partial
   loading:
     type: select
     default: eager

data/structures/carousel.yml

@@ -1,14 +1,14 @@
 comment: >-
   Displays a carousel of several responsive images (see the image shortcode for
-  more details). Add inner <img> elements to define individual image slides.
+  more details). Add inner `img` elements to define individual image slides.
 arguments:
   id:
     type: string
     optional: true
     comment: >-
-      ID of the carousel, defaults to `carousel-` with a sequential number.
+      ID of the carousel, defaults to `carousel-n` with a sequential number `n`.
   ratio:
-    type: string
+    type: select
     optional: true
     comment: >-
       Ratio of the images. If set, the images are resized and cropped to match the
@@ -28,11 +28,12 @@ arguments:
       Flag to adjust the ratio from landscape to portrait. The images themselves
       are not rotated, only the crop area is adjusted. Not applicable to vector
       graphics.
+    release: v0.18.3
   class:
     type: string
     optional: true
-    comment: Class attribute of the carousel element, e.g. “w-75”.
+    comment: Class attribute of the carousel element, e.g. `w-75`.
 body:
   type: string
   optional: false
-  comment: Inner <img> elements that define the individual image slides.
+  comment: Inner `img` elements that define the individual image slides.

data/structures/command.yml

@@ -18,7 +18,7 @@ arguments:
     type: select
     optional: true
     default: bash
-    comment: Type of shell
+    comment: Type of shell.
     options:
       values:
         - bash

data/structures/docs.yml

@@ -30,11 +30,15 @@ arguments:
     optional: true
     default: true
     comment: >-
-      If unset, shows the filename only. By default, the full relative path is
-      shown.
+      If unset, shows the filename only. By default, the entire path (relative
+      to the base path) is shown.
   id:
     type: string
     optional: true
     comment: >-
       ID of the collapse panel holding the code snippet, defaults to
       `docs-collapse-n` with a sequential number `n` starting at `1`.
+  class:
+    type: string
+    optional: true
+    comment: Class attribute of the tab control that wraps the docs element.

data/structures/example.yml

@@ -2,11 +2,17 @@ comment: >-
   Display a code example and render a preview of the same input. The shortcode
   accepts the languages supported by Hugo's highlight function.
 arguments:
+  id:
+    type: string
+    optional: true
+    comment: Identifier of the element’s container.
   lang:
     type: string
     optional: true
     default: markdown
-    comment: Language used to display the code.
+    comment: >-
+      Language used to display the code. Use `hugo` to process Hugo (escaped)
+      shortcodes.
   show_markup:
     type: bool
     optional: true

data/structures/file.yml

@@ -21,19 +21,20 @@ arguments:
     comment: >-
       If unset, shows the panel with the code in collapsed state. By default,
       the panel is expanded.
-  full: 
-    type: string
+  full:
+    type: bool
     optional: true
+    default: true
     comment: >-
-      If unset, shows the filename only. By default, the full relative path is
-      shown.
+      If unset, shows the filename only. By default, the entire path (relative
+      to the base path) is shown.
   id: 
     type: string
     optional: true
     comment: >- 
-      ID of the collapse panel, defaults to `file-collapse-n` with a sequential
-      number `n` starting at 1.
+      Identifier of the collapse panel, defaults to `file-collapse-n` with a
+      sequential number `n` starting at 1.
   class:
     type: string
     optional: true
-    comment: Class argument of the tab control.
+    comment: Class attribute of the tab control that wraps the file element.

data/structures/image.yml

@@ -21,7 +21,10 @@ arguments:
   url:
     type: string
     optional: true
-    comment: Path or url of the image, e.g. `img/example.jpg`.
+    comment: >-
+      Path or url of the image, e.g. `img/example.jpg`. Images with multiple
+      color modes are expected to have a basename that ends with either `-dark`
+      or `-light`.
   src:
     type: string
     optional: true
@@ -39,9 +42,12 @@ arguments:
     type: bool
     default: false
     optional: true
-    comment: Flag indicating if the image should support color modes.
+    comment: >-
+      Flag indicating if the image should support color modes. If set, the
+      shortcode searches for images that having a matching color-mode suffix
+      such as `-light` or `-dark`.
   ratio:
-    type: string
+    type: select
     optional: true
     comment: >-
       Ratio of the image. If set, the image is resized and cropped to match the
@@ -62,6 +68,7 @@ arguments:
       Flag to adjust the ratio from landscape to portrait. The image itself is
       not rotated, only the crop area is adjusted. Not applicable to vector
       graphics.
+    release: v0.18.3
   loading:
     type: select
     default: eager
@@ -75,6 +82,7 @@ arguments:
       values:
         - eager
         - lazy
+    release: v0.21.0
   priority:
     type: select
     default: auto
@@ -102,6 +110,7 @@ arguments:
     type: string
     optional: true
     comment: Class attributes of the wrapper element, e.g. `mx-auto`.
+    release: v0.18.3
   class:
     type: string
     optional: true

data/structures/link.yml

@@ -25,8 +25,8 @@ arguments:
     position: 0
     optional: true
     comment: >-
-       Reference to either an external link (if it starts with http), a named
-       link (if it can be found in params.links), or internal reference.
+       Reference to either an external link (if it starts with `http`), a named
+       link (if it can be found in `params.links`), or internal reference.
        Both external and internal references may include an anchor `#`.
   name:
     type: string

data/structures/mark.yml

@@ -9,7 +9,7 @@ arguments:
     optional: true
     comment: >-
       Theme color of the highlight. By default, the highlight uses the color of
-      the HTML mark function.
+      the HTML mark function (usually yellow).
     options:
       values:
         - primary

data/structures/nav-item.yml

@@ -1,25 +1,25 @@
 comment: >-
-  Defines an individual nav item.
+  Defines an individual item.
 arguments:
   id:
     type: string
     optional: true
-    comment: ID of the nav-item.
-    parent: cascade
+    comment: Identification of the item.
+    group: partial
   parentID:
     type: string
     optional: false
-    comment: ID of the parent (e.g. nav control).
+    comment: Identification of the parent (e.g. nav control).
     group: partial
   header:
     type: string
     optional: false
-    comment: Header of the nav item.
+    comment: Header of the item.
   show:
     type: bool
     optional: true
     comment: >-
-      Flag to indicate the nav item should be shown. Only one can be shown at a
+      Flag to indicate if the item should be shown. Only one can be shown at a
       time.
   disabled:
     type: bool
@@ -33,13 +33,13 @@ arguments:
   class:
     type: string
     optional: true
-    comment: Class attribute of the nav item.
+    comment: Class attribute of the item.
   body:
     type:
       - string
       - template.HTML
     optional: true
-    comment: The body content of the nav-item, supports Markdown and HTML (if enabled).
+    comment: The body content of the item, supports Markdown and HTML (if enabled).
     group: partial
   item_type:
     type: select
@@ -52,5 +52,5 @@ arguments:
     group: partial
 body:
   optional: false
-  comment: Content of the nav item.
+  comment: Content of the item.
   group: shortcode

data/structures/nav.yml

@@ -44,7 +44,7 @@ arguments:
   class:
     type: string
     optional: true
-    comment: Class attribute of the tab group, e.g. “nav-fill”.
+    comment: Class attribute of the tab group, e.g. `nav-fill`.
   pane:
     type: select
     optional: true

data/structures/navbar.yml

@@ -28,7 +28,12 @@ arguments:
   color:
     type: select
     optional: true
-    comment: Background theme color of the navbar.
+    comment: >-
+      Background theme color of the navbar. Set the color to `body` or
+      `body-tertiary` for the navbar to respond to color mode  changes (e.g.
+      switching between dark and light). The navigation bar is transparent when
+      no color is set, but is set to the body color when scrolling to enhance
+      the contrast.
     options:
       values:
         - primary
@@ -47,9 +52,9 @@ arguments:
     type: string
     optional: true
     comment: >-
-      ID of the navbar, defaults to `navbar-0`. The id is used by several child
-      elements, including a color mode switcher, version switcher, and collapse
-      panel.
+      Identification of the navbar, defaults to `navbar-0`. The id is used by
+      several child elements, including a color mode switcher, version switcher,
+      and collapse panel.
   menus:
     type: string
     optional: true
@@ -76,6 +81,7 @@ arguments:
       values:
         - light
         - dark
+    group: partial
   mode:
     type: bool
     optional: true

data/structures/persona.yml

@@ -16,7 +16,7 @@ arguments:
   class:
     type: string
     optional: true
-    comment: Class attribute of the card element, e.g. “w-50”.
+    comment: Class attribute of the card element, e.g. `w-50`.
   color:
     type: select
     optional: true

data/structures/release.yml

@@ -23,7 +23,7 @@ arguments:
     type: select
     optional: true
     default: md
-    comment: Size of the button
+    comment: Size of the button.
     options:
       values:
         - sm
@@ -36,4 +36,5 @@ arguments:
   inline:
     type: bool
     optional: true
-    comment: Flag to render the release button inline (defaults to false).
+    default: false
+    comment: Flag to render the release button inline.

data/structures/spinner.yml

@@ -6,7 +6,7 @@ arguments:
     type: string
     optional: true
     comment: >-
-      Class attribute of the wrapping element, e.g. “text-center”.
+      Class attribute of the wrapping element, e.g. `text-center`.
   color:
     type: select
     optional: true

data/structures/sub.yml

@@ -5,4 +5,4 @@ arguments:
     type: string
     optional: false
     position: 0
-    comment: Text to display in subscript.
+    comment: Text to display in subscript. You can omit the argument name.

data/structures/sup.yml

@@ -5,4 +5,4 @@ arguments:
     type: string
     optional: false
     position: 0
-    comment: Text to display in superscript.
+    comment: Text to display in superscript. You can omit the argument name.

data/structures/youtube.yml

@@ -18,7 +18,7 @@ arguments:
     type: string
     optional: false
     position: 0
-    comment: ID of the video to be embedded.
+    comment: Identifier of the video to be embedded.
   autoplay:
     type: bool
     optional: true

exampleSite/config/_default/hugo.toml

@@ -1,6 +1,6 @@
 resourcedir = '../resources/'
 title = "Hinode"
-copyright = "Copyright © 2023 Mark Dumay."
+copyright = "Copyright © 2024 Mark Dumay."
 paginate = 9
 enableGitInfo = true
 

exampleSite/config/postcss.config.js

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

exampleSite/hugo_stats.json

@@ -39,14 +39,8 @@
       "sub",
       "sup",
       "svg",
-      "table",
-      "tbody",
-      "td",
-      "th",
-      "thead",
       "time",
       "title",
-      "tr",
       "ul",
       "use"
     ],
@@ -379,8 +373,6 @@
       "syntax-highlight",
       "tab-content",
       "tab-pane",
-      "table",
-      "table-responsive",
       "tag-link",
       "text-bg-body",
       "text-bg-body-tertiary",

go.mod

@@ -6,10 +6,11 @@ require (
 	github.com/airbnb/lottie-web v5.12.2+incompatible // indirect
 	github.com/gethinode/mod-bootstrap v1.2.2 // indirect
 	github.com/gethinode/mod-flexsearch v1.7.1 // indirect
-	github.com/gethinode/mod-fontawesome v1.7.3 // indirect
+	github.com/gethinode/mod-fontawesome v1.8.0 // indirect
 	github.com/gethinode/mod-katex v1.0.5 // indirect
-	github.com/gethinode/mod-leaflet v0.3.5 // indirect
-	github.com/gethinode/mod-lottie v1.3.0 // indirect
+	github.com/gethinode/mod-leaflet v0.4.0 // indirect
+	github.com/gethinode/mod-lottie v1.4.0 // indirect
+	github.com/gethinode/mod-utils v1.0.0 // indirect
 	github.com/nextapps-de/flexsearch v0.0.0-20230711092928-1243fd883ec3 // indirect
 	github.com/twbs/bootstrap v5.3.2+incompatible // indirect
 )

go.sum

@@ -72,6 +72,8 @@ github.com/gethinode/mod-fontawesome v1.6.1 h1:iqOgDGdw7Bs4hnzjF/8JsUn10omyKQZTg
 github.com/gethinode/mod-fontawesome v1.6.1/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
 github.com/gethinode/mod-fontawesome v1.7.3 h1:YzRCYSasVRIcImVmTJYjqNJ+KmyNWfm/bMgtM0slvzs=
 github.com/gethinode/mod-fontawesome v1.7.3/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
+github.com/gethinode/mod-fontawesome v1.8.0 h1:YEuCmvCdzcemF1eFK35Wnp1asKKO3/xbxGArnjq6PRY=
+github.com/gethinode/mod-fontawesome v1.8.0/go.mod h1:uvuC2YL8mdXNp6NRzFOu4TWsHvtY9AZ8YxJkF23/M/8=
 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=
@@ -94,6 +96,8 @@ github.com/gethinode/mod-leaflet v0.3.4 h1:oY+YQ0JiJuhFQNrk9XgFdg0NMsTUQPXNfnILp
 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-leaflet v0.4.0 h1:Xc6c1UTf4m1saQLFfFWT5sEpwj25xVGuS8csGC82UUI=
+github.com/gethinode/mod-leaflet v0.4.0/go.mod h1:yr+bUKAstifdB16mbYh69OayAmgPOlNUubAmVn5eL2M=
 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=
@@ -106,6 +110,10 @@ github.com/gethinode/mod-lottie v1.2.0 h1:9S0Y4PlEO66dIvFxayatmDEf8WWxqbLNLi4z56
 github.com/gethinode/mod-lottie v1.2.0/go.mod h1:erRCgSL2FCfKHI0jQbSpM+g0jXl7SjKVJrh7kWGteKs=
 github.com/gethinode/mod-lottie v1.3.0 h1:vQ8CXkjdp2IeFskTzu+ZnKOEio8GtN08urVK+oCH81E=
 github.com/gethinode/mod-lottie v1.3.0/go.mod h1:erRCgSL2FCfKHI0jQbSpM+g0jXl7SjKVJrh7kWGteKs=
+github.com/gethinode/mod-lottie v1.4.0 h1:0Ls1Q/8p0gQpuX9+dtfNGKcjBNeymjE7gERdnN3lCCE=
+github.com/gethinode/mod-lottie v1.4.0/go.mod h1:57eu6glS5oxkew2dB1P2zsbhw444aRX0XfuyDe7k/dk=
+github.com/gethinode/mod-utils v1.0.0 h1:cqHm2xS5uDiJzRm1KfHaNbq6uMVDKLhQa8/BuTZ1nhY=
+github.com/gethinode/mod-utils v1.0.0/go.mod h1:ONJm3pHCq7nvaPNjusLZNCeCbhOhSBH4HVKHwK1FdYE=
 github.com/nextapps-de/flexsearch v0.0.0-20230711092928-1243fd883ec3 h1:H/qVR5O4BXjRjD+5PZB+r4ug2BSJ2Of4RtwOntd+OKo=
 github.com/nextapps-de/flexsearch v0.0.0-20230711092928-1243fd883ec3/go.mod h1:5GdMfPAXzbA2gXBqTjC6l27kioSYzHlqDMh0+wyx7sU=
 github.com/twbs/bootstrap v5.3.2+incompatible h1:tuiO5acc6xnZUR77Sbi5aKWXxjYxbmsSbJwYrhAKoQQ=

layouts/partials/assets/breadcrumb.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->

layouts/partials/assets/button.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->

layouts/partials/assets/card-group.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->
@@ -84,12 +84,13 @@
             {{- $params := (dict
                 "class" (printf "h-100 %s" $class)
                 "color" $color
-                "padding" $padding
-                "header" $header
                 "footer" $footer
-                "orientation" $orientation
-                "ratio" $ratio
+                "gutter" $gutter
+                "header" $header
                 "loading" $loading
+                "orientation" $orientation
+                "padding" $padding
+                "ratio" $ratio
             ) -}}
             {{- $params = merge $params $element }}
 

layouts/partials/assets/card.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->

layouts/partials/assets/carousel-item.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->

layouts/partials/assets/image.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->

layouts/partials/assets/link.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->

layouts/partials/assets/nav-item.html

@@ -1,6 +1,6 @@
 
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->

layouts/partials/assets/nav.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->

layouts/partials/assets/navbar-item.html

@@ -52,11 +52,12 @@
     {{ if $isIcon }}aria-label="{{ $menu.Name }}"{{ end }}
     data-nav="main" data-nav-main="{{ $mainNav }}"{{ with $childNav }} data-nav-child="{{ . }}"{{ end }} 
     href="{{ $menuURL }}{{ $params | safeHTMLAttr }}"{{ with $externalHref }} {{ . | safeHTMLAttr }}{{ end }} {{ $button | safeHTMLAttr }}>
+    
     {{- with $menu.Pre }}
         {{ if hasPrefix . "<i" }}
             {{ . | safeHTML }}
         {{ else }}
-            {{ partial "assets/icon.html" (dict "icon" . )}}
+            {{ partial "assets/icon.html" (dict "icon" (string .) )}}
         {{ end }}
     {{ end -}}
     <span {{ if $isActive }} class="active"{{ end }}>{{ if not $isIcon }}{{ $menu.Name }}{{ end }}</span>

layouts/partials/assets/navbar.html

@@ -1,9 +1,11 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->
 
+<!-- TODO: consider to drop style arg -->
+
 {{ $error := false }}
 
 <!-- Validate arguments -->

layouts/partials/assets/persona.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->
@@ -26,7 +26,7 @@
 {{- $content := .content -}}
 {{- $thumbnail := .thumbnail -}}
 
-{{- $color := .color -}}
+{{- $color := .color | default "primary" -}}
 
 {{- with $page -}}
     {{- if not $title }}{{ $title = .Title }}{{ end -}}

layouts/partials/assets/section-list.html

@@ -32,7 +32,7 @@
 {{- $layout := "card" -}}
 {{- $pane := "none" -}}
 {{- $type := "pills" -}}
-{{- $vertical := "false" -}}
+{{- $vertical := false -}}
 {{- $width := 100 -}}
 {{- $ratio := "" -}}
 {{- $wrap := false -}}
@@ -58,11 +58,11 @@
     {{- with index . "layout" }}{{ $layout = . }}{{ end -}}
     {{- with index . "pane" }}{{ $pane = . }}{{ end -}}
     {{- with index . "type" }}{{ $type = . }}{{ end -}}
-    {{- with index . "vertical" }}{{ $vertical = . }}{{ end -}}
+    {{- with index . "vertical" }}{{ $vertical = partial "utilities/CastBool.html" . }}{{ end -}}
     {{- with index . "width" }}{{ $width = . }}{{ end -}}
     {{- with index . "kind" }}{{ $kind = . }}{{ end -}}
     {{- with index . "ratio" }}{{ $ratio = . }}{{ end -}}
-    {{- with index . "wrap" }}{{ $wrap = . }}{{ end -}}
+    {{- with index . "wrap" }}{{ $wrap = partial "utilities/CastBool.html" . }}{{ end -}}
 {{- end -}}
 
 {{ if isset $page.Params "nested" }}
@@ -159,10 +159,7 @@
                 {{- $partial = "assets/card-group.html" -}}
                 {{- $params = merge $params (dict 
                     "title" $title
-                    "icon" $icon
-                    "thumbnail" $thumbnail
                     "ratio" $ratio
-                    "description" $description
                     "color" $color
                     "loading" $loading
                     "max" $max

layouts/partials/assets/toast.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->

layouts/partials/assets/version.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->

layouts/partials/utilities/CastBool.html

@@ -1,14 +0,0 @@
-{{ $input := . }}
-{{ $output := "" }}
-
-{{ if eq (printf "%T" $input) "bool" }}
-    {{ $output = $input }}
-{{ else if eq $input "true" }}
-    {{ $output = true }}
-{{ else if eq $input "false" }}
-    {{ $output = false }}
-{{ else }}
-    {{ errorf "Cannot cast '%s' to bool" $input }}
-{{ end }}
-
-{{ return $output }}

layouts/partials/utilities/GetArgParent.html

@@ -1,23 +0,0 @@
-<!-- 
-    Retrieve the value from a given argument within the shortcode context. If a parent is set and merge is false, the
-    value of the parent's argument is retrieved when the current context is unavailable. If merge is true, the parent's
-    value is merged with the value of the shortcode context, separated by a single space.
--->
-
-{{ $page := .page -}}
-{{ $arg := .arg -}}
-{{ $merge := .merge -}}
-{{ $val := "" }}
-{{ with $page.Get $arg }}{{ $val = . }}{{ end }}
-
-{{- with $page.Parent -}}
-    {{ with .Get $arg }}
-        {{ if $merge }}
-            {{ $val = trim (printf "%s %s" . $val) " " }}
-        {{ else if not $val }}
-            {{ $val = . }}
-        {{ end }}
-    {{ end }}
-{{- end -}}
-
-{{- return $val -}}

layouts/partials/utilities/GetBreakpoint.html

@@ -1,21 +0,0 @@
-{{- /* Define main breakpoint */ -}}
-{{ $prev := 0 }}
-{{ $next := 0 }}
-{{ $result := dict }}
-{{- $breakpoints := slice "xs" "sm" "md" "lg" "xl" "xxl" }}
-{{- $breakpoint := site.Params.main.breakpoint | default "md" -}}
-{{- if not (in $breakpoints $breakpoint) -}}
-    {{- errorf "layout [_default/baseof.html] - Invalid value for param 'breakpoint': %s" $breakpoint -}}
-{{ else }}
-    {{ range $index, $item := $breakpoints }}
-        {{ if eq $item $breakpoint }}
-            {{ $prev = sub $index 1 }}
-            {{ $next = add $index 1 }}
-        {{ end }}
-    {{ end }}
-    {{ if lt $prev 0 }}{{ $prev = 0 }}{{ end }}
-    {{ if ge $next (len $breakpoints) }}{{ $next = sub (len $breakpoints) 1 }}{{ end }}
-    {{ $result = dict "prev" (index $breakpoints $prev) "current" $breakpoint "next" (index $breakpoints $next) }}
-{{- end -}}
-
-{{ return $result }}

layouts/partials/utilities/GetDescription.html

@@ -1,18 +0,0 @@
-{{- $page := . -}}
-{{- if ne (printf "%T" $page) "*hugolib.pageState" -}}
-    {{- errorf "partial [utilities/GetDescription.html] - Expected page context" -}}
-{{- end -}}
-
-{{- $description := "" -}}
-{{- if not $page.RelPermalink -}}
-    {{- $description = $page.Content -}}
-{{ else }}
-    {{- $description = $page.Description -}}
-{{- end -}}
-
-{{- if not $description -}}
-    {{- $description = $page.Summary -}}
-    {{- if $page.Truncated }}{{ $description = print $description "..." }}{{ end -}}}
-{{- end -}}
-
-{{- return $description -}}

layouts/partials/utilities/GetI18nData.html

@@ -1,13 +0,0 @@
-{{ $path := .data }}
-{{ $page := .page }}
-
-{{/* Try language-specific file first */}}
-{{ $i18nPath := path.Join (path.Dir $path) (printf "%s.%s" (path.BaseName $path) $page.Language.Lang) (path.Ext $path) }}
-{{ $data := index site.Data $i18nPath }}
-
-{{/* Use exact provided path as backup */}}
-{{ if not $data -}}
-    {{ $data = index site.Data $path }}
-{{ end }}
-
-{{ return $data }}

layouts/partials/utilities/GetImage.html

@@ -1,68 +0,0 @@
-<!-- 
-    Retrieve a local or remote resource compatible with Hugo's image processing. If the url starts with 'http', the
-    image is retrieved from an external location. Else, the url is matched with a page resource and site asset (in that
-    order). The path of a remote image is rewritten to ensure processed files are stored in the final '/img' folder. The
-    partial returns nil if the resource cannot be found or is incompatibile. The partial supports the following
-    arguments:
-    "url"           Required path or url of the image, e.g. "img/example.jpg" or "https://example.com/img.jpg"
-    "page"          Optional page context, used to retrieve an image from page resources.
--->
-
-{{ $url := .url -}}
-{{ $page := .page -}}
-{{ $mirror := false }}
-
-{{ $supportedMediaTypes := slice "image/png" "image/jpeg" "image/gif" "image/tiff" "image/bmp" "image/webp" -}}
-{{ $remote := hasPrefix (lower $url) "http" }}
-{{- $img := partial "utilities/GetResource.html" (dict "url" $url "page" $page) -}}
-
-{{ with $img -}}
-    {{ if in $supportedMediaTypes (string $img.MediaType) -}}
-        <!-- Rewrite the path of remote images to avoid storing processed files in the site's root -->
-        <!-- Add a file extension based on the media type if needed to avoid Hugo processing errors -->
-        {{ if $remote -}}
-            {{ $path := (urls.Parse $url).Path }}
-            {{ $filename := index (last 1 (split (delimit (split $path "/") "," "") ",")) 0 -}}
-            {{ if not (path.Ext $filename) -}}
-                {{ $extension := string $img.MediaType.SubType -}}
-                {{ $filename = printf "%s.%s" $filename $extension -}}
-            {{ end -}}
-            {{ $img = $img.Content | resources.FromString (printf "/img/%s" $filename) -}}
-        {{ end -}}
-
-        <!-- 
-            Rotate the image if needed based on EXIF orientation. EXIF defines the following values:
-            (source: https://sirv.com/help/articles/rotate-photos-to-be-upright/#EXIF_orientation_values)
-            1 = 0 degrees: the correct orientation, no adjustment is required.
-            2 = 0 degrees, mirrored: image has been flipped back-to-front.
-            3 = 180 degrees: image is upside down.
-            4 = 180 degrees, mirrored: image has been flipped back-to-front and is upside down.
-            5 = 90 degrees: image has been flipped back-to-front and is on its side.
-            6 = 90 degrees, mirrored: image is on its side.
-            7 = 270 degrees: image has been flipped back-to-front and is on its far side.
-            8 = 270 degrees, mirrored: image is on its far side.
-        -->
-        {{ with $img.Exif }}
-            {{ $filter := "" }}
-            {{ $orientation := .Tags.Orientation }}
-            {{ if or (eq $orientation 3) (eq $orientation 4) }}
-                {{ $filter = images.Process "r180" }}
-            {{ else if or (eq $orientation 5) (eq $orientation 6) }}
-                {{ $filter = images.Process "r270" }}
-            {{ else if or (eq $orientation 7) (eq $orientation 8) }}
-                {{ $filter = images.Process "r90" }}
-            {{ end }}
-            {{ with $filter }}{{ $img = $img.Filter . }}{{ end }}
-
-            {{- $isMirrored := slice 2 4 5 7 -}}
-            {{- if (in $isMirrored $orientation) }}{{ $mirror = true }}{{ end -}}
-        {{ end }}
-    {{ else -}}
-        {{ warnf "Image type '%s' is not supported: %s" $img.MediaType $url -}}
-        {{ $img = "" -}}
-    {{ end -}}
-{{ else -}}    
-    {{ warnf "Cannot find image resource: %q" $url -}}
-{{ end -}}
-
-{{ return (dict "resource" $img "mirror" $mirror) -}}

layouts/partials/utilities/GetMenu.html

@@ -1,17 +0,0 @@
-{{- $page := .page -}}
-{{- $version := .version -}}
-{{- $sidebarFilename := "" -}}
-
-{{- $menu := "" -}}
-{{- if $page.IsPage -}}
-    {{- $sidebarFilename = printf "%s-%s" $page.Section $version -}}
-    {{- $menu = index site.Data $sidebarFilename -}}
-    {{ if not $menu }}
-        {{- $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/GetPage.html

@@ -1,33 +0,0 @@
-{{- $ref := "" -}}
-{{- $anchor := "" -}}
-
-{{ $url := .url }}
-{{ if not $url }}
-    {{- errorf "partial [utilities/GetPage.html] - Expected param 'url'" -}}
-{{ end }}
-
-{{ $page := .page }}
-{{ if not $page }}
-    {{- errorf "partial [utilities/GetPage.html] - Expected param 'page'" -}}
-{{ end }}
-
-{{- $isExternal := ne (urls.Parse (absURL $url)).Host (urls.Parse site.BaseURL).Host -}}
-{{- if not $isExternal -}}
-    {{- $ref = $page.GetPage $url -}}
-    {{ if not $ref }}
-        {{ $ref = (index (where $page.Site.AllPages "RelPermalink" (printf "%s/" (strings.TrimSuffix "/" $url))) 0)}} 
-    {{ end }}
-
-    {{- if not $ref }}
-        {{- $segments := split $url "/" -}}
-        {{- if and (hasPrefix $url "/")  (gt (len $segments) 1) -}}
-            {{- $prefix := index $segments 1 -}}
-            {{ with index (where site.Sites "Language.Lang" $prefix) 0 }}
-                {{- $path := printf "/%s" (strings.TrimPrefix (printf "/%s/" $prefix) $url) }}
-                {{- $ref = .GetPage $path -}}
-            {{ end }}
-        {{- end -}}
-    {{- end -}}
-{{- end -}}
-
-{{ return $ref }}

layouts/partials/utilities/GetResource.html

@@ -1,40 +0,0 @@
-<!-- 
-    Retrieve a local or remote resource. If the url starts with 'http', the resource is retrieved from an external
-    location. Else, the url is matched with a page resource and site asset (in that order). 
-    
-    This partial supports both relative and absolute paths. Hugo has different methods to retrieve page bundle assets
-    and site assets. Absolute paths are converted to a relative path to make them compatible with Hugo's methods. The
-    prefix of an absolute path is truncated if it matches either with the page bundle folder (starting with "/content/")
-    or the assets folder ("/assets/"). 
-    
-    The partial returns nil if the resource cannot be found. The partial supports the following arguments:
-    "url"           Required path or url of the resource, e.g. "img/example.jpg" or "https://example.com/img.jpg"
-    "page"          Optional page context, used to retrieve a resource from page resources.
--->
-
-{{ $url := .url -}}
-{{ $page := .page -}}
-{{ if hasPrefix $url "/" }}
-    {{ $pageContext := (path.Join "/content" $page.File.Dir) -}}
-    {{ if hasPrefix $url $pageContext }}
-        {{ $url = strings.TrimPrefix $pageContext $url -}}
-    {{ else if hasPrefix $url "/assets/" }}
-        {{ $url = strings.TrimPrefix "/assets/" $url -}}
-    {{ end }}
-    {{ $url = strings.TrimPrefix "/" $url -}}
-{{ end }}
-
-{{ $res := "" }}
-{{ $remote := hasPrefix (lower $url) "http" }}
-{{ if $remote }}
-    {{ $res = resources.GetRemote $url -}}
-{{ else }}
-    {{ if $page }}
-        {{ $res = $page.Resources.Get $url -}}
-    {{ end }}
-    {{ if not $res }}
-        {{ $res = resources.GetMatch $url }}
-    {{ end }}
-{{ end }}
-
-{{ return $res -}}

layouts/partials/utilities/GetVal.html

@@ -1,12 +0,0 @@
-<!-- 
-    Retrieve the value from a key-value pair. The expected format is 'key="value"', including double quotes for the
-    value. Returns -1 when no valid value is found.
--->
-
-{{- $input := (split . "=") -}}
-{{- $val := -1 -}}
-{{- if gt (len $input) 1 -}}
-    {{- $val = trim (index $input 1) "\"" -}}
-{{- end -}}
-
-{{- return $val -}}

layouts/partials/utilities/GetVersion.html

@@ -1,38 +0,0 @@
-<!-- 
-    Retrieve the docs version label of the current page. The path of the page's file is matched with the url of the
-    defined docs releases in the site's parameters. When no match is found it returns the latest label instead.
--->
-
-{{- $page := .page -}}
-{{- $base := .base -}}
-{{- $version := "" -}}
-
-{{- if and site.Params.docs.releases site.Params.docs.contentPath -}}
-    {{- $docsPath := strings.TrimPrefix "/" site.Params.docs.contentPath -}}
-    {{- if and $page.File (strings.HasPrefix $page.File.Dir $docsPath) -}}
-        {{- $currentPath := strings.TrimPrefix $docsPath $page.File.Dir -}}
-        {{- $currentVersion := index (split $currentPath "/") 0 -}}
-        {{- $versionPath := path.Join site.Params.docs.contentPath $currentVersion -}}
-
-        {{- $list := site.Params.docs.releases -}}
-        {{- range $index, $item := $list -}}
-            {{- $url := strings.TrimSuffix "/" $item.url -}}
-            {{- if eq $url $versionPath -}}
-                {{- if $base }}{{ $version = path.Base $item.url }}{{ else }}{{ $version = $item.label }}{{ end -}}
-            {{- end -}}
-        {{- end -}}
-    {{- end -}}
-
-    {{- if not $version -}}
-        {{- $list := site.Params.docs.releases -}}
-        {{- range $item := $list -}}
-            {{- if $item.latest -}}
-                {{- if $base }}{{ $version = path.Base $item.url }}{{ else }}{{ $version = $item.label }}{{ end -}}
-            {{- end -}}
-        {{- end -}}
-    {{- end -}}
-{{- else -}}
-    {{- $version = site.Params.docs.version -}}
-{{- end -}}
-
-{{- return $version -}}

layouts/partials/utilities/GetWidth.html

@@ -1,17 +0,0 @@
-{{ $path := .path }}
-{{ $height := .height }}
-{{ $width := "" }}
-
-{{ if eq (path.Ext $path) ".svg" }}
-    {{ $path := path.Join "static" .path }}
-    {{ if fileExists $path }}
-        {{ with findRE `viewBox="\d*\.?\d+[\s,]\d*\.?\d+[\s,]\d*\.?\d+[\s,]\d*\.?\d+"` (readFile $path) 1 }}
-            {{ $content := split (index (split (index . 0) `"`) 1) " " }}
-            {{ $viewbox_width := float (index $content 2) }}
-            {{ $viewbox_height := float (index $content 3) }}
-            {{ $width = int (math.Round (mul (div $height $viewbox_height) $viewbox_width)) }}
-        {{ end }}
-    {{ end }}
-{{ end }}
-
-{{ return $width }}

layouts/partials/utilities/IsInvalidArgs.html

@@ -1,147 +0,0 @@
-<!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
-    Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
-    Visit gethinode.com/license for more details.
--->
-
-{{ $error := false }}
-
-{{ $aliases := dict "path" "string" "select" "string" "url" "string" }}
-
-{{ $structure := .structure }}
-{{ if not $structure }}
-    {{- errorf "partial [utilities/ValidateArgs.html] - Missing value for param 'structure'" -}}
-    {{ $error =  true }}
-{{ end }}
-
-{{ $args := .args | default dict }}
-
-{{ $definitions := (index site.Data.structures $structure).arguments }}
-{{ if not $definitions }}
-    {{- errorf "partial [utilities/ValidateArgs.html] - Missing definitions: %s" $structure -}}
-    {{ $error =  true }}
-{{ end }}
-
-{{ $child := .child }}
-{{ if $child }}
-    {{ $extra_def := (index site.Data.structures $child).arguments }}
-    {{ if not $extra_def }}
-        {{- errorf "partial [utilities/ValidateArgs.html] - Missing definitions: %s" $child -}}
-        {{ $error =  true }}
-    {{ else }}
-        {{ range $key, $val := $extra_def }}
-            {{ if $val.parent }}{{ $definitions = merge $definitions (dict $key $val) }}{{ end }}
-        {{ end }}
-    {{ end }}
-{{ end }}
-
-{{ $group := .group }}
-{{ $namedArgs := true }}
-
-{{ if not $error }}
-    {{ range $key, $val := $args }}
-        {{ $def := "" }}
-        {{ if eq (printf "%T" $key) "string" }}
-            {{ $def = index $definitions $key }}
-        {{ else }}
-            {{ $namedArgs = false }}
-            {{ range $d := $definitions }}
-                {{ if eq $d.position $key }}{{ $def = $d }}{{ end }}
-            {{ end }}
-        {{ end }}
-
-        {{ if $def }}
-            {{ $groups := slice | append $def.group }}
-            {{ if and $group $def.group }}
-                {{ if not (in $groups $group )}}{{ $def = "" }}{{ end }}
-            {{ end }}
-        {{ end }}
-
-        {{ if not $def }}
-            {{ if eq (printf "%T" $key) "string" }}
-                {{ warnf "[%s] unsupported argument '%s'" $structure $key }}
-            {{ else if eq (printf "%T" $key) "int" }}
-                {{ warnf "[%s] unsupported argument at index %d (value: '%s')" $structure $key $val }}
-            {{ else }}
-                {{ warnf "[%s] unsupported argument value '%s'" $structure $val }}
-            {{ end }}
-            {{ $error = true }}
-        {{ else }}
-            {{ if and (not $val) $def.default }}{{ $val = $def.default }}{{ end }}
-
-            {{/* validate type */}}
-            {{ $expected := slice | append $def.type }}
-            {{ $extra := slice }}
-            {{ range $expected }}
-                {{ $alias := index $aliases . }}
-                {{ if $alias }}{{ $extra = $extra | append $alias }}{{ end }}
-            {{ end }}
-            {{ if $extra }}{{ $expected = $expected | append $extra }}{{ end }}
-            {{ $actual := printf "%T" $val }}
-
-            {{/* cast supported types from/to string */}}
-            {{ if and (in $expected "bool") (in (slice "true" "false") $val) }}
-                {{ $actual = "bool" }}
-            {{ else if and (in $expected "int") (findRE `^-?\d+$` $val) }}
-                {{ $actual = "int" }}
-            {{ else if and (in $expected "float") (findRE `^(?:[1-9]\d*|0)?(?:\.\d+)?$` $val) }}
-                {{ $actual = "float" }}
-            {{ else if and (in $expected "string") (in (slice "bool" "int" "int64" "float" "float64") $actual) }}
-                {{ $actual = "string" }}
-                {{ $val = string $val }}
-            {{ end }}
-
-            {{ if and $val (not (in $expected $actual)) }}
-                {{ warnf "[%s] argument '%s': expected type '%s', got '%s'" $structure (string $key) (delimit $expected ", ") $actual }}
-                {{ $error = true }}
-            {{ end }}
-
-            {{/* validate permitted values */}}
-            {{ if and $def.options.values (eq $actual "string") }}
-                {{ if and $val (not (in $def.options.values $val)) }}
-                    {{ warnf "[%s] argument '%s': unexpected value '%s'" $structure (string $key) $val }}
-                    {{ $error = true }}
-                {{ end }}
-            {{ else if and $def.options.min (in (slice "int" "float" "float64") $actual) }}
-                {{ if lt $val $def.options.min }}
-                    {{ warnf "[%s] argument '%s': value '%s' out of range [$d, $d]" $structure (string $key) $val $def.options.min $def.options.max}}
-                    {{ $error = true }}
-                {{ end }}
-            {{ else if and $def.options.max (in (slice "int" "float" "float64") $actual) }}
-                {{ if (gt $val $def.options.max) }}
-                    {{ warnf "[%s] argument '%s': value '%s' out of range [$d, $d]" $structure (string $key) $val $def.options.min $def.options.max}}
-                    {{ $error = true }}
-                {{ end }}
-            {{ end }}
-        {{ end }}
-    {{ end }}
-    
-    {{/* validate required arguments */}}
-    {{ $max := len $args }}
-    {{ $expected := 0 }}
-    {{ range $key, $val := $definitions }}
-        {{ $skip := false }}
-        {{ $groups := slice | append $val.group }}
-        {{ if and $group $val.group }}
-            {{ $skip = not (in $groups $group )}}
-        {{ end }}
-
-        {{ if and (not $skip) (not $val.optional) }}
-            {{ if $namedArgs }}
-                {{ if not (isset $args $key) }}
-                    {{ warnf "[%s] argument '%s': expected value" $structure $key }}
-                    {{ $error = true }}
-                {{ end }}
-            {{ else }}
-                {{ $expected = add $expected 1 }}
-            {{ end }}
-        {{ end }}
-    {{ end }}
-
-    {{ if lt $max $expected }}
-        {{ warnf "[%s] expected '%d' args, got '%d'" $structure $expected $max }}
-        {{ $error = true }}
-    {{ end }}
-{{ end }}
-
-{{ return $error }}

layouts/partials/utilities/IsOlder.html

@@ -1,32 +0,0 @@
-<!-- 
-    Returns true if the current version is older than the latest version defined in the docs section of the site
-    parameters. The verification supports semver patterns MAJOR.MINOR.PATCH with an optional suffix.
-    
-    Original code by solus on https://discourse.gohugo.io/t/sorting-semantic-version-numbers/40838/6.
- -->
-
-{{ $current := .current }}
-{{ $latest := site.Params.docs.latest }}
-
-{{- define "partials/padZeroPrefix.html" -}}
-    {{- $padSize := 6 }}
-    {{- $paddedString := replaceRE "(\\d+)" (print (strings.Repeat (sub $padSize 1) "0") "$1") . }}
-    {{- $trimmedString := replaceRE (print "0+(\\d{" $padSize "})") "$1" $paddedString }}
-    {{- return $trimmedString }}
-{{- end -}}
-
-{{- define "partials/trimZeroPrefix.html" -}}
-    {{- return replaceRE "0+(\\d+)" "$1" . }}
-{{- end -}}
-
-{{- $isOlder := false -}}
-
-{{- if and $current $latest }}
-    {{- $versions := slice $current $latest }}
-    {{- $paddedVersions := apply $versions "partial" "padZeroPrefix" "." }}
-    {{- $sortedVersions := (sort $paddedVersions "value" "desc") }}
-    {{- $sortedVersions = apply $sortedVersions "partial" "trimZeroPrefix" "." }}
-    {{ $isOlder = ne (index $sortedVersions 0) $current }}
-{{- end -}}
-
-{{- return $isOlder -}}

layouts/partials/utilities/ProcessContent.html

@@ -1,13 +0,0 @@
-<!-- 
-    Purges any HTML comments from raw content, if applicable. The partial supports the following arguments:
-    "page"          Required page context, used to render shortcodes properly.
-    "raw"           Raw page content, e.g. .Page.RawContent.
--->
-
-{{ $page := .page -}}
-{{ $raw := .raw -}}
-{{- if site.Params.debugging.purgeHTMLComments -}}
-    {{- $raw = replaceRE "<!--(.|\n)*?-->" "" $raw -}}
-{{- end -}}
-{{ $content := emojify $raw | $page.RenderString }}
-{{ return $content }}

layouts/partials/utilities/URLJoin.html

@@ -1,16 +0,0 @@
-{{- $base := .base -}}
-{{- if not $base }}
-    {{- errorf "partial [assets/utilities/URLJoin.html] - Expected param 'base'" -}}
-{{- end -}}
-
-{{- $path := .path -}}
-{{- if not $path }}
-    {{- errorf "partial [assets/utilities/URLJoin.html] - Expected param 'path'" -}}
-{{- end -}}
-
-{{- $url := $path -}}
-{{- if not (hasPrefix $path "http") -}}
-    {{- $url = printf "%s/%s" (strings.TrimSuffix "/" $base) $path -}}
-{{- end }}
-
-{{- return $url -}}

layouts/partials/utilities/bundle.html

@@ -1,65 +0,0 @@
-{{- $match := .match -}}
-{{- $filename := .filename -}}
-{{- if not (or $match $filename) -}}
-    {{- errorf "partial [assets/bundle.html] - Expected match and filename" -}}
-{{- end -}}
-
-{{- $order := .order | default "asc"}}
-{{- $supportedOrder := slice "asc" "desc" -}}
-{{- if not (in $supportedOrder $order) -}}
-    {{- errorf "partial [assets/bundle.html] - Invalid value for param 'order': %s" $order -}}
-{{- end -}}
-
-{{- $modules := .modules -}}
-{{- $all := .all }}
-{{- $basepath := strings.TrimSuffix "/" .basepath -}}
-{{- $ext := trim (path.Ext (trim $match "{}")) "." -}}
-{{- if not $ext -}}
-    {{- errorf "partial [assets/bundle.html] - Cannot derive file extension of match pattern: %s" $match -}}
-{{- end -}}
-
-{{- $debugging := .debugging | default false -}}
-
-{{- if $modules -}}
-    {{- $match = trim $match "{}" -}}
-    {{- $matches := slice $match -}}
-    {{- range $index, $mod := $modules -}}
-        {{- if $all }}
-            {{- $matches = $matches | append (printf "%s/%s/**.%s" $basepath $mod $ext) -}}
-        {{- else -}}
-            {{- $matches = $matches | append (printf "%s/%s.%s" $basepath $mod $ext) -}}
-        {{- end -}}
-    {{- end -}}
-    {{- $match = printf "{%s}" (delimit $matches ",") }}
-{{- end -}}
-
-<!-- TODO: concat by module, then sorted by filename -->
-
-{{ $matches := resources.Match $match }}
-{{ $files := slice }}
-{{ range $index, $file := $matches }}
-    {{ $add := (dict "name" (strings.TrimSuffix (printf ".%s" $ext) $file.Name) "resource" $file ) }}
-    {{ $files = $files | append $add }}
-{{ end }}
-
-{{ $sorted := slice }}
-{{ $files = sort $files "name" }}
-{{- range $index, $file := $files -}}
-    {{ $sorted = $sorted | append $file.resource }}
-{{- end -}}
-
-{{- if $debugging -}}
-    {{ warnf "Processing pattern: %s" $match}}
-    {{- range $index, $file := $sorted -}}
-        {{- warnf " - Processing file: %s" $file }}
-    {{- end -}}
-{{- end -}}
-
-{{ $bundle := "" }}
-{{ if gt (len $sorted) 0 }}
-    {{ $bundle = $sorted | resources.Concat $filename -}}
-{{ else }}
-    {{ $bundle = resources.FromString $filename "" }}
-{{ end -}}
-
-{{- return $bundle -}}

layouts/partials/utilities/date.html

@@ -1 +0,0 @@
-{{ if eq .format "long" }}{{ .date | time.Format ":date_long" }}{{ else }}{{ .date | time.Format ":date_medium" }}{{ end }}

layouts/partials/utilities/git.html

@@ -1,5 +0,0 @@
-{{ $lastmodstr := (partial "utilities/date.html" (dict "date" .Lastmod "format" "long")) -}}
-Last updated: {{ $lastmodstr }}
-{{ with .GitInfo }}
-&bull;&nbsp;<a href="{{ site.Params.docs.github | default site.Params.schema.github }}/commit/{{ .Hash }}">{{ .Subject }} ({{ .AbbreviatedHash }})</a>
-{{ end -}}

layouts/shortcodes/abbr.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->

layouts/shortcodes/accordion-item.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->

layouts/shortcodes/accordion.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->

layouts/shortcodes/alert.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->
@@ -16,7 +16,13 @@
 {{ $color := .Get "color" | default "danger" -}}
 {{ $icon := .Get "icon" | default "" }}
 {{ $type := .Get "type" | default "" -}}
-{{ if eq $type "danger" }}{{ $icon = "fas triangle-exclamation" }}{{ else if eq $type "info" }}{{ $icon = "fa lightbulb" }}{{ end }}
+{{ if eq $type "danger" }}
+    {{ $icon = "fas triangle-exclamation" }}
+    {{ $color = "danger" }}
+{{ else if eq $type "info" }}
+    {{ $icon = "fa lightbulb" }}
+    {{ $color = "info" }}
+{{ end }}
 {{ with $icon }}
     {{ $icon = partial "assets/icon.html" (dict "icon" (printf "%s fa-2x fa-fw" .)) }}
 {{ end }}

layouts/shortcodes/args.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->
@@ -63,16 +63,15 @@
             {{ $max := "" }}
             {{ if and $val.options.values (eq $type "select") }}
                 {{ $comment = printf "%s %s: [%s]." $comment (T "supportedValues") (delimit $val.options.values ", ") }}
-            {{ else if and $val.options.min (in (slice "int" "float" "float64") $type) }}
-                {{ $min = $val.options.min }}
-            {{ else if and $val.options.max (in (slice "int" "float" "float64") $type) }}
-                {{ $max = $val.options.max }}
+            {{ else if in (slice "int" "float" "float64") $type }}
+                {{ if eq (printf "%T" $val.options.min) "int" }}{{ $min = int $val.options.min }}{{ end }}
+                {{ if eq (printf "%T" $val.options.max) "int" }}{{ $max = int $val.options.max }}{{ end }}
             {{ end }}
-            {{ if and $min $max }}
-                {{ $comment = printf "%s %s: [%d, %d]." $comment (T "supportedValues") $min $max }}
-            {{ else if $min }}
+            {{ if and (eq (printf "%T" $min) "int") (eq (printf "%T" $max) "int") }}
+                {{ $comment = printf "%s %s: [%d - %d]." $comment (T "supportedValues") $min $max }}
+            {{ else if (eq (printf "%T" $min) "int") }}
                 {{ $comment = printf "%s %s: >=%d." $comment (T "supportedValues") $min }}
-            {{ else if $max }}
+            {{ else if (eq (printf "%T" $max) "int") }}
                 {{ $comment = printf "%s %s: <=%d." $comment (T "supportedValues") $max }}
             {{ end }}
 

layouts/shortcodes/badge.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->

layouts/shortcodes/breadcrumb.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->

layouts/shortcodes/button-group.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->

layouts/shortcodes/button.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->
@@ -28,7 +28,7 @@
 {{ $outline := false -}}
 {{ with .Get "outline" }}{{ $outline = partial "utilities/CastBool.html" . }}{{ end -}}
 {{ $badge := .Get "badge" | default "" -}}
-{{ $label := .Get "label" | default "" -}}
+{{ $label := or (.Get "label") (.Get "aria-label") | default "" -}}
 {{ $tooltip := .Get "tooltip" | default "" -}}
 {{ $collapse := .Get "collapse" | default "" -}}
 {{ $href := .Get "href" | default "" -}}

layouts/shortcodes/card-group.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->
@@ -14,9 +14,11 @@
 {{- $gutter := .Get "gutter" | default "4" -}}
 {{- $title := .Get "title" | default "" -}}
 {{- $separator := .Get "separator" | default "" -}}
-{{- $class := .Get "class" | default "" -}}
 {{- $wrapper := .Get "wrapper" | default "" -}}
 {{- $responsive := .Get "responsive" | default true -}}
+
+<!-- Initialize arguments passed to individual cards -->
+{{- $class := .Get "class" | default "" -}}
 {{- $color := .Get "color" | default "" -}}
 {{- $padding := .Get "padding" | default "auto" -}}
 {{- $header := .Get "header" | default "" -}}

layouts/shortcodes/card.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->
@@ -21,8 +21,10 @@
 {{- $gutter := partial "utilities/GetArgParent" (dict "page" . "arg" "gutter") | default "0" -}}
 {{- $header := partial "utilities/GetArgParent" (dict "page" . "arg" "header") | default "full" -}}
 {{- $icon := .Get "icon" -}}
+{{- $loading := .Get "loading" -}}
 {{- $orientation := partial "utilities/GetArgParent" (dict "page" . "arg" "orientation") | default "stacked" -}}
 {{- $padding := partial "utilities/GetArgParent" (dict "page" . "arg" "padding") | default "auto" -}}
+{{- $ratio := partial "utilities/GetArgParent" (dict "page" . "arg" "ratio") | default "" -}}
 {{- $page := .Page -}}
 {{- $path := .Get "path" -}}
 {{- $thumbnail := .Get "thumbnail" -}}
@@ -55,8 +57,10 @@
         "footer" $footer
         "orientation" $orientation
         "description" $description
+        "ratio" $ratio
         "icon" $icon
         "thumbnail" $thumbnail
+        "loading" $loading
         "alt" $alt
     ) -}}
 

layouts/shortcodes/carousel.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->

layouts/shortcodes/collapse.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->

layouts/shortcodes/command.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->

layouts/shortcodes/docs.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 

layouts/shortcodes/example.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 

layouts/shortcodes/file.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 

layouts/shortcodes/image.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->

layouts/shortcodes/img.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->

layouts/shortcodes/kbd.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->

layouts/shortcodes/link.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->

layouts/shortcodes/mark.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->

layouts/shortcodes/nav-item.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->
@@ -24,9 +24,10 @@
     {{- end -}}
 
     {{- $fade := false -}}
-    {{- if eq (.Parent.Get "fade") "true" -}}
-        {{- $fade = true -}}
-    {{- end -}}
+    {{ with .Get "fade" }}{{ $fade = partial "utilities/CastBool.html" . }}{{ end -}}
+    {{- $parentFade := false }}
+    {{ with .Parent.Get "fade" }}{{ $parentFade = partial "utilities/CastBool.html" . }}{{ end -}}
+    {{ $fade = or $fade $parentFade }}
     {{- $header := .Get "header" | default "" -}}
     {{- $class := .Get "class" | default "" -}}
     {{- $body := trim .Inner " \r\n" | .Page.RenderString -}}

layouts/shortcodes/nav.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->

layouts/shortcodes/navbar.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->

layouts/shortcodes/persona.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->

layouts/shortcodes/release.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->
@@ -18,7 +18,7 @@
 {{- $short := false -}}
 {{ with .Get "short" }}{{ $short = partial "utilities/CastBool.html" . }}{{ end -}}
 {{- $inline := false -}}
-{{ with .Get "inline" }}{{ $short = partial "utilities/CastBool.html" . }}{{ end -}}
+{{ with .Get "inline" }}{{ $inline = partial "utilities/CastBool.html" . }}{{ end -}}
 {{- $title := $version -}}
 {{- $color := "primary" -}}
 {{- if eq $state "deprecated" -}}

layouts/shortcodes/spinner.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->

layouts/shortcodes/sub.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->

layouts/shortcodes/sup.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->

layouts/shortcodes/table.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->

layouts/shortcodes/timeline.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 

layouts/shortcodes/toast.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->

layouts/shortcodes/tooltip.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.
 -->

layouts/shortcodes/youtube.html

@@ -1,5 +1,5 @@
 <!-- 
-    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
+    Copyright © 2024 The Hinode Team / Mark Dumay. All rights reserved.
     Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
     Visit gethinode.com/license for more details.