Merge pull request #671 from gethinode/validation

Improve argument validation and documentation

README.md

@@ -9,32 +9,32 @@
 
 <!-- Badges -->
 <p align="center">
-    <a href="https://gohugo.io" alt="Hugo website">
+    <a href="https://gohugo.io">
-        <img src="https://img.shields.io/badge/generator-hugo-brightgreen">
+        <img src="https://img.shields.io/badge/generator-hugo-brightgreen" alt="Hugo website">
     </a>
-    <a href="https://gethinode.com" alt="Hinode theme">
+    <a href="https://gethinode.com">
-        <img src="https://img.shields.io/badge/theme-hinode-blue">
+        <img src="https://img.shields.io/badge/theme-hinode-blue" alt="Hinode theme">
     </a>
-    <a href="https://www.npmjs.com/package/%40gethinode/hinode" alt="npm package">
+    <a href="https://www.npmjs.com/package/%40gethinode/hinode">
-        <img src="https://img.shields.io/npm/v/%40gethinode/hinode">
+        <img src="https://img.shields.io/npm/v/%40gethinode/hinode" alt="npm package">
     </a>
-    <a href="https://app.netlify.com/sites/gethinode-demo/deploys" alt="Netlify Status">
+    <a href="https://app.netlify.com/sites/gethinode-demo/deploys">
-        <img src="https://img.shields.io/netlify/0ad42e3e-fdfa-4d37-8e26-58badd429a67">
+        <img src="https://img.shields.io/netlify/0ad42e3e-fdfa-4d37-8e26-58badd429a67"  alt="Netlify Status">
     </a>
-    <a href="https://stats.uptimerobot.com/xyGVYhLJmV" alt="UptimeRobot Status">
+    <a href="https://stats.uptimerobot.com/xyGVYhLJmV">
-        <img src="https://img.shields.io/uptimerobot/status/m791334689-73d9dfc82030f4f955b2d6bb">
+        <img src="https://img.shields.io/uptimerobot/status/m791334689-73d9dfc82030f4f955b2d6bb" alt="UptimeRobot Status">
     </a>
-    <a href="https://github.com/gethinode/hinode/commits/main" alt="Last commit">
+    <a href="https://github.com/gethinode/hinode/commits/main">
-        <img src="https://img.shields.io/github/last-commit/gethinode/hinode.svg">
+        <img src="https://img.shields.io/github/last-commit/gethinode/hinode.svg" alt="Last commit">
     </a>
-    <a href="https://github.com/gethinode/hinode/issues" alt="Issues">
+    <a href="https://github.com/gethinode/hinode/issues">
-        <img src="https://img.shields.io/github/issues/gethinode/hinode.svg">
+        <img src="https://img.shields.io/github/issues/gethinode/hinode.svg" alt="Issues">
     </a>
-    <a href="https://github.com/gethinode/hinode/pulls" alt="Pulls">
+    <a href="https://github.com/gethinode/hinode/pulls">
-        <img src="https://img.shields.io/github/issues-pr-raw/gethinode/hinode.svg">
+        <img src="https://img.shields.io/github/issues-pr-raw/gethinode/hinode.svg" alt="Pulls">
     </a>
-    <a href="https://github.com/gethinode/hinode/blob/main/LICENSE" alt="License">
+    <a href="https://github.com/gethinode/hinode/blob/main/LICENSE">
-        <img src="https://img.shields.io/github/license/gethinode/hinode">
+        <img src="https://img.shields.io/github/license/gethinode/hinode" alt="License">
     </a>
 </p>
 

assets/scss/app-dart.scss

@@ -38,7 +38,7 @@
 @import "components/table.scss";
 @import "components/timeline.scss";
 @import "components/toc.scss";
-@import "components/vimeo.scss";
+@import "components/video.scss";
 @import "common/animation.scss";
 @import "common/styles.scss";
 @import "layouts/reboot.scss";

assets/scss/app.scss

@@ -36,7 +36,7 @@
 @import "components/table.scss";
 @import "components/timeline.scss";
 @import "components/toc.scss";
-@import "components/vimeo.scss";
+@import "components/video.scss";
 @import "common/animation.scss";
 @import "common/styles.scss";
 @import "layouts/reboot.scss";

assets/scss/components/_img.scss

@@ -14,3 +14,8 @@
     height: 100%;
     object-fit: cover;
 }
+
+.mirrorred {
+    -webkit-transform: scaleX(-1);
+    transform: scaleX(-1);
+}

assets/scss/components/_video.scss

@@ -1,3 +1,19 @@
+.youtube-embedded {
+    position: relative;
+    padding-bottom: 56.25%;
+    height: 0;
+    overflow: hidden;
+}
+
+.youtube-embedded > iframe {
+    position: absolute;
+    top: 0;
+    left: 0;
+    width: 100%;
+    height: 100%;
+    border:0;
+}
+
 // Adapted from https://github.com/gohugoio/hugo/tpl/tplimpl/embedded/templates/shortcodes/vimeo_simple.html
 .__h_video {
     position: relative;

config/_default/hugo.toml

@@ -104,6 +104,9 @@ home = ["HTML", "RSS", "REDIR"]
   [[module.mounts]]
     source = "content"
     target = "content"
+  [[module.mounts]]
+    source = "data"
+    target = "data"
   [[module.mounts]]
     source = "i18n"
     target = "i18n"

config/_default/params.toml

@@ -8,6 +8,7 @@
     endorse = true
     footerBelowFold = false
     loading = "lazy"
+    breakpoint = "md"
     [main.externalLinks]
         cue = false
         tab = false

data/structures/card.yml

@@ -0,0 +1,174 @@
+comment: >-
+  Displays a Bootstrap card. Either specify a valid path, or set the arguments
+  title, href, header, description, and thumbnail individually. The latter
+  arguments override any page attributes.
+arguments:
+    title:
+      type: string
+      optional: true
+      comment: >-
+        Title of the card.
+    path:
+      type: path
+      optional: true
+      comment: >-
+        Path of the page, override with other parameters.
+    href:
+      type: url
+      optional: true
+      comment: >-
+        Address for the button or hyperlink.
+      group: partial
+    class:
+      type: string
+      optional: true
+      parent: merge
+      comment: >-
+        Class attribute of the card element, e.g. “w-50”.
+    color:
+      type: select
+      optional: true
+      parent: cascade
+      comment: >-
+        Theme color of the card. By default, no color is specified.
+      options:
+        values:
+          - primary
+          - secondary
+          - success
+          - danger
+          - warning
+          - info
+          - light
+          - dark
+          - white
+          - black
+          - body
+          - body-tertiary
+    padding:
+      type: select
+      optional: true
+      default: auto
+      parent: cascade
+      comment: >-
+        Padding of the content.
+      options:
+        values:
+          - "0"
+          - "1"
+          - "2"
+          - "3"
+          - "4"
+          - "5"
+          - "auto"
+    gutter:
+      type: select
+      optional: true
+      default: "0"
+      parent: cascade
+      comment: >-
+        Gutter between columns in a group.
+      options:
+        values:
+          - "0"
+          - "1"
+          - "2"
+          - "3"
+          - "4"
+          - "5"
+    header:
+      type: select
+      optional: true
+      default: full
+      parent: cascade
+      comment: >-
+        Header components of the card, displayed in small caps. 
+      options:
+        values:
+          - full
+          - publication
+          - tags
+          - none
+    footer:
+      type: select
+      optional: true
+      default: none
+      parent: cascade
+      comment: >-
+        Footer components of the card, displayed in small caps.
+      options:
+        values:
+          - full
+          - publication
+          - tags
+          - none
+    description:
+      type:
+        - string
+        - template.HTML
+      optional: true
+      comment: >-
+        Description of the card.
+      group: partial
+    loading:
+      type: select
+      optional: true
+      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
+        should reduce the initial loading time of the website. It is recommended
+        to lazily load only those images that are below the page fold.
+      options:
+        values:
+          - lazy
+          - eager
+      group: partial
+    thumbnail:
+      type: path
+      optional: true
+      comment: >-
+        Thumbnail image url, displayed on top or the left of the card.
+    ratio:
+      type: select
+      optional: true
+      comment: >-
+        Ratio of the thumbnail image, defaults to "16x9" (stacked orientation)
+        or "1x1" (horizontal orientation).
+      options:
+        values:
+          - 1x1
+          - 3x2
+          - 4x3
+          - 16x9
+          - 21x9
+      group: partial
+    alt:
+      type: string
+      optional: true
+      release: v0.19.0
+      comment: >-
+        Alternate text for the thumbnail, uses "title" by default.
+    icon:
+      type: string
+      optional: true
+      comment: >-
+        Font Awesome icon, displayed on top or the left of the card.
+    orientation:
+      type: select
+      optional: true
+      default: stacked
+      parent: cascade
+      comment: >-
+        Placement of the thumbnail or icon.
+      options:
+        values:
+          - stacked
+          - horizontal
+          - horizontal-sm
+          - none
+body:
+  optional: true
+  comment: >-
+    Description of the card.
+  group: shortcode

exampleSite/config/_default/params.toml

@@ -6,6 +6,7 @@
     canonifyAssetsURLs = false
     footerBelowFold = false
     loading = "lazy"
+    breakpoint = "md"
     [main.externalLinks]
         cue = true
         tab = true

exampleSite/content/en/blog/fourth-post.md

@@ -1,9 +1,10 @@
 ---
 author: Mark Dumay
-title: Fourth post
+title: Fourth post (excluded from search)
 date: 2023-01-01
-description: This is my fourth blog post.
+description: This is my fourth blog post. It is excluded from the search index.
 tags: ["blog"]
+searchExclude: true
 thumbnail:
   url: img/flowers.jpg
   author: Arvee Marie

exampleSite/go.sum

@@ -18,6 +18,10 @@ github.com/gethinode/mod-flexsearch v1.5.1 h1:9fYlnHgiEXckL0EoC0zlSNO7BWZf5yiOro
 github.com/gethinode/mod-flexsearch v1.5.1/go.mod h1:TXbGbWsvmhBdsTzRt887mcpFfr4ORpzG3+h/l4W3YM4=
 github.com/gethinode/mod-flexsearch v1.6.0 h1:Rjx+GLOByFLmaWD9hZXwmuKN8A89te6BZAIq2c9QBKg=
 github.com/gethinode/mod-flexsearch v1.6.0/go.mod h1:TXbGbWsvmhBdsTzRt887mcpFfr4ORpzG3+h/l4W3YM4=
+github.com/gethinode/mod-flexsearch v1.7.0 h1:VFTf6iUyT9b47jTDAxh8nVHU1eUBrdxlykaC90lTfqk=
+github.com/gethinode/mod-flexsearch v1.7.0/go.mod h1:TXbGbWsvmhBdsTzRt887mcpFfr4ORpzG3+h/l4W3YM4=
+github.com/gethinode/mod-flexsearch v1.7.1 h1:f4rjKkhleDVzqwUmwP1xZdhjru5VQ9g0MRDz0G6oLyY=
+github.com/gethinode/mod-flexsearch v1.7.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=
@@ -32,6 +36,12 @@ github.com/gethinode/mod-fontawesome v1.4.0 h1:JfmVYwQl19jmZxgxY64yvGqJAAEiFkKf2
 github.com/gethinode/mod-fontawesome v1.4.0/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
 github.com/gethinode/mod-fontawesome v1.5.0 h1:3mW5dnWauuF9wSWXNIY+PPgTNPlc/xQOQoG7XGic1Yk=
 github.com/gethinode/mod-fontawesome v1.5.0/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
+github.com/gethinode/mod-fontawesome v1.5.1 h1:C7goQY4HrEua/lpjC++laydNKBuYo1+307ngn5tyXeM=
+github.com/gethinode/mod-fontawesome v1.5.1/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
+github.com/gethinode/mod-fontawesome v1.6.1 h1:iqOgDGdw7Bs4hnzjF/8JsUn10omyKQZTglLqNenT1K0=
+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-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=
@@ -39,6 +49,8 @@ github.com/gethinode/mod-katex v1.0.3 h1:fvlUWqcUQqv2zRNM2kfmJ6GhXA816Tl1nfVrUkm
 github.com/gethinode/mod-katex v1.0.3/go.mod h1:byAfpI3wuqNJIooTGVEGc1cjBhhCy4+CcK1H6495MYg=
 github.com/gethinode/mod-katex v1.0.4 h1:NozgWPFnHhx1W+E9DnwMTRpvxPbdqdANEtwp9N3/mj8=
 github.com/gethinode/mod-katex v1.0.4/go.mod h1:byAfpI3wuqNJIooTGVEGc1cjBhhCy4+CcK1H6495MYg=
+github.com/gethinode/mod-katex v1.0.5 h1:AVhcTINYory0ygChQERf8PcyJkbT1oqhmLRF6ESnWOY=
+github.com/gethinode/mod-katex v1.0.5/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=

exampleSite/hugo_stats.json

@@ -38,8 +38,14 @@
       "sub",
       "sup",
       "svg",
+      "table",
+      "tbody",
+      "td",
+      "th",
+      "thead",
       "time",
       "title",
+      "tr",
       "ul",
       "use"
     ],
@@ -120,12 +126,15 @@
       "col-8",
       "col-9",
       "col-auto",
+      "col-lg-2",
       "col-lg-4",
       "col-lg-8",
       "col-md-10",
       "col-md-2",
+      "col-md-3",
       "col-md-4",
       "col-md-8",
+      "col-md-9",
       "col-md-auto",
       "col-sm-12",
       "col-sm-3",
@@ -141,6 +150,7 @@
       "d-grid",
       "d-inline",
       "d-inline-flex",
+      "d-lg-block",
       "d-md-block",
       "d-md-flex",
       "d-md-none",
@@ -304,6 +314,7 @@
       "pb-4",
       "pb-5",
       "pb-md-0",
+      "pe-1",
       "pe-3",
       "position-absolute",
       "position-fixed",
@@ -332,6 +343,7 @@
       "row",
       "row-cols-1",
       "row-cols-2",
+      "row-cols-lg-3",
       "row-cols-md-2",
       "row-cols-md-3",
       "row-cols-sm-2",
@@ -341,6 +353,7 @@
       "search-suggestions",
       "shadow",
       "show",
+      "sidebar-overflow",
       "slide",
       "small",
       "spinner-border",
@@ -352,6 +365,8 @@
       "syntax-highlight",
       "tab-content",
       "tab-pane",
+      "table",
+      "table-responsive",
       "tag-link",
       "text-bg-body",
       "text-bg-body-tertiary",

go.mod

@@ -5,9 +5,9 @@ go 1.19
 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.6.0 // indirect
+	github.com/gethinode/mod-flexsearch v1.7.1 // indirect
-	github.com/gethinode/mod-fontawesome v1.5.0 // indirect
+	github.com/gethinode/mod-fontawesome v1.7.3 // indirect
-	github.com/gethinode/mod-katex v1.0.4 // 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/nextapps-de/flexsearch v0.0.0-20230711092928-1243fd883ec3 // indirect

go.sum

@@ -36,6 +36,10 @@ github.com/gethinode/mod-flexsearch v1.5.1 h1:9fYlnHgiEXckL0EoC0zlSNO7BWZf5yiOro
 github.com/gethinode/mod-flexsearch v1.5.1/go.mod h1:TXbGbWsvmhBdsTzRt887mcpFfr4ORpzG3+h/l4W3YM4=
 github.com/gethinode/mod-flexsearch v1.6.0 h1:Rjx+GLOByFLmaWD9hZXwmuKN8A89te6BZAIq2c9QBKg=
 github.com/gethinode/mod-flexsearch v1.6.0/go.mod h1:TXbGbWsvmhBdsTzRt887mcpFfr4ORpzG3+h/l4W3YM4=
+github.com/gethinode/mod-flexsearch v1.7.0 h1:VFTf6iUyT9b47jTDAxh8nVHU1eUBrdxlykaC90lTfqk=
+github.com/gethinode/mod-flexsearch v1.7.0/go.mod h1:TXbGbWsvmhBdsTzRt887mcpFfr4ORpzG3+h/l4W3YM4=
+github.com/gethinode/mod-flexsearch v1.7.1 h1:f4rjKkhleDVzqwUmwP1xZdhjru5VQ9g0MRDz0G6oLyY=
+github.com/gethinode/mod-flexsearch v1.7.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=
@@ -62,6 +66,12 @@ github.com/gethinode/mod-fontawesome v1.4.0 h1:JfmVYwQl19jmZxgxY64yvGqJAAEiFkKf2
 github.com/gethinode/mod-fontawesome v1.4.0/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
 github.com/gethinode/mod-fontawesome v1.5.0 h1:3mW5dnWauuF9wSWXNIY+PPgTNPlc/xQOQoG7XGic1Yk=
 github.com/gethinode/mod-fontawesome v1.5.0/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
+github.com/gethinode/mod-fontawesome v1.5.1 h1:C7goQY4HrEua/lpjC++laydNKBuYo1+307ngn5tyXeM=
+github.com/gethinode/mod-fontawesome v1.5.1/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
+github.com/gethinode/mod-fontawesome v1.6.1 h1:iqOgDGdw7Bs4hnzjF/8JsUn10omyKQZTglLqNenT1K0=
+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-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=
@@ -72,6 +82,8 @@ github.com/gethinode/mod-katex v1.0.3 h1:fvlUWqcUQqv2zRNM2kfmJ6GhXA816Tl1nfVrUkm
 github.com/gethinode/mod-katex v1.0.3/go.mod h1:byAfpI3wuqNJIooTGVEGc1cjBhhCy4+CcK1H6495MYg=
 github.com/gethinode/mod-katex v1.0.4 h1:NozgWPFnHhx1W+E9DnwMTRpvxPbdqdANEtwp9N3/mj8=
 github.com/gethinode/mod-katex v1.0.4/go.mod h1:byAfpI3wuqNJIooTGVEGc1cjBhhCy4+CcK1H6495MYg=
+github.com/gethinode/mod-katex v1.0.5 h1:AVhcTINYory0ygChQERf8PcyJkbT1oqhmLRF6ESnWOY=
+github.com/gethinode/mod-katex v1.0.5/go.mod h1:byAfpI3wuqNJIooTGVEGc1cjBhhCy4+CcK1H6495MYg=
 github.com/gethinode/mod-leaflet v0.2.3 h1:QQI4h+IH0jZ7fx4q0um2YIEiYBoW3OAfW8qHzbRCDPk=
 github.com/gethinode/mod-leaflet v0.2.3/go.mod h1:uGggt87x4Fw7wBoJpSiUvNkYg+s/Ujne7klAX2rxMRk=
 github.com/gethinode/mod-leaflet v0.3.1 h1:H5MaOa+BB1KuVw7abTqfIn/SNzzRsAyx/WQoSe+2Ykc=

hugo_stats.json

@@ -15,6 +15,7 @@
       "link",
       "meta",
       "nav",
+      "ol",
       "p",
       "path",
       "script",
@@ -29,11 +30,14 @@
       "active",
       "align-items-center",
       "align-self-center",
+      "align-self-end",
       "bg-body",
       "bg-opacity-10",
       "bg-primary",
       "bottom-0",
       "bottom-bar",
+      "breadcrumb",
+      "breadcrumb-item",
       "btn",
       "btn-close",
       "btn-primary",
@@ -41,8 +45,10 @@
       "col-12",
       "col-6",
       "col-md-2",
+      "col-md-3",
       "col-md-4",
       "col-md-8",
+      "col-md-9",
       "col-sm-12",
       "collapse",
       "collapsed",
@@ -85,7 +91,6 @@
       "form-control",
       "fs-3",
       "fs-5",
-      "fw-30",
       "fw-bold",
       "hstack",
       "img-fluid",
@@ -144,7 +149,6 @@
       "row-cols-1",
       "row-cols-2",
       "row-cols-md-2",
-      "row-cols-sm-2",
       "row-cols-sm-3",
       "search",
       "search-input",

i18n/de.yaml

@@ -30,9 +30,9 @@
 - id: shareSystem
   translation: "Betriebssystem"
 - id: copyToClipboard
-  translation: "In Zwischenablage kopieren"
+  translation: "In die Zwischenablage kopieren"
 - id: copiedToClipboard
-  translation: "Der Text befindet sich in die Zwischenablage"
+  translation: "befindet sich in der Zwischenablage"
 - id: link
   translation: "Link zur Webseite"
 - id: code

i18n/en.yaml

@@ -27,6 +27,18 @@
   translation: "More {{ . }}"
 - id: emptyList
   translation: "No articles found"
+- id: emptyTags
+  translation: "No tags found"
+
+# Languages
+- id: lang_de
+  translation: "German"
+- id: lang_en
+  translation: "English"
+- id: lang_nl
+  translation: "Dutch"
+- id: lang_fr
+  translation: "French"
 
 # Sharing
 - id: shareLink
@@ -121,3 +133,17 @@
   translation: "Show"
 - id: comments
   translation: "Comments" 
+
+# Arguments
+- id: name
+  translation: "Name"
+- id: type
+  translation: "Type"
+- id: required 
+  translation: "Required"
+- id: default
+  translation: "Default"
+- id: comment
+  translation: "Comment"
+- id: supportedValues
+  translation: "Supported values"

i18n/nl.yaml

@@ -25,6 +25,18 @@
   translation: "Meer {{ . }}"
 - id: emptyList
   translation: "Geen artikelen gevonden"
+- id: emptyTags
+  translation: "Geen tags gevonden"
+
+# Languages
+- id: lang_de
+  translation: "Duits"
+- id: lang_en
+  translation: "Engels"
+- id: lang_nl
+  translation: "Nederlands"
+- id: lang_fr
+  translation: "Frans"
 
 # Sharing
 - id: shareLink
@@ -119,3 +131,18 @@
   translation: "Tonen"
 - id: comments
   translation: "Reacties" 
+
+
+# Arguments
+- id: name
+  translation: "Naam"
+- id: type
+  translation: "Type"
+- id: required 
+  translation: "Verplicht"
+- id: default
+  translation: "Standaardwaarde"
+- id: comment
+  translation: "Toelichting"
+- id: supportedValues
+  translation: "Toegestane waarden"

i18n/zh-hans.yaml

@@ -0,0 +1,135 @@
+# Single pages
+- id: postedOnDate
+  translation: "发布于 {{ . }}"
+- id: lastModified
+  translation: "最后修改于 {{ . }}"
+- id: read
+  translation: "阅读"
+- id: minutesShort
+  translation: "分钟"
+- id: words
+  translation: "字"
+- id: photoFull
+  translation: "照片由 %s 于 %s 拍摄"
+- id: photoShort
+  translation: "照片由 {{ . }} 拍摄"
+- id: photoOn
+  translation: "于"
+- id: draft
+  translation: "草稿"
+
+# List pages
+- id: article
+  translation: "文章"
+- id: articles
+  translation: "文章"
+- id: more
+  translation: "更多 {{ . }}"
+- id: emptyList
+  translation: "没有找到文章"
+- id: emptyTags
+  translation: "没有找到标签"
+
+# Languages
+- id: lang_de
+  translation: "German"
+- id: lang_en
+  translation: "English"
+- id: lang_nl
+  translation: "Dutch"
+- id: lang_fr
+  translation: "French"
+
+# Sharing
+- id: shareLink
+  translation: "分享至 {{ . }}"
+- id: shareSystem
+  translation: "系统"
+- id: copyToClipboard
+  translation: "复制到剪贴板"
+- id: copiedToClipboard
+  translation: "已复制到剪贴板"
+- id: link
+  translation: "链接"
+- id: code
+  translation: "代码"
+- id: download
+  translation: "下载文章"
+
+# Pagination
+- id: paginationNav
+  translation: "页面导航"
+- id: paginationPrevious
+  translation: "上一页"
+- id: paginationNext
+  translation: "下一页"
+- id: paginationFirst
+  translation: "第一页"
+- id: paginationLast
+  translation: "最后一页"
+
+# Navigation
+- id: colorMode
+  translation: "切换主题"
+- id: colorLight
+  translation: "亮色"
+- id: colorDark
+  translation: "暗色"
+- id: colorAuto
+  translation: "自动"
+- id: toggleMainNav
+  translation: "切换主导航"
+- id: home
+  translation: "首页"
+- id: languageSwitcherLabel
+  translation: "语言"
+- id: close
+  translation: "关闭"
+
+# Table of contents
+- id: toc
+  translation: "本页目录"
+- id: seeAlso
+  translation: "参见"
+- id: sectionMenu
+  translation: "选择一个主题"
+
+# Sidebar
+- id: toggleSidebar
+  translation: "切换侧边栏导航"
+
+# Feature
+- id: addedFeature
+  translation: "新增于 {{ . }}"
+- id: deprecatedFeature
+  translation: "已弃用于 {{ . }}"
+
+# Versioning
+- id: latest
+  translation: "最新"
+- id: allVersions
+  translation: "所有版本"
+- id: newerVersionAlert
+  translation: "有一个更新版本的 {{ . }}!"
+
+# 404 page
+- id: pageNotFound
+  translation: "您访问的页面不存在或发生了其他错误。请返回我们的{{ . }}。"
+- id: pageNotFoundTitle
+  translation: "页面未找到"
+- id: pageNotFoundHome
+  translation: "首页"
+
+# Footer
+- id: copyright
+  translation: "Copyright"
+- id: rights
+  translation: "版权所有"
+- id: poweredBy
+  translation: "由 {{ . }} 提供支持。"
+
+# Comments
+- id: show
+  translation: "显示"
+- id: comments
+  translation: "评论"

i18n/zh-hant.yaml

@@ -0,0 +1,135 @@
+# Single pages
+- id: postedOnDate
+  translation: "發佈於 {{ . }}"
+- id: lastModified
+  translation: "最後修改於 {{ . }}"
+- id: read
+  translation: "閱讀"
+- id: minutesShort
+  translation: "分鐘"
+- id: words
+  translation: "字"
+- id: photoFull
+  translation: "照片由 %s 於 %s 拍攝"
+- id: photoShort
+  translation: "照片由 {{ . }} 拍攝"
+- id: photoOn
+  translation: "於"
+- id: draft
+  translation: "草稿"
+
+# List pages
+- id: article
+  translation: "文章"
+- id: articles
+  translation: "文章"
+- id: more
+  translation: "更多 {{ . }}"
+- id: emptyList
+  translation: "沒有找到文章"
+- id: emptyTags
+  translation: "沒有找到標籤"
+
+# Languages
+- id: lang_de
+  translation: "German"
+- id: lang_en
+  translation: "English"
+- id: lang_nl
+  translation: "Dutch"
+- id: lang_fr
+  translation: "French"
+
+# Sharing
+- id: shareLink
+  translation: "分享至 {{ . }}"
+- id: shareSystem
+  translation: "系統"
+- id: copyToClipboard
+  translation: "複製到剪貼板"
+- id: copiedToClipboard
+  translation: "已複製到剪貼板"
+- id: link
+  translation: "連結"
+- id: code
+  translation: "程式碼"
+- id: download
+  translation: "下載文章"
+
+# Pagination
+- id: paginationNav
+  translation: "頁面導航"
+- id: paginationPrevious
+  translation: "上一頁"
+- id: paginationNext
+  translation: "下一頁"
+- id: paginationFirst
+  translation: "第一頁"
+- id: paginationLast
+  translation: "最後一頁"
+
+# Navigation
+- id: colorMode
+  translation: "切換主題"
+- id: colorLight
+  translation: "亮色"
+- id: colorDark
+  translation: "暗色"
+- id: colorAuto
+  translation: "自動"
+- id: toggleMainNav
+  translation: "切換主導航"
+- id: home
+  translation: "首頁"
+- id: languageSwitcherLabel
+  translation: "語言"
+- id: close
+  translation: "關閉"
+
+# Table of contents
+- id: toc
+  translation: "本頁目錄"
+- id: seeAlso
+  translation: "參見"
+- id: sectionMenu
+  translation: "選擇一個主題"
+
+# Sidebar
+- id: toggleSidebar
+  translation: "切換側邊欄導航"
+
+# Feature
+- id: addedFeature
+  translation: "新增於 {{ . }}"
+- id: deprecatedFeature
+  translation: "已棄用於 {{ . }}"
+
+# Versioning
+- id: latest
+  translation: "最新"
+- id: allVersions
+  translation: "所有版本"
+- id: newerVersionAlert
+  translation: "有一個更新版本的 {{ . }}!"
+
+# 404 page
+- id: pageNotFound
+  translation: "您訪問的頁面不存在或發生了其他錯誤。請返回我們的{{ . }}。"
+- id: pageNotFoundTitle
+  translation: "頁面未找到"
+- id: pageNotFoundHome
+  translation: "首頁"
+
+# Footer
+- id: copyright
+  translation: "Copyright"
+- id: rights
+  translation: "版權所有"
+- id: poweredBy
+  translation: "由 {{ . }} 提供支持。"
+
+# Comments
+- id: show
+  translation: "顯示"
+- id: comments
+  translation: "評論"

layouts/_default/baseof.html

@@ -48,6 +48,9 @@
 {{ $sections := partial "utilities/GetSections.html" (dict "page" . "loading" $loading) }}
 {{- $.Scratch.Set "sections" $sections -}}
 
+{{- /* Define main breakpoint */ -}}
+{{- $.Scratch.Set "breakpoint" (partial "utilities/GetBreakpoint.html") }}
+
 <!doctype html>
 <html lang="{{ .Site.Language.Lang }}" class="no-js">
     <head>

layouts/_default/list/body.html

@@ -1,9 +1,10 @@
 {{- $sections := $.Scratch.Get "sections" -}}
 {{- $fullCover := $.Scratch.Get "fullCover" -}}
+{{- $breakpoint := $.Scratch.Get "breakpoint" -}}
 {{- $layout := .Params.layout -}}
 
-<div class="row row-cols-1 row-cols-sm-2">
+<div class="row row-cols-1 row-cols-{{ $breakpoint.current }}-2">
-    <div class="col col-sm-12 col-md-8">
+    <div class="col-12 col-{{ $breakpoint.current }}-9">
         {{ if not .IsHome }}
             {{ with .Title }}<p id="{{ anchorize . }}" class="display-4 mt-5{{ if and $.IsHome site.Params.home.centerHeadline }} text-center{{ end }}">{{ . }}</p>{{ end }}
         {{ end }}
@@ -15,9 +16,12 @@
             {{- if $fullCover }}{{ $loading = site.Params.main.loading }}{{ end }}
         {{ end }}
         {{- $content := partial "utilities/ProcessContent" (dict "page" . "raw" .RawContent "loading" $loading) -}}
-        {{ $content | safeHTML }}
+        {{- $content | safeHTML -}}
         {{ if and (and $sections (eq (len $sections) 1)) (not $content) }}
             <p class="pt-4">{{- T "emptyList" }}.</p>
         {{ end }}
     </div>
-</div>
+    <div class="col col-{{ $breakpoint.current }}-3 d-none d-{{ $breakpoint.current }}-block">
+        {{/* Empty in default layout */}}        
+    </div>
+</div>    

layouts/_default/single.html

@@ -1,13 +1,13 @@
 {{- define "partials/single-main.html" -}}
+    {{- $breakpoint := $.Scratch.Get "breakpoint" -}}
     {{ if .Site.Params.navigation.breadcrumb }}{{ partial "assets/breadcrumb.html" . }}{{ end -}}
 
     {{ .Render "single/header" }}
 
     {{- if and .Site.Params.navigation.toc .Params.includeToc | default true -}}
-        <div class="d-md-none pb-5">{{ partial "assets/toc-dropdown.html" . }}</div>
+        <div class="d-{{ $breakpoint.current }}-none pb-5">{{ partial "assets/toc-dropdown.html" . }}</div>
     {{- end -}}
     {{ .Render "single/body" }}
-    {{ partial "utilities/ProcessContent" (dict "page" .Page "raw" .RawContent) }}
 
     {{ .Render "single/footer" }}
     {{- if and .Site.Params.comments.enabled .Params.showComments | default true -}}
@@ -17,21 +17,15 @@
 {{ end -}}
 
 {{ define "main" -}}
-    {{- $download := .Params.download -}}
-    {{- if and $download (not (fileExists (path.Join "static" $download))) -}}
-        {{- errorf "Cannot find download file for page '%s': %s" .File.Path $download -}}
-    {{- end -}}
-    
     {{- $menu := .Scratch.Get "sidebar" -}}
     {{- $version := .Scratch.Get "version" -}}
+    {{- $breakpoint := $.Scratch.Get "breakpoint" -}}
 
     {{ $sidebar := "" }}
     {{- $hasSidebar := .Site.Params.navigation.sidebar | default true -}}
     {{ if and $menu $hasSidebar  }}{{ $sidebar = partial "assets/sidebar.html" (dict "page" . "menu" $menu "version" $version) }}{{ end }}
 
-    {{ $toc := "" }}
+    {{ $toc := .Render "single/panel-toc" }}
-    {{- $hasTOC := and .Site.Params.navigation.toc .Params.includeToc | default true -}}
-    {{ if $hasTOC }}{{ $toc = partial "assets/toc.html" (dict "page" . "download" $download) }}{{ end -}}
 
     {{ with $sidebar -}}
         <div class="offcanvas offcanvas-start" tabindex="-1" id="offcanvass-sidebar" aria-inledby="offcanvas-label">
@@ -46,34 +40,24 @@
     {{ end }}
 
     <div class="container-xxl flex-fill p-4 px-xxl-0">
-        {{ if and $menu $hasSidebar -}}
+        {{ if $hasSidebar -}}
-            <div class="row row-cols-md-2 row-cols-lg-3">
+            <div class="row row-cols-1 row-cols-{{ $breakpoint.current }}-2 row-cols-{{ $breakpoint.next }}-3">
-                <div class="col col-md-3 col-lg-2 d-none pt-5 d-md-block sidebar-overflow sticky-top">
+                <div class="col col-{{ $breakpoint.next }}-2 d-none d-{{ $breakpoint.next }}-block sidebar-overflow sticky-top pt-5">
                     {{ $sidebar | safeHTML }}
                 </div>
-                <div class="col col-md-9 col-lg-8 mb-5 p-4">
+                <div class="col-12 col-{{ $breakpoint.current }}-9 col-{{ $breakpoint.next }}-8 mb-5 p-4">
                     {{ partial "partials/single-main.html" . }}
                 </div>
-                <div class="col col-lg-2 d-none d-lg-block pt-5">
+                <div class="col col-{{ $breakpoint.current }}-3 col-{{ $breakpoint.next }}-2 d-none d-{{ $breakpoint.current }}-block pt-5">
                     {{ $toc | safeHTML }}
                 </div>
             </div>
-        {{ else if $hasSidebar }}
-            <div class="row row-cols-1 row-cols-sm-3">
-                <div class="col col-md-2 d-none d-md-block"></div>
-                <div class="col col-sm-12 col-md-8">
-                    {{ partial "partials/single-main.html" . }}
-                </div>
-                <div class="col col-md-2 d-none d-md-block">
-                    {{ $toc | safeHTML }}
-                </div>
-            </div>    
         {{ else }}
-            <div class="row row-cols-1 row-cols-sm-2">
+            <div class="row row-cols-1 row-cols-{{ $breakpoint.current }}-2">
-                <div class="col col-sm-12 col-md-9">
+                <div class="col col-{{ $breakpoint.prev }}-12 col-{{ $breakpoint.current }}-9">
                     {{ partial "partials/single-main.html" . }}
                 </div>
-                <div class="col col-md-3 d-none d-md-block">
+                <div class="col col-{{ $breakpoint.current }}-3 d-none d-{{ $breakpoint.current }}-block">
                     {{ $toc | safeHTML }}
                 </div>
             </div>    

layouts/_default/single/body.html

@@ -1,2 +1,3 @@
 {{- partial "single/thumbnail.html" (dict "page" . "class" "mb-5") -}}
 
+{{ partial "utilities/ProcessContent" (dict "page" .Page "raw" .RawContent) }}

layouts/_default/single/header.html

@@ -1,12 +1,31 @@
-{{ $lastmodstr := (partial "utilities/date.html" (dict "date" .Lastmod "format" "long")) -}}
+{{- $metadata := "full" -}}
-{{ $datestr := (partial "utilities/date.html" (dict "date" .Date "format" "long")) -}}
+{{ if isset .Params "metadata" }}
+    {{ $metadata = .Params.metadata }}
+{{ else }}
+    {{- with (index site.Params.pages .Type ) -}}
+        {{ if isset . "metadata" }}{{ $metadata = (index . "metadata") }}{{ end }}
+    {{- end -}}
+{{ end }}
+
+{{- $supportedStates := slice "full" "original" "none" -}}
+{{- if not (in $supportedStates $metadata) -}}
+    {{- errorf "layout [_default/single/header.html] - Invalid value for param 'metadata': %s" $metadata -}}
+{{- end -}}
+
 {{ with .Title }}<p class="display-4 mt-5">{{ . }}</p>{{ end }}
-<small class="text-body-secondary text-uppercase">
+{{ if ne $metadata "none" }}
-    {{ $datestr | i18n "postedOnDate" -}}
+    {{ $lastmodstr := (partial "utilities/date.html" (dict "date" .Lastmod "format" "long")) -}}
-    {{ if ne $datestr $lastmodstr -}}&nbsp;({{ $lastmodstr | i18n "lastModified" }}){{ end }} &bull;
+    {{ $datestr := (partial "utilities/date.html" (dict "date" .Date "format" "long")) -}}
-    {{ .ReadingTime | lang.FormatNumber 0 }}&nbsp;{{ i18n "minutesShort" }} {{ i18n "read" }} &bull;
+    <small class="text-body-secondary text-uppercase">
-    {{ .WordCount | lang.FormatNumber 0 }}&nbsp;{{ i18n "words" }}
+        {{ $datestr | i18n "postedOnDate" -}}
-</small>
+        {{ if eq $metadata "full" }}
+            {{ if ne $datestr $lastmodstr -}}&nbsp;({{ $lastmodstr | i18n "lastModified" }}){{ end }}
+        {{ end }}
+        &bull;
+        {{ .ReadingTime | lang.FormatNumber 0 }}&nbsp;{{ i18n "minutesShort" }} {{ i18n "read" }} &bull;
+        {{ .WordCount | lang.FormatNumber 0 }}&nbsp;{{ i18n "words" }}
+    </small>
+{{ end }}
 
 {{- if gt (len (.GetTerms "tags")) 0 -}}
     <div class="mt-3">

layouts/_default/single/panel-toc.html

@@ -0,0 +1,42 @@
+{{- $download := .Params.download -}}
+{{- if and $download (not (fileExists (path.Join "static" $download))) -}}
+    {{- errorf "Cannot find download file for page '%s': %s" .File.Path $download -}}
+{{- end -}}
+
+{{- $toc := .Site.Params.navigation.toc -}}
+{{ if $toc }}
+    {{ if isset .Params "includeToc" }}
+        {{ $toc = .Params.includeToc }}
+    {{ else }}
+        {{- with (index site.Params.pages .Type) -}}
+            {{ if isset . "includetoc" }}
+                {{ $toc = index . "includetoc" }}
+                {{ if ne (printf "%T" $toc) "bool" }}
+                    {{ errorf "Expected bool value in site parameters: pages.%s.includeToc" $.Type }}
+                {{ end }}
+            {{ end }}
+    {{- end -}}
+    {{ end }}
+{{ end }}
+
+<div class="toc toc-sidebar mb-5 my-md-0 ps-xl-3 mb-lg-5 p-3 text-body-secondary sticky-top">
+    {{ with $download }}
+        {{ $title := (T "download" ) }}
+        {{ $lang := strings.TrimPrefix "." (path.Ext (path.BaseName .)) }}
+        {{ if and $lang (ne (string site.LanguageCode) $lang) }}
+            {{ range site.Languages }}
+                {{ if eq .LanguageCode $lang }}
+                    {{ $title = printf "%s (%s)" (T "download") (T (printf "lang_%s" .LanguageCode)) }}
+                {{ end }}
+            {{ end }}
+        {{ end }}
+        <div class="mb-5 text-center">
+            {{ $attr := dict "download" (path.Base .) }}
+            {{ partial "assets/button.html" (dict "href" . "title" $title "color" "primary" "outline" "true" "icon" "fas download" "size" "sm" "attributes" $attr) }}
+        </div>
+    {{ end }}
+
+    {{ if $toc }}
+        {{ partial "assets/toc.html" (dict "page" . "download" $download) }}
+    {{ end -}}
+</div>

layouts/docs/single/body.html

@@ -1 +1 @@
-{{/* Intentionally left blank to suppress thumbnail */}}
+{{ partial "utilities/ProcessContent" (dict "page" .Page "raw" .RawContent) }}

layouts/minimal/single/body.html

@@ -1 +1 @@
-{{/* Intentionally left blank to suppress thumbnail */}}
+{{ partial "utilities/ProcessContent" (dict "page" .Page "raw" .RawContent) }}

layouts/partials/assets/button.html

@@ -67,7 +67,7 @@
 {{- with .badge }}{{ $badge = . }}{{ end -}}
 
 {{- $label := "" -}}
-{{- with .label }}{{ $label = . }}{{ end -}}
+{{- if .label }}{{ $label = .label }}{{ else }}{{ $label = $title }}{{ end -}}
 
 {{- $tooltip := "" -}}
 {{- if not (strings.HasSuffix $state "active") -}}
@@ -143,7 +143,8 @@
 
 {{- $attributes := .attributes -}}
 
-<a aria-label="{{ (or $label $title) | safeHTML }}" {{ 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 -}}

layouts/partials/assets/card-group.html

@@ -36,6 +36,7 @@
 -->
 
 {{- $page := .page -}}
+{{- $breakpoint := partial "utilities/GetBreakpoint.html" -}}
 
 {{- if not (in (slice "*hugolib.pageState" "*hugolib.pageForShortcode") (printf "%T" $page)) -}}
     {{- errorf "partial [assets/card-group.html] - Invalid value for param 'page': %T" $page -}}
@@ -66,7 +67,7 @@
 {{ range $index, $element := $pages }}
     {{ $params := dict }}
     <!-- regular page -->
-    {{- if $element.RelPermalink -}}
+    {{- if and $element.RelPermalink $element.File -}}
         {{- $params = merge $params (dict "path" $element.File.Path) -}}
     <!-- headless page -->
     {{- else -}}
@@ -108,10 +109,10 @@
 {{- end -}}
 {{- $colGrid := "" -}}
 {{- if eq $cols "1" }}{{ $colGrid = "row-cols-1" -}}
-{{- else if eq $cols "2" }}{{ if $responsive }}{{ $colGrid = "row-cols-1 row-cols-sm-1 row-cols-md-2" }}{{ else }}{{ $colGrid = "row-cols-2" }}{{ end -}}
+{{- else if eq $cols "2" }}{{ if $responsive }}{{ $colGrid = printf "row-cols-1 row-cols-%s-1 row-cols-%s-2" $breakpoint.prev $breakpoint.current }}{{ else }}{{ $colGrid = "row-cols-2" }}{{ end -}}
-{{- else if eq $cols "3" }}{{ if $responsive }}{{ $colGrid = "row-cols-1 row-cols-sm-2 row-cols-md-3" }}{{ else }}{{ $colGrid = "row-cols-3" }}{{ end -}}
+{{- else if eq $cols "3" }}{{ if $responsive }}{{ $colGrid = printf "row-cols-1 row-cols-%s-2 row-cols-%s-3" $breakpoint.prev $breakpoint.current }}{{ else }}{{ $colGrid = "row-cols-3" }}{{ end -}}
-{{- else if eq $cols "4" }}{{ if $responsive }}{{ $colGrid = "row-cols-1 row-cols-sm-2 row-cols-md-4" }}{{ else }}{{ $colGrid = "row-cols-4" }}{{ end -}}
+{{- else if eq $cols "4" }}{{ if $responsive }}{{ $colGrid = printf "row-cols-1 row-cols-%s-2 row-cols-%s-4" $breakpoint.prev $breakpoint.current }}{{ else }}{{ $colGrid = "row-cols-4" }}{{ end -}}
-{{- else if eq $cols "5" }}{{ if $responsive }}{{ $colGrid = "row-cols-1 row-cols-sm-3 row-cols-md-5" }}{{ else }}{{ $colGrid = "row-cols-5" }}{{ end -}}
+{{- else if eq $cols "5" }}{{ if $responsive }}{{ $colGrid = printf "row-cols-1 row-cols-%s-3 row-cols-%s-5" $breakpoint.prev $breakpoint.current }}{{ else }}{{ $colGrid = "row-cols-5" }}{{ end -}}
 {{ end -}}
 
 {{- $gutter := .gutter | default "4" -}}
@@ -186,7 +187,7 @@
             <div class="pt-3">{{ partial "assets/pagination.html" (dict "page" $page "format" "terse") }}</div>
         {{- end -}} 
     {{ else }}
-        {{ if gt $count $max }}
+        {{ if and (gt $count $max) $moreTitle }}
             <a class="btn btn-outline-primary" href="{{ $moreURL| safeURL }}" role="button">{{ $moreTitle }}</a>
         {{ end }}
     {{ end }}

layouts/partials/assets/card.html

@@ -1,31 +1,49 @@
 <!-- 
-    Displays a Bootstrap card. Either specify a valid path, or set the arguments title, href, header, description, and
+    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
-    thumbnail individually. The latter arguments override any page attributes.
+    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.
-    The shortcode supports the following arguments:
-    "path"          Optional path of the page, override with other parameters.
-    "title"         Required title of the card.
-    "href"          Optional address for the button or hyperlink.
-    "class"         Optional class attribute of the card element, e.g. “w-50”.
-    "color":        Optional theme color of the card, either "primary", "secondary", "success", "danger",
-                    "warning", "info", "light", "dark", "white", "black", "body", or "body-tertiary". By default, no
-                    color is specified.
-    "padding":      Optional padding of the content, either "0", "1", "2", "3", "4", "5", or "auto" (default).
-    "gutter"        Gutter between columns in a group, either "0" (default), "1", "2", "3", "4", or "5".
-    "header"        Optional header components of the card, displayed in small caps. Supported values are "full"
-                    (default), "publication", "tags", and "none".
-    "footer"        Optional footer components of the card, displayed in small caps. Supported values are "full",
-                    "publication", "tags", and "none" (default).
-    "description"   Optional description of the card.
-    "thumbnail"     Optional thumbnail image url, displayed on top or the left of the card.
-    "ratio"         Optional ratio of the thumbnail image, defaults to "16x9" (stacked orientation) or "1x1" (horizontal
-                    orientation).
-    "alt"           Optional alternate text for the thumbnail, uses "title" by default.
-    "icon"          Optional Font Awesome icon, displayed on top or the left of the card.
-    "orientation"   Optional placecement of the thumbnail or icon, either "stacked" (default), "horizontal",
-                    "horizontal-sm" or "none".
 -->
 
+<!-- Validate and initialize arguments -->
+{{ if partial "utilities/IsInvalidArgs.html" (dict "structure" "card" "args" .) }}
+    {{- errorf "partial [assets/card.html] - Invalid arguments" -}}
+{{ end }}
+
+<!-- Initialize arguments and default values -->
+{{- $alt := .alt -}}
+{{- $class := .class -}}
+{{- $color := .color -}}
+{{- $description := .description -}}
+{{- $footer := .footer | default "none" -}}
+{{- $gutter := .gutter | default "0" -}}
+{{- $header := .header | default "full" -}}
+{{- $href := .href -}}
+{{- $icon := .icon -}}
+{{- $loading := .loading -}}
+{{- $orientation := .orientation | default "stacked" -}}
+{{- $padding := .padding | default "auto" -}}
+{{- $ratio := .ratio -}}
+{{- $thumbnail := .thumbnail -}}
+{{- $title := .title -}}
+
+<!-- Override arguments -->
+{{- $page := "" }}
+{{- if .path }}
+    {{- $page = site.GetPage .path }}
+    {{- if not $page }}
+        {{- errorf "partial [assets/card.html] - Cannot find page: %s" .path -}}
+    {{- end }}
+{{- end }}
+{{- with $page -}}
+    {{- if not $title }}{{ $title = .Title }}{{ end -}}
+    {{- if not $href }}{{ $href = .RelPermalink  }}{{ end -}}
+    {{- if not $description }}{{ $description = partial "utilities/GetDescription.html" . }}{{ end -}}
+    {{- if not $thumbnail }}{{ $thumbnail = (or (and (reflect.IsMap .Params.Thumbnail) .Params.Thumbnail.url) .Params.Thumbnail) }}{{ end -}}
+    {{- if not $icon }}{{ $icon = .Params.icon }}{{ end -}}
+{{- end -}}
+
+{{- if eq $orientation "none" }}{{ $thumbnail = "" }}{{ $icon = "" }}{{ end -}}
+
 <!-- Inline partial to render the card's body -->
 {{- define "partials/card-body.html" -}}
     {{- $title := .title -}}
@@ -77,85 +95,11 @@
     </small></p>
 {{- end -}}
 
-{{- $page := "" }}
+<!-- Main code -->
-{{- if .path }}
-    {{- $page = site.GetPage .path }}
-    {{- if not $page }}
-        {{- errorf "partial [assets/card.html] - Cannot find page: %s" .path -}}
-    {{- end }}
-{{- end }}
-
-{{- $title := .title -}}
-{{- $alt := .alt -}}
-{{- $href := .href -}}
-{{- $description := .description -}}
-{{- $thumbnail := .thumbnail -}}
-{{- $ratio := .ratio -}}
-{{- $icon := .icon -}}
-
-{{- $color := "" -}}
-{{- with .color }}{{ $color = . }}{{ end -}}
-{{- if $color -}}
-    {{- $supportedColors := slice "primary" "secondary" "success" "danger" "warning" "info" "light" "dark" "white" "black" "body" "body-tertiary" -}}
-    {{- if not (in $supportedColors $color) -}}
-        {{- errorf "partial [assets/card.html] - Invalid value for param 'color': %s" $color -}}
-    {{- end -}}
-{{- end -}}
-
-{{- $header := "full" -}}
-{{- with .header }}{{ $header = . }}{{ end -}}
-{{- $supportedKeywords := slice "full" "publication" "tags" "none" -}}
-{{- if not (in $supportedKeywords $header) -}}
-    {{- errorf "partial [assets/card.html] - Invalid value for param 'header': %s" $header -}}
-{{- end -}}
-
-{{- $footer := "none" -}}
-{{- with .footer }}{{ $footer = . }}{{ end -}}
-{{- if not (in $supportedKeywords $footer) -}}
-    {{- errorf "partial [assets/card.html] - Invalid value for param 'footer': %s" $footer -}}
-{{- end -}}
-
-{{- with $page -}}
-    {{- if not $title }}{{ $title = .Title }}{{ end -}}
-    {{- if not $href }}{{ $href = .RelPermalink  }}{{ end -}}
-    {{- if not $description }}{{ $description = partial "utilities/GetDescription.html" . }}{{ end -}}
-    {{- if not $thumbnail }}{{ $thumbnail = (or (and (reflect.IsMap .Params.Thumbnail) .Params.Thumbnail.url) .Params.Thumbnail) }}{{ end -}}
-    {{- if not $icon }}{{ $icon = .Params.icon }}{{ end -}}
-{{- end -}}
-
-{{- $class := .class -}}
-
-{{- $padding := "auto" -}}
-{{- with .padding }}{{ $padding = . }}{{ end -}}
-{{- $supportedPaddings := slice "0" "1" "2" "3" "4" "5" "auto" -}}
-{{- if not (in $supportedPaddings $padding) -}}
-    {{- errorf "partial [assets/card.html] - Invalid value for param 'padding': %s" $padding -}}
-{{- end -}}
-
-{{- $gutter := .gutter | default "0" -}}
-{{ $supportedGutters:= slice "0" "1" "2" "3" "4" "5" -}}
-{{ if not (in $supportedGutters $gutter) -}}
-    {{- errorf "partial [assets/card.html] - Invalid value for param 'gutter': %s" $gutter -}}
-{{ end -}}
-
-{{- $orientation := "stacked" -}}
-{{- with .orientation }}{{ $orientation = . }}{{ end -}}
-{{- $supportedOrientations := slice "stacked" "horizontal" "horizontal-sm" "none" -}}
-{{- if not (in $supportedOrientations $orientation) -}}
-    {{- errorf "partial [assets/card.html] - Invalid value for param 'orientation': %s" $orientation -}}
-{{- end -}}
-{{- if eq $orientation "none" }}{{ $thumbnail = "" }}{{ $icon = "" }}{{ end -}}
-
-{{- $loading := .loading -}}
-{{- $validSettings := slice "lazy" "eager" -}}
-{{- if $loading -}}
-    {{ if not (in $validSettings $loading) -}}
-        {{- errorf "partial [assets/card.html] - Invalid value for param 'loading': %s" $loading -}}
-    {{ end -}}
-{{- end -}}
-
 {{ if ne $gutter "0" }}<div class="g-{{ $gutter }}">{{ end }}
+
 {{- if hasPrefix $orientation "horizontal" -}}
+    <!-- Render horizontal card -->
     <div class="card {{ with $color }}bg-{{ . }} text-bg-{{ . }}{{ end }} {{ $class }}">
         <div class="row g-0 row-cols-1 h-100">
             <div class="col-4{{ if eq  $orientation "horizontal-sm" }} col-md-2{{ end }}">
@@ -179,6 +123,7 @@
         </div>
     </div>
 {{- else -}}
+    <!-- Render stacked / default card -->
     <div class="card {{ with $color }}bg-{{ . }} text-bg-{{ . }}{{ end }} {{ $class }}">
         {{- if $thumbnail -}}
             {{- partial "assets/image.html" (dict "url" $thumbnail "ratio" (or $ratio "16x9") "outerClass" "card-img-wrap" "innerClass" "card-img-top" "title" (or $alt $title) "loading" $loading) -}}
@@ -194,4 +139,5 @@
         </div>
     </div>
 {{- end -}}
+
 {{ if ne $gutter "0" }}</div>{{ end }}

layouts/partials/assets/carousel-item.html

@@ -13,7 +13,7 @@
     {{ end -}}
 {{- end -}}
 
-<div class="carousel-item{{ if $active }} active{{ end }}">
+<div class="carousel-item{{ if $active }} active{{ end }}" {{ if not $active }} fetchpriority="low"{{ end }}>
     {{ partial "assets/image.html" (dict "url" $src "ratio" $ratio "page" $page "innerClass" "d-block w-100" "portrait" $portrait "loading" $loading) }}
     <div class="carousel-caption gradient"></div>
     {{ with $caption }}

layouts/partials/assets/image.html

@@ -25,6 +25,10 @@
                     loaded images is deferred until the image is within scrolling range of the viewport. This should
                     reduce the initial loading time of the website. It is recommended to lazily load only those images
                     that are below the page fold.
+    "priority":     Optional fetch priority of the image, either "high", "low", or "auto" (default). The priority
+                    provides a hint to the browser on how it should prioritize the fetch of the image relative to other
+                    images. The implementation is experimental and currently only supported by Chrome, Edge, and Opera.
+                    (https://developer.mozilla.org/en-US/docs/Web/API/HTMLImageElement/fetchpriority#browser_compatibility).
     "outerClass":   Optional class attribute of the outer div element, e.g. "img-wrap".
     "innerClass":   Optional class attribute of the inner img element, e.g. "rounded".
     "title":        Optional alternate text of the image.
@@ -64,6 +68,15 @@
 {{- end -}}
 {{- $lazy := eq $loading "lazy" -}}
 
+{{- $priority := .priority -}}
+{{- $validPriorities := slice "high" "low" "auto" -}}
+{{- if $priority -}}
+    {{ if not (in $validPriorities $priority) -}}
+        {{- errorf "partial [assets/image.html] - Invalid value for param 'priority'" -}}
+    {{ end -}}
+{{- end -}}
+{{- if eq $priority "auto" }}{{ $priority = "" }}{{ end -}}
+
 {{- define "partials/image-portrait.html" -}}
     {{- $dimensions := slice }}
     {{- $dim := .dim -}}
@@ -196,6 +209,7 @@
     {{- $modes := .modes -}}
     {{- $lazy := .lazy -}}
     {{- $page := .page -}}
+    {{- $priority := .priority -}}
     {{- $isVector := false -}}
 
     {{- $segments := split $url "#" -}}
@@ -209,8 +223,19 @@
     {{- if hasSuffix $url "svg" -}}
         {{- $fallbackURL = $url -}}
         {{- $isVector = true -}}
+        {{- $res := partial "utilities/GetResource.html" (dict "url" $url "page" $page) -}}
+        {{ if not $res }}
+            {{- if not (fileExists (path.Join "/static" $url)) -}}
+                {{ warnf "Cannot find vector image resource: %q" $url -}}
+            {{ end }}
+        {{ end }}
     {{- else -}}
-        {{- $img := partial "utilities/GetImage.html" (dict "url" $url "page" $page) -}}
+        {{- $res := partial "utilities/GetImage.html" (dict "url" $url "page" $page) -}}
+        {{- $img := "" -}}
+        {{ with $res }}
+            {{ $img = $res.resource }}
+            {{ if $res.mirror }}{{ $innerClass = printf "%s mirrorred" $innerClass }}{{ end }}
+        {{ end }}
         {{- if $img -}}
             {{- $fallback := partial "partials/image-default.html" (dict "img" $img "ratio" $ratio "portrait" $portrait) -}}
             {{- if $absoluteURL -}}
@@ -250,6 +275,7 @@
             <img class="img-fluid {{ $innerClass }}"
                 src="{{ $fallbackURL }}"
                 {{ if $lazy }}loading="lazy"{{ end }}
+                {{ with $priority }}fetchpriority="{{ . }}"{{ end }}
                 {{ with $imgset -}}srcset="{{ . }}" sizes="100vw"{{- end }}
                 {{ with $height }}height="{{ . }}"{{ end }}
                 {{ with $width }}width="{{ . }}"{{ end }}
@@ -277,6 +303,7 @@
     "title" $title
     "caption" $caption
     "lazy" $lazy
+    "priority" $priority
     "page" $page)
 -}}
 

layouts/partials/assets/section-list.html

@@ -1,7 +1,7 @@
 {{- $page := .page }}
 {{- $section := .section }}
 {{- if not $section }}{{ errorf "partial [assets/section-list.html] - Missing value for param 'section'" }}{{ end -}}
-{{- $home := .home }}
+{{- $home := .home | default false }}
 {{ if ne (printf "%T" $home) "bool" }}
     {{ errorf "partial [assets/section-list.html] - Invalid value for param 'home'"}}
 {{ end }}
@@ -37,13 +37,14 @@
 {{- $ratio := "" -}}
 {{- $wrap := false -}}
 {{- $loading := .loading -}}
+{{- $wrapper := .wrapper | default "p-4 px-xxl-0 pb-5" -}}
 
 {{- with (index site.Params.sections $section) -}}
     {{- with index . "title" }}{{ $title = or $.title . }}{{ end -}}
     {{- with index . "sectionHeader" }}{{ $sectionHeader = . }}{{ end -}}
     {{- with index . "sort" }}{{ $sort = . }}{{ end -}}
     {{- if (index . "reverse") }}{{ $order = "desc" }}{{ else }}{{ $order = "asc" }}{{ end -}}
-    {{- if $home }}{{- if (isset . "nested") }}{{ $nested = (index . "nested") }}{{ end -}}{{ end -}}
+    {{- if (isset . "nested") }}{{ $nested = (index . "nested") }}{{ end -}}
     {{- if (index . "separator") }}{{ $separator = true }}{{ else }}{{ $separator = false }}{{ end -}}
     {{- with index . "orientation" }}{{ $orientation = . }}{{ end -}}
     {{- with index . "cols" }}{{ $cols = . }}{{ end -}}
@@ -63,6 +64,10 @@
     {{- with index . "ratio" }}{{ $ratio = . }}{{ end -}}
     {{- with index . "wrap" }}{{ $wrap = . }}{{ end -}}
 {{- end -}}
+
+{{ if isset $page.Params "nested" }}
+    {{ $nested = $page.Params.nested }}
+{{ end }}
 {{ if ne (printf "%T" $nested) "bool" }}
     {{ errorf "partial [assets/section-list.html] - Invalid value for param 'nested'"}}
 {{ end }}
@@ -77,13 +82,25 @@
     {{ else }}
         {{ $list = where site.Pages (printf ".Params.%s" $section) "!=" nil }}
     {{ end }}
-{{ else if $nested }}
+{{ else if eq $kind "related" }}
-    {{ $list = where site.RegularPages "Type" "in" $section }}
+    {{ if $page.Keywords}}
+        {{ $keywords := keyVals "tags" $page.Keywords }}
+        {{ $opts := dict "namedSlices" (slice $keywords) }}
+        {{ $list = site.RegularPages.Related $opts }}
+    {{ end }}
 {{ else if $home }}
     {{ $sectionPage := site.GetPage "section" $section }}
-    {{ $list = $sectionPage.RegularPages }}
+    {{ if $nested }}
+        {{ $list = $sectionPage.RegularPagesRecursive }}
+    {{ else }}
+        {{ $list = $sectionPage.Pages }}
+    {{ end }}
 {{ else }}
-    {{ $list = $page.RegularPages }}
+    {{ if $nested }}
+        {{ $list = $page.RegularPagesRecursive }}
+    {{ else }}
+        {{ $list = $page.Pages }}
+    {{ end }}
 {{ end }}
 
 {{ $max := (len $list) -}}
@@ -100,7 +117,7 @@
 {{- end -}}
 
 {{ if gt $max 0 }}
-    {{- if $home -}}
+    {{- if or $home (eq $kind "related") -}}
         {{- $paginate = false -}}
         {{- $max = int (math.Min $homepage $max) -}}
     {{ end -}}
@@ -128,7 +145,7 @@
     {{- $partial := "" -}}
 
     <div class="container-fluid {{ with $background }} bg-{{ . }}{{ end }} p-0">
-        <div class="container-xxl p-4 px-xxl-0 pb-5">
+        <div class="container-xxl {{ $wrapper }}">
             {{- partial "assets/section-header.html" $params -}}
             
             {{ if eq $layout "card" }}

layouts/partials/assets/sharing.html

@@ -1,11 +1,28 @@
 {{- if .Site.Params.sharing.enabled -}}
-    {{- if or .Params.sharing (not (isset .Params "sharing")) -}}
+    {{- $sharing := true -}}
+    {{ if isset .Params "sharing" }}
+        {{ $sharing = .Params.sharing }}
+    {{ else }}
+        {{- with (index site.Params.pages .Type ) -}}
+            {{ if isset . "sharing" }}
+                {{ $sharing = (index . "sharing") }}
+            {{ end }}
+        {{- end -}}
+    {{ end }}
+
+    {{- if $sharing -}}
         {{- $page := . -}}
         {{- $order := "asc" -}}
         {{- $list := .Site.Params.sharing.providers -}}
         {{- if .Site.Params.sharing.reverse }}{{ $order = "desc" }}{{ else }}{{ $order = "asc" }}{{ end -}}
         {{- $sort := .Site.Params.sharing.sort | default "weight" -}}
         {{- $list = sort $list $sort $order -}}
+
+        {{- $download := .Params.download -}}
+        {{- if and $download (not (fileExists (path.Join "static" $download))) -}}
+            {{- errorf "Cannot find download file for page '%s': %s" .File.Path $download -}}
+        {{- end -}}
+        
         <div class="py-3 text-body-secondary hstack gap-1">
             {{ T "shareLink" "" }}
             {{- range $index, $item := $list -}}
@@ -27,6 +44,10 @@
                 {{ $attr := dict "data-sharing-title" .Title "data-sharing-description" .Description "data-sharing-url" .Permalink }}
                 {{ partial "assets/button.html" (dict "href" "#!" "icon" "fas share-nodes fa-fw" "id" "btn-webshare" "class" "btn-social p-0" "attributes" $attr "label" (T "shareLink" (T "shareSystem")) "spacing" false) }}
             {{- end -}}
+            {{ with $download }}
+                {{ $attr := dict "download" (path.Base .) }}
+                {{ partial "assets/button.html" (dict "href" . "icon" "fas download fa-fw" "class" "btn-social p-0" "attributes" $attr "spacing" false) }}
+            {{- end -}}
         </div>
     {{- end -}}
 {{- end -}}

layouts/partials/assets/table.html

@@ -0,0 +1,25 @@
+{{ $page := .page }}
+{{ $input := .input }}
+{{ $args := .args }}
+
+{{- $responsiveVals := slice "table-responsive" "table-responsive-none" "table-responsive-sm" "table-responsive-md" "table-responsive-lg" "table-responsive-xl" "table-responsive-xxl" -}}
+{{- $responsive := intersect $args $responsiveVals -}}
+{{- $main := complement $responsive $args -}}
+
+{{- if in $responsive "table-responsive-none" -}}
+    {{- $responsive = "" -}}
+{{- else if not $responsive -}}
+    {{ $responsive = (slice "table-responsive") -}}
+{{- end -}}
+
+{{- $input := $input | $page.RenderString }}
+{{- $input = replace $input "style=\"text-align:left\"" "class=\"text-start\"" -}}
+{{- $input = replace $input "style=\"text-align:center\"" "class=\"text-center\"" -}}
+{{- $input = replace $input "style=\"text-align:right\"" "class=\"text-end\"" -}}
+{{- $class := delimit $main " " -}}
+{{- $old := "<table>" -}}
+{{- $new := printf "<table class=\"table %s\">" $class -}}
+{{ $input := replace $input $old $new -}}
+{{- with $responsive }}<div class="{{ delimit . " " }}">{{ end -}}
+{{ $input | safeHTML }}
+{{- with $responsive }}</div>{{ end -}}

layouts/partials/assets/toc.html

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

layouts/partials/head/seo.html

@@ -12,8 +12,10 @@
 
 {{- $thumbnail := (or (and (reflect.IsMap .Params.Thumbnail) .Params.Thumbnail.url) .Params.Thumbnail) -}}
 {{ with $thumbnail -}}
-    {{ $img := partial "utilities/GetImage.html" (dict "url" .) -}}
+{{- $res := partial "utilities/GetImage.html" (dict "url" .) -}}
-    {{ with $img -}}
+{{- $img := "" -}}
+{{ with $res }}{{ $img = $res.resource }}{{ end }}
+{{ with $img -}}
         {{ $dim := "1280x640" -}}
         {{ $scaled := (.Fill (printf "%s jpg" $dim)) -}}
         {{- $scaled = $scaled | resources.Copy (replace $img.RelPermalink ".jpg" (printf "-%s.jpg" $dim)) -}}

layouts/partials/list/featured.html

@@ -56,7 +56,7 @@
     {{ else }}
         {{- $thumbnail := (or (and (reflect.IsMap $page.Params.Thumbnail) $page.Params.Thumbnail.url) $page.Params.Thumbnail) -}}
         {{- if $thumbnail }}
-            {{ partial "assets/image.html" (dict "url" $thumbnail "ratio" "16x9" "outerClass" $style "innerClass" "rounded" "title" $page.Site.Title) }}
+            {{ partial "assets/image.html" (dict "url" $thumbnail "ratio" "16x9" "outerClass" $style "innerClass" "rounded" "title" $page.Site.Title "priority" "high") }}
         {{ end }}
     {{ end }}
 {{- end -}}

layouts/partials/single/thumbnail.html

@@ -1,5 +1,7 @@
 {{- $page := .page -}}
-{{- $class := printf "img-wrap %s" .class -}}
+{{- $class := printf "img-wrap" -}}
+{{- with .class }}{{ $class = printf "img-wrap %s" . }}{{ end -}}
+{{- $ratio := .ratio | default "21x9" -}}
 {{- $thumbnail := "" -}}
 {{- $credits := "" -}}
 
@@ -33,5 +35,5 @@
 {{- end -}}
 
 {{ if $thumbnail -}}
-    {{- partial "assets/image.html" (dict "url" $thumbnail "ratio" "21x9" "outerClass" $class "innerClass" "rounded" "title" $page.Params.title "caption" $credits) -}}
+    {{- partial "assets/image.html" (dict "url" $thumbnail "ratio" $ratio "outerClass" $class "innerClass" "rounded" "title" $page.Params.title "caption" $credits "priority" "high") -}}
 {{ end -}}

layouts/partials/utilities/GetBreakpoint.html

@@ -0,0 +1,21 @@
+{{- /* 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/GetImage.html

@@ -10,20 +10,11 @@
 
 {{ $url := .url -}}
 {{ $page := .page -}}
+{{ $mirror := false }}
 
 {{ $supportedMediaTypes := slice "image/png" "image/jpeg" "image/gif" "image/tiff" "image/bmp" "image/webp" -}}
-{{ $img := "" }}
 {{ $remote := hasPrefix (lower $url) "http" }}
-{{ if $remote }}
+{{- $img := partial "utilities/GetResource.html" (dict "url" $url "page" $page) -}}
-    {{ $img = resources.GetRemote $url -}}
-{{ else }}
-    {{ if $page }}
-        {{ $img = $page.Resources.Get $url -}}
-    {{ end }}
-    {{ if not $img }}
-        {{ $img = resources.GetMatch $url }}
-    {{ end }}
-{{ end }}
 
 {{ with $img -}}
     {{ if in $supportedMediaTypes (string $img.MediaType) -}}
@@ -38,6 +29,34 @@
             {{ 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 = "" -}}
@@ -46,4 +65,4 @@
     {{ warnf "Cannot find image resource: %q" $url -}}
 {{ end -}}
 
-{{ return $img -}}
+{{ return (dict "resource" $img "mirror" $mirror) -}}

layouts/partials/utilities/GetResource.html

@@ -0,0 +1,40 @@
+<!-- 
+    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/GetSections.html

@@ -48,7 +48,8 @@
 
     {{- $thumbnail := (or (and (reflect.IsMap $sectionPage.Params.Thumbnail) $sectionPage.Params.Thumbnail.url) $sectionPage.Params.Thumbnail) -}}
     {{- $icon := $sectionPage.Params.Icon -}}
-    {{- $content := $sectionPage.Content -}}
+    {{- $content := "" -}}
+    {{ if not $sectionPage.IsSection }}{{ $content = $sectionPage.Content }}{{ end -}}
     {{- $sectionTitle := strings.FirstUpper $sectionPage.Type -}}
     {{- $moreTitle := "" -}}
     {{- with (index site.Params.sections $section) -}}
@@ -61,7 +62,6 @@
         "section" $section 
         "home" $page.IsHome
         "simple" (eq (len $sections) 1)
-        "nested" (and $page.IsHome (eq $section $page.Section))
         "thumbnail" $thumbnail
         "icon" $icon
         "content" $content

layouts/partials/utilities/IsInvalidArgs.html

@@ -0,0 +1,76 @@
+<!-- 
+    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 slice }}
+
+{{ $definitions := (index site.Data.structures $structure).arguments }}
+{{ if not $definitions }}
+    {{- errorf "partial [utilities/ValidateArgs.html] - Missing definitions: %s" $structure -}}
+    {{ $error =  true }}
+{{ end }}
+
+{{ if not $error }}
+    {{ range $key, $val := $args }}
+        {{ $def := index $definitions $key }}
+        {{ 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 }}
+        {{ if $val }}
+            {{ if not (in $expected $actual ) }}
+                {{ warnf "[%s] argument '%s': expected type '%s', got '%s'" $structure $key (delimit $expected ", ") $actual }}
+                {{ $error = true }}
+            {{ end }}
+        {{ end }}
+
+        {{/* validate permitted values */}}
+        {{ if and $def.options.values (eq $actual "select") }}
+            {{ if and (not $def.optional) (not (in $def.options.values $val)) }}
+                {{ warnf "[%s] argument '%s': unexpected value '%s'" $structure $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 $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 $key $val $def.options.min $def.options.max}}
+                {{ $error = true }}
+            {{ end }}
+        {{ end }}
+    {{ end }}
+
+    {{/* validate required arguments */}}
+    {{ range $key, $val := $definitions }}
+        {{ if not $val.optional }}
+            {{ if not (in $args $key )}}
+                {{ warnf "[%s] argument '%s': expected value" $structure $key }}
+                {{ $error = true }}
+            {{ end }}
+        {{ end }}
+    {{ end }}
+{{ end }}
+
+{{ return $error }}

layouts/shortcodes/args.html

@@ -0,0 +1,68 @@
+{{ $error := false }}
+
+{{ $structure := "" }}
+{{- if .IsNamedParams }}{{ $structure = .Get "structure" }}{{ else }}{{ $structure = .Get 0 }}{{ end }}
+{{ if not $structure }}
+    {{- errorf "Invalid or missing value for param 'structure': %s" .Position -}}
+    {{ $error =  true }}
+{{ end }}
+
+{{ $definitions := (index site.Data.structures $structure).arguments }}
+{{ if not $definitions }}
+    {{- errorf "Cannot find data structure '%s': %s" $structure .Position -}}
+    {{ $error =  true }}
+{{ end }}
+
+{{ $group := "" }}
+{{- if .IsNamedParams }}{{ $group = .Get "group" }}{{ else }}{{ $group = .Get 1 }}{{ end }}
+
+{{ if not $error }}    
+    {{ $table := printf "| %s | %s | %s | %s | %s |\n| --- | --- | --- | --- | --- |" 
+        (T "name") (T "type") (T "required") (T "default") (T "comment") 
+    }}
+
+    {{ range $key, $val := $definitions }}
+        {{ $skip := false }}
+        {{ $groups := slice | append $val.group }}
+        {{ if and $group $val.group }}
+            {{ $skip = not (in $groups $group )}}
+        {{ end }}
+    
+        {{ if not $skip }}
+            {{ $type := $val.type }}
+            {{ if reflect.IsSlice $val.type }}{{ $type = delimit $val.type ", " }}{{ end }}
+
+            {{ $required := "" }}
+            {{ if not $val.optional }}{{ $required = "yes" }}{{ end }}
+
+            {{ $comment := $val.comment }}
+            {{ if $val.deprecated }}
+                {{ $comment = printf `{{< release version="%s" short="true" size="sm" inline="true" state="deprecated" >}} %s` $val.deprecated $comment }}
+            {{ end }}
+            {{ if $val.release }}
+                {{ $comment = printf `{{< release version="%s" short="true" size="sm" inline="true" >}} %s` $val.release $comment }}
+            {{ end }}
+
+            {{ $min := "" }}
+            {{ $max := "" }}
+            {{ if and $val.options.values (eq $type "select") }}
+                {{ $comment = printf "%s %s: [%s]." $comment (T "supportedValues") (delimit $val.options.values ", ") }}
+            {{ else if $val.options.min (in (slice "int" "float" "float64") $type) }}
+                {{ $min = $val.options.min }}
+            {{ else if $val.options.max (in (slice "int" "float" "float64") $type) }}
+                {{ $max = $val.options.max }}
+            {{ end }}
+            {{ if and $min $max }}
+                {{ $comment = printf "%s %s: [%d, %d]." $comment (T "supportedValues") $min $max }}
+            {{ else if $min }}
+                {{ $comment = printf "%s %s: >=%d." $comment (T "supportedValues") $min }}
+            {{ else if $max }}
+                {{ $comment = printf "%s %s: <=%d." $comment (T "supportedValues") $max }}
+            {{ end }}
+
+            {{ $table = printf "%s\n| %s | %s | %s | %s | %s |" $table $key $type $required (or $val.default "") $comment }}
+        {{ end }}
+    {{ end }}
+
+    {{ partial "assets/table.html" (dict "page" .Page "input" $table "args" slice) }}
+{{ end }}

layouts/shortcodes/card.html

@@ -1,29 +1,35 @@
 <!-- 
-    Displays a Bootstrap card that links to a page. Any inner text is used as description. The shortcode supports the
+    Copyright © 2023 The Hinode Team / Mark Dumay. All rights reserved.
-    following arguments:
+    Use of this source code is governed by The MIT License (MIT) that can be found in the LICENSE file.
-    "path"          Optional path of the page. If omitted, specify the title, icon, thumbnail, and body as needed. 
+    Visit gethinode.com/license for more details.
-    "title"         Optional title of the card.
-    "class"         Optional class attribute of the card element, e.g. “w-50”.
-    "color"         Optional theme color of the card, either "primary", "secondary", "success", "danger",
-                    "warning", "info", "light", "dark", "white", "black", "body", or "body-tertiary". By default, no
-                    color is specified.
-    "padding"       Optional padding of the content, either "0", "1", "2", "3", "4", "5", or "auto" (default).
-    "gutter"        Gutter between columns in a group, either "0" (default), "1", "2", "3", "4", or "5".
-    "header"        Optional header components of the card, displayed in small caps. Supported values are "full"
-                    (default), "publication", "tags", and "none".
-    "footer"        Optional footer components of the card, displayed in small caps. Supported values are "full",
-                    "publication", "tags", and "none" (default).
-    "orientation"   Optional placecement of the thumbnail, either "stacked" (default), "horizontal", or "none".
-    "thumbnail"     Optional thumbnail image url, displayed on top or the left of the card.
-    "alt"           Optional alternate text for the thumbnail, uses "title" by default.
-    "icon"          Optional Font Awesome icon, displayed on top or the left of the card.
 -->
 
 {{ $error := false }}
 
-{{ $path := or (.Get "path") "" }}
+<!-- Validate and initialize arguments -->
-{{ $page := .Page }}
+{{ if partial "utilities/IsInvalidArgs.html" (dict "structure" "card" "args" .Params) }}
-{{ with $path }}
+    {{ errorf "Invalid arguments: %s" .Position -}}
+    {{ $error = true }}
+{{ end }}
+
+<!-- Initialize arguments and default values -->
+{{- $alt := .Get "alt" -}}
+{{- $class := partial "utilities/GetArgParent" (dict "page" . "arg" "class" "merge" true) -}}
+{{- $color := partial "utilities/GetArgParent" (dict "page" . "arg" "color") -}}
+{{- $description := trim .Inner " \r\n" | .Page.RenderString | safeHTML -}}
+{{- $footer := partial "utilities/GetArgParent" (dict "page" . "arg" "footer") | default "none" -}}
+{{- $gutter := partial "utilities/GetArgParent" (dict "page" . "arg" "gutter") | default "0" -}}
+{{- $header := partial "utilities/GetArgParent" (dict "page" . "arg" "header") | default "full" -}}
+{{- $icon := .Get "icon" -}}
+{{- $orientation := partial "utilities/GetArgParent" (dict "page" . "arg" "orientation") | default "stacked" -}}
+{{- $padding := partial "utilities/GetArgParent" (dict "page" . "arg" "padding") | default "auto" -}}
+{{- $page := .Page -}}
+{{- $path := .Get "path" -}}
+{{- $thumbnail := .Get "thumbnail" -}}
+{{- $title := .Get "title" -}}
+
+<!-- Override arguments -->
+{{ if $path }}
     {{ $page = $.Site.GetPage $path }}
     {{ if not $page }}
         {{ errorf "Invalid or missing value for param 'path': %s" .Position -}}
@@ -31,67 +37,13 @@
     {{ end }}
 {{ end }}
 
-{{- $class := partial "utilities/GetArg" (dict "page" . "arg" "class" "merge" true) -}}
-
-{{- $color := partial "utilities/GetArg" (dict "page" . "arg" "color") -}}
-{{ if $color }}
-    {{ $supportedColors := slice "primary" "secondary" "success" "danger" "warning" "info" "light" "dark" "white" "black" "body" "body-tertiary" -}}
-    {{ if not (in $supportedColors $color) -}}
-        {{ errorf "Invalid value for param 'color': %s" .Position -}}
-        {{ $error = true -}}
-    {{ end -}}
-{{ end -}}
-
-{{- $header := partial "utilities/GetArg" (dict "page" . "arg" "header") | default "full" -}}
-{{ $supportedKeywords := slice "full" "publication" "tags" "none" -}}
-{{ if not (in $supportedKeywords $header) -}}
-    {{ errorf "Invalid value for param 'header': %s" .Position -}}
-{{ end -}}
-
-{{- $footer := partial "utilities/GetArg" (dict "page" . "arg" "footer") | default "none" -}}
-{{ if not (in $supportedKeywords $footer) -}}
-    {{ errorf "Invalid value for param 'footer': %s" .Position -}}
-{{ end -}}
-
-{{- $padding := partial "utilities/GetArg" (dict "page" . "arg" "padding") | default "auto" -}}
-{{ $supportedPaddings := slice "0" "1" "2" "3" "4" "5" "auto" -}}
-{{ if not (in $supportedPaddings $padding) -}}
-    {{ errorf "Invalid value for param 'padding': %s" .Position -}}
-    {{ $error = true -}}
-{{ end -}}
-
-{{- $gutter := partial "utilities/GetArg" (dict "page" . "arg" "gutter") | default "0" -}}
-{{ $supportedGutters:= slice "0" "1" "2" "3" "4" "5" -}}
-{{ if not (in $supportedGutters $gutter) -}}
-    {{ errorf "Invalid value for param 'gutter': %s" .Position -}}
-    {{ $error = true -}}
-{{ end -}}
-
-{{- $orientation := partial "utilities/GetArg" (dict "page" . "arg" "orientation") | default "stacked" -}}
-{{ $supportedOrientations := slice "stacked" "horizontal" "none" -}}
-{{ if not (in $supportedOrientations $orientation) -}}
-    {{ errorf "Invalid value for param 'orientation': %s" .Position -}}
-    {{ $error = true -}}
-{{ end -}}
-
-{{- $layout := partial "utilities/GetArg" (dict "page" . "arg" "layout") | default "rich" -}}
-{{ $supportedLayouts := slice "rich" "minimal" -}}
-{{ if not (in $supportedLayouts $layout) -}}
-    {{ errorf "Invalid value for param 'layout': %s" .Position -}}
-    {{ $error = true -}}
-{{ end -}}
-
-{{ $description := trim .Inner " \r\n" | .Page.RenderString | safeHTML }}
-{{ $title := .Get "title" | default "" -}}
-{{ $alt := .Get "alt" | default "" -}}
-{{ $icon := .Get "icon" | default "" -}}
-{{ $thumbnail := .Get "thumbnail" | default "" -}}
-
 {{ if .Parent }}
     {{ $class = (printf "h-100 %s" $class) }}
 {{ end }}
 
+<!-- Main code -->
 {{ if not $error -}}
+    <!-- Render card -->
     {{- $output := partial "assets/card.html" (dict 
         "path" $path
         "title" $title
@@ -108,6 +60,7 @@
         "alt" $alt
     ) -}}
 
+    <!-- Pass output to parent or current stream -->
     {{ with .Parent }}
         {{ $current := .Scratch.Get "inner" }}
         {{ if $current }}

layouts/shortcodes/image.html

@@ -19,11 +19,22 @@
     "mode":         Optional flag indicating if the image should support color modes.
 -->
 
-{{- if isset .Params "src" -}}
+{{- $url := "" -}}
-    {{ $error := false -}}
+{{- $ratio := "" -}}
-    {{ $url := .Get "src" | default "" -}}
+{{- $wrapper := "" -}}
+{{- $class := "" -}}
+{{- $title := "" -}}
+{{- $caption := "" -}}
+{{- $mode := false -}}
+{{- $portrait := false -}}
+{{- $loading := "" -}}
+{{- $error := false -}}
+
+{{- if .IsNamedParams -}}
+    {{ $url = .Get "src" | default "" -}}
+    
     {{- $validRatios := slice "1x1" "3x2" "4x3" "16x9" "21x9" -}}
-    {{ $ratio := .Get "ratio" | default "" -}}
+    {{ $ratio = .Get "ratio" | default "" -}}
     {{ if $ratio -}}
         {{ if not (in $validRatios $ratio) -}}
             {{ errorf "Invalid value for param 'ratio': %s" .Position -}}
@@ -31,10 +42,10 @@
         {{ end -}}
     {{ end -}}
     
-    {{- $class := .Get "class" | default "" -}}
+    {{- $class = .Get "class" | default "" -}}
-    {{- $wrapper := .Get "wrapper" | default "" -}}
+    {{- $wrapper = .Get "wrapper" | default "" -}}
 
-    {{- $loading := .Get "loading" | default "" -}}
+    {{- $loading = .Get "loading" | default "" -}}
     {{- $validSettings := slice "lazy" "eager" -}}
     {{- if $loading -}}
         {{ if not (in $validSettings $loading) -}}
@@ -42,14 +53,12 @@
             {{ $error = true -}}
         {{ end -}}
     {{- end -}}
-    {{- $lazy := eq $loading "lazy" -}}
     
-    {{ $title := .Get "title" | default "" -}}
+    {{ $title = .Get "title" | default "" -}}
-    {{ $caption := .Get "caption" | default "" -}}
+    {{ $caption = .Get "caption" | default "" -}}
 
     {{ $supportedFlags := slice "true" "false" -}}
     {{ $modeParam := "false" -}}
-    {{ $mode := false -}}
     {{ with .Get "mode" }}{{ $modeParam = . }}{{ end -}}
     {{ if in $supportedFlags $modeParam -}}
         {{ if eq $modeParam "true" }}{{ $mode = true }}{{ else }}{{ $mode = false }}{{ end -}}
@@ -59,7 +68,6 @@
     {{ end -}}
 
     {{ $portraitParam := "false" -}}
-    {{ $portrait := false -}}
     {{ with .Get "portrait" }}{{ $portraitParam = . }}{{ end -}}
     {{ if in $supportedFlags $portraitParam -}}
         {{ if eq $portraitParam "true" }}{{ $portrait = true }}{{ else }}{{ $portrait = false }}{{ end -}}
@@ -67,21 +75,26 @@
         {{ errorf "Invalid value for param 'portrait': %s" $portraitParam -}}
         {{ $error = true -}}
     {{ end -}}
-    
-    {{- if not $error -}}
-        {{- partial "assets/image.html" (dict 
-            "url" $url
-            "ratio" $ratio
-            "outerClass" $wrapper
-            "innerClass" $class
-            "title" $title
-            "caption" $caption
-            "mode" $mode
-            "portrait" $portrait
-            "loading" $loading
-            "page" .Page)
-        -}} 
-    {{- end -}}
 {{ else -}}
+    {{ $url = .Get 0 }}
+{{ end -}}
+
+{{ if not $url }}
     {{ errorf "Missing value for param 'src': %s" .Position -}}
-{{ end -}}
+    {{- $error = true -}}
+{{ end }}
+
+{{- if not $error -}}
+    {{- partial "assets/image.html" (dict 
+        "url" $url
+        "ratio" $ratio
+        "outerClass" $wrapper
+        "innerClass" $class
+        "title" $title
+        "caption" $caption
+        "mode" $mode
+        "portrait" $portrait
+        "loading" $loading
+        "page" .Page)
+    -}} 
+{{- end -}}

layouts/shortcodes/img.html

@@ -15,8 +15,8 @@
     {{- $src := .Get "src" | default "" -}}
     {{- if $src -}}
         {{- $caption := .Get "caption" | default "" -}}
-        {{- $ratio := partial "utilities/GetArg" (dict "page" . "arg" "ratio") -}}
+        {{- $ratio := partial "utilities/GetArgParent" (dict "page" . "arg" "ratio") -}}
-        {{- $portrait := partial "utilities/GetArg" (dict "page" . "arg" "portrait") | default false -}}
+        {{- $portrait := partial "utilities/GetArgParent" (dict "page" . "arg" "portrait") | default false -}}
         {{- $active := eq .Ordinal 0 -}}
         {{- $output := partial "assets/carousel-item" (dict 
             "page" .Page

layouts/shortcodes/timeline.html

@@ -50,7 +50,7 @@
     <div class="col-{{ $col }} d-flex justify-content-{{ $direction }} align-items-center">
         <div class="d-flex">
             <div class="d-flex timeline-semi-circle-{{ $direction }} fa-wrapper align-items-center justify-content-center">
-                {{ partial "assets/icon.html" (dict "icon" (printf "%s fa-fluid" $icon)) }}
+                {{ partial "assets/icon.html" (dict "icon" (printf "%s fa-fluid" $icon) "spacing" false) }}
             </div>
             <div class="timeline-connector-{{ $direction }} {{ if eq $direction "start" }} order-first{{ end }}"></div>
         </div>

layouts/shortcodes/youtube.html

@@ -4,7 +4,7 @@
 {{- $id := .Get "id" | default (.Get 0) -}}
 {{- $class := .Get "class" | default (.Get 1) -}}
 {{- $title := .Get "title" | default "YouTube Video" }}
-<div {{ with $class }}class="{{ . }}"{{ else }}style="position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden;"{{ end }}>
+<div class="youtube-embedded {{ $class }}">
-  <iframe src="https://{{ $ytHost }}/embed/{{ $id }}?origin={{ .Site.BaseURL }}{{ with .Get "autoplay" }}{{ if eq . "true" }}&autoplay=1{{ end }}{{ end }}" {{ if not $class }}style="position: absolute; top: 0; left: 0; width: 100%; height: 100%; border:0;" {{ end }}allowfullscreen title="{{ $title }}"></iframe>
+  <iframe src="https://{{ $ytHost }}/embed/{{ $id }}?origin={{ .Site.BaseURL }}{{ with .Get "autoplay" }}{{ if eq . "true" }}&autoplay=1{{ end }}{{ end }}" allowfullscreen title="{{ $title }}"></iframe>
 </div>
 {{ end -}}

layouts/tags/list.html

@@ -1,31 +1,36 @@
 {{ define "main" }}
     {{- $page := . -}}
     {{- $layout := $page.Params.layout -}}
+    {{- $breakpoint := $.Scratch.Get "breakpoint" -}}
+    {{- $hasSidebar := site.Params.navigation.sidebar | default true -}}
 
     <div class="container-xxl flex-fill p-4 px-xxl-0">
-        <div class="row row-cols-1 row-cols-sm-3">
+        <div class="row row-cols-1 row-cols-{{ $breakpoint.prev }}-{{ if $hasSidebar }}3{{ else }}2{{ end }}">
-            <div class="col col-md-2 d-none d-md-block"></div>
+            {{ if $hasSidebar }}<div class="col col-{{ $breakpoint.current }}-2 d-none d-{{ $breakpoint.current }}-block"></div>{{ end }}
-            <div class="col col-sm-12 col-md-8">
+            <div class="col col-{{ $breakpoint.prev }}-12 col-{{ $breakpoint.current }}-8">
                 {{- if ne $layout "featured" -}}
                     {{ if and (not $page.IsHome) site.Params.navigation.breadcrumb }}
                         <div>{{ partial "assets/breadcrumb.html" $page }}</div>
                     {{ end -}}
                 {{- end -}}
 
-                <p class="display-4 mt-5">{{ .Name | humanize }}</p>
+                <p class="display-4 mt-5">{{ .Page.Title }}</p>
 
                 {{ if eq .Kind "taxonomy" }}
                     <div class="row mt-5"></div>
                     {{ range $.Site.Taxonomies.tags.ByCount }}
                         <div class="row mt-2">
-                            <div class="d-none d-sm-block col-sm-3 mt-auto text-right">
+                            <div class="col-3 mt-auto text-right">
                                 {{ .Count }} {{ if gt .Count 1 }} {{ T "articles" }} {{ else }} {{ T "article" }} {{ end }}
                             </div>
-                            <div class="col">
+                            <div class="col-9">
-                                <a href="{{ (path.Join .Page.RelPermalink) | relLangURL }}">{{ .Name | .Page.RenderString }}</a>
+                                <a href="{{ (path.Join .Page.RelPermalink) | relLangURL }}">{{ .Page.Title | .Page.RenderString }}</a>
                             </div>
                         </div>
                     {{ end }}
+                    {{ if eq $.Site.Taxonomies.tags 0 }}
+                        <p class="pt-4">{{- T "emptyTags" }}.</p>
+                    {{ end }}
                 {{ else }}
                     {{ $dateFormat := default "Jan 2" (index .Site.Params "date_format") }}
                     {{ $.Scratch.Set "lastYear" ""}}
@@ -33,7 +38,7 @@
                         {{ $year := .Date.Year }}
                         {{ $lastYear := $.Scratch.Get "lastYear"}}
                         <div class="row mt-2">
-                            <div class="d-none d-sm-block col-sm-3 mt-auto text-right">
+                            <div class="d-none d-{{ $breakpoint.prev }}-block col-{{ $breakpoint.prev }}-3 mt-auto text-right">
                                 <time class="post-date" datetime="{{ .Date.Format "2006-01-02T15:04:05Z07:00" | safeHTML }}">
                                     {{ (partial "utilities/date.html" (dict "date" .Date "format" "medium")) }}
                                 </time>
@@ -49,7 +54,7 @@
                     {{ end }}
                 {{ end }}
             </div>
-            <div class="col col-md-2 d-none d-md-block"></div>
+            <div class="col col-{{ $breakpoint.current }}-2 d-none d-{{ $breakpoint.current }}-block"></div>
         </div>
     </div>
 {{ end }}

netlify.toml

@@ -4,12 +4,12 @@
     command = "npm run build:example"
 
 [build.environment]
-    DART_SASS_VERSION = "1.69.0"
+    DART_SASS_VERSION = "1.69.5"
-    HUGO_VERSION = "0.119.0"
+    HUGO_VERSION = "0.121.0"
     HUGO_ENV = "production"
     HUGO_ENABLEGITINFO = "true"
-    NODE_VERSION = "18.18.2"
+    NODE_VERSION = "18.19.0"
-    NPM_VERSION = "9.8.1"
+    NPM_VERSION = "10.2.3"
 # toml-docs-end netlify
 
 [[headers]]

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gethinode/hinode",
-  "version": "0.21.0",
+  "version": "0.22.0-alpha2",
   "description": "Hinode is a clean documentation and blog theme for Hugo, an open-source static site generator",
   "keywords": [
     "hugo",
@@ -71,18 +71,18 @@
     "@gethinode/netlify-plugin-dartsass": "^0.2.0",
     "@netlify/plugin-lighthouse": "^5.0.0",
     "autoprefixer": "^10.4.16",
-    "cssnano": "^6.0.1",
+    "cssnano": "^6.0.2",
-    "cssnano-preset-advanced": "^6.0.1",
+    "cssnano-preset-advanced": "^6.0.2",
-    "eslint": "^8.52.0",
+    "eslint": "^8.56.0",
     "eslint-config-standard": "^17.1.0",
-    "eslint-plugin-import": "^2.29.0",
+    "eslint-plugin-import": "^2.29.1",
-    "eslint-plugin-n": "^16.2.0",
+    "eslint-plugin-n": "^16.5.0",
     "eslint-plugin-promise": "^6.1.1",
-    "hugo-bin": "^0.116.3",
+    "hugo-bin": "^0.117.1",
-    "markdownlint-cli2": "^0.10.0",
+    "markdownlint-cli2": "^0.11.0",
     "netlify-plugin-hugo-cache-resources": "^0.2.1",
     "npm-run-all": "^4.1.5",
-    "postcss-cli": "^10.1.0",
+    "postcss-cli": "^11.0.0",
     "purgecss-whitelister": "^2.4.0",
     "replace-in-files-cli": "^2.2.0",
     "rimraf": "^5.0.5",
@@ -91,7 +91,10 @@
     "stylelint-config-standard-scss": "^11.1.0"
   },
   "optionalDependencies": {
-    "fsevents": "*"
+    "@gethinode/netlify-plugin-dartsass": "^0.2.0",
+    "@netlify/plugin-lighthouse": "*",
+    "fsevents": "*",
+    "netlify-plugin-hugo-cache-resources": "^0.2.1"
   },
   "hugo-bin": {
     "buildTags": "extended"