Merge pull request #507 from gethinode/develop

Fix issues with table and link

.github/workflows/auto-merge.yml

@@ -16,27 +16,24 @@ jobs:
         uses: dependabot/fetch-metadata@v1
         with:
           github-token: "${{ secrets.GITHUB_TOKEN }}"
+
       - name: Enable auto-merge for Dependabot PRs
         run: gh pr merge --auto --merge "$PR_URL"
         env:
           PR_URL: ${{github.event.pull_request.html_url}}
           GITHUB_TOKEN: ${{secrets.GITHUB_TOKEN}}
+
       - name: Approve patch and minor updates
         if: ${{steps.dependabot-metadata.outputs.update-type == 'version-update:semver-patch' || steps.dependabot-metadata.outputs.update-type == 'version-update:semver-minor'}}
         run: gh pr review $PR_URL --approve -b "I'm **approving** this pull request because **it includes a patch or minor update**"
         env:
           PR_URL: ${{github.event.pull_request.html_url}}
           GITHUB_TOKEN: ${{secrets.GITHUB_TOKEN}}
-      - name: Approve major updates of development dependencies
+          
-        if: ${{steps.dependabot-metadata.outputs.update-type == 'version-update:semver-major' && steps.dependabot-metadata.outputs.dependency-type == 'direct:development'}}
+      - name: Comment on major updates of any dependencies
-        run: gh pr review $PR_URL --approve -b "I'm **approving** this pull request because **it includes a major update of a dependency used only in development**"
+        if: ${{steps.dependabot-metadata.outputs.update-type == 'version-update:semver-major'}}
-        env:
-          PR_URL: ${{github.event.pull_request.html_url}}
-          GITHUB_TOKEN: ${{secrets.GITHUB_TOKEN}}
-      - name: Comment on major updates of non-development dependencies
-        if: ${{steps.dependabot-metadata.outputs.update-type == 'version-update:semver-major' && steps.dependabot-metadata.outputs.dependency-type == 'direct:production'}}
         run: |
-          gh pr comment $PR_URL --body "I'm **not approving** this PR because **it includes a major update of a dependency used in production**"
+          gh pr comment $PR_URL --body "I'm **not approving** this PR because **it includes a major update of a dependency**"
           gh pr edit $PR_URL --add-label "requires-manual-qa"
         env:
           PR_URL: ${{github.event.pull_request.html_url}}

.github/workflows/build.yml

@@ -1,30 +0,0 @@
-name: build
-on:
-  push:
-    tags:
-      - v*
-    branches: [ main ]
-  pull_request:
-    branches: [ main ]
-
-jobs:
-  build:
-    strategy:
-      matrix:
-        os: [macos-latest, windows-latest, ubuntu-latest]
-        node-version: [16.x, 18.x, 20.x]
-        # See supported Node.js release schedule at https://nodejs.org/en/about/releases/
-
-    runs-on: ${{ matrix.os }}
-
-    steps:
-    - uses: actions/checkout@v3
-    - name: Use Node.js ${{ matrix.node-version }}
-      uses: actions/setup-node@v3
-      with:
-        node-version: ${{ matrix.node-version }}
-        cache: 'npm'
-        cache-dependency-path: '**/package-lock.json'
-    - run: npm ci
-    - run: npm run build
-    - run: npm run build:example

.github/workflows/lint-build.yml

@@ -0,0 +1,86 @@
+name: Lint & build
+on:
+  workflow_dispatch:
+  push:
+    tags:
+      - v*
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+env:
+  CACHE_KEY: 'hugo-hinode'
+  CACHE_PATH_DEBIAN: '/tmp/hugo_cache_runner'
+  CACHE_PATH_WIN: '~\AppData\Local\hugo_cache'
+  CACHE_PATH_MAC: '/Users/runner/Library/Caches/hugo_cache'
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Check out repository
+      uses: actions/checkout@v3
+
+    - name: Set up Node.js
+      uses: actions/setup-node@v3
+      with:
+        node-version: lts/*
+        cache: 'npm'
+        cache-dependency-path: '**/package-lock.json'
+
+    # [24/AUG/23] Adjusted from npm ci to prevent EBADPLATFORM error due to fsevents
+    - name: Install npm
+      run: npm i
+
+    - name: Lint the source files
+      run: npm run lint      
+
+  build:
+    needs: lint
+
+    strategy:
+      matrix:
+        os: [macos-latest, windows-latest, ubuntu-latest]
+        # See supported Node.js release schedule at https://nodejs.org/en/about/releases/
+        node-version: [16.x, 18.x, 20.x]
+
+    runs-on: ${{ matrix.os }}
+
+    steps:
+    - name: Check out repository
+      uses: actions/checkout@v3
+
+    - name: Set up Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v3
+      with:
+        node-version: ${{ matrix.node-version }}
+        cache: 'npm'
+        cache-dependency-path: '**/package-lock.json'
+
+    # [24/AUG/23] Adjusted from npm ci for non-macOS to prevent EBADPLATFORM error due to fsevents
+    - name: Perform clean install of npm
+      run:  |
+        if [ "$RUNNER_OS" == "macOS" ]; then
+          npm ci
+        else
+          npm i
+        fi
+      shell: bash
+
+    # Cache Hugo cachedir and resourcedir (configured in config/ci/hugo.toml) for each OS
+    # No additional cache invalidation is needed, Hugo uses checksums itself
+    - name: Use Hugo cache
+      uses: actions/cache@v3
+      with:
+        path: ${{ runner.os == 'Windows' && env.CACHE_PATH_WIN || runner.os == 'macOS' && env.CACHE_PATH_MAC || env.CACHE_PATH_DEBIAN }}
+        key: ${{ runner.os }}-${{ env.CACHE_KEY }}
+        restore-keys: |
+          ${{ runner.os }}-${{ env.CACHE_KEY }}
+
+    - name: Build main site
+      run: npm run build:cache
+
+    # The example site is to be published to demo.gethinode.com
+    - name: Build example site
+      run: npm run build:example:ci

.github/workflows/lint.yml

@@ -1,31 +0,0 @@
-name: lint
-on:
-  push:
-    tags:
-      - v*
-    branches: [ main ]
-  pull_request:
-    branches: [ main ]
-
-jobs:
-  build:
-
-    runs-on: ubuntu-latest
-
-    strategy:
-      matrix:
-        node-version: [16.x, 18.x, 20.x]
-        # See supported Node.js release schedule at https://nodejs.org/en/about/releases/
-
-    steps:
-    - uses: actions/checkout@v3
-
-    - name: Use Node.js ${{ matrix.node-version }}
-      uses: actions/setup-node@v3
-      with:
-        node-version: ${{ matrix.node-version }}
-        cache: 'npm'
-        cache-dependency-path: '**/package-lock.json'
-  
-    - run: npm ci --ignore-scripts
-    - run: npm run lint

.github/workflows/mod-update.yml

@@ -0,0 +1,62 @@
+name: Update Hugo dependencies
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: '0 3 * * *' # run daily at 03:00 AM
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  update-mod:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v3
+
+    - name: Setup Node.js
+      uses: actions/setup-node@v3
+      with:
+        node-version: lts/*
+        cache: 'npm'
+        cache-dependency-path: '**/package-lock.json'
+
+    # [26/AUG/23] Adjusted from npm ci to prevent EBADPLATFORM error due to fsevents
+    - name: Install npm
+      run: npm i
+
+    - name: Update Hugo module dependencies
+      id: mod-updates
+      run: |
+        MOD_OUTPUT=$(npm run mod:update 2>&1)
+        echo "$MOD_OUTPUT"
+        MOD_UPDATES=$(echo "$MOD_OUTPUT" | grep '^go: upgraded' | sed 's/go: / - /' | sort -u)
+        echo 'MOD_UPDATES<<EOF' >> $GITHUB_OUTPUT
+        echo "$MOD_UPDATES" >> "$GITHUB_OUTPUT"
+        echo 'EOF' >> $GITHUB_OUTPUT
+
+    - name: Create Pull Request
+      uses: gethinode-actions/create-pull-request@v5
+      with:
+        token: ${{ secrets.HUGO_MOD_PR }}
+        commit-message: 'fix: update Hugo module dependencies'
+        committer: GitHub <noreply@github.com>
+        branch: hugo-mod-dependencies
+        delete-branch: true
+        title: 'Update Hugo module dependencies'
+        body: |
+          This PR is auto-generated by [create-pull-request][1].
+          
+          Changes to go.mod:
+          
+          ${{ steps.mod-updates.outputs.MOD_UPDATES }}
+
+          [1]: https://github.com/peter-evans/create-pull-request
+        labels: dependencies
+        add-paths: |
+          go.mod
+          go.sum
+          **/go.mod
+          **/go.sum

.github/workflows/npm-publish.yml

@@ -1,35 +1,41 @@
-# This workflow will run tests using node and then publish a package to GitHub Packages when a release is created
+# This workflow will run tests using node and then publish a package to npmjs.org when a release is created
-# For more information see: https://help.github.com/actions/language-and-framework-guides/publishing-nodejs-packages
+# For more information see: https://docs.github.com/en/actions/publishing-packages/publishing-nodejs-packages
-
+name: Publish package to npmjs
-name: Node.js Package
 
 on:
   workflow_dispatch:
-    branches: [ main ]
   release:
-    types: [created]
+    types: [published]
+
+env:
+  REGISTRY_URL: 'https://registry.npmjs.org/'
 
 jobs:
   build:
-    runs-on: ubuntu-latest
+    strategy:
-    steps:
+      matrix:
-      - uses: actions/checkout@v3
+        os: [ubuntu-latest]
-      - uses: actions/setup-node@v3
+        node-version: [20.x]
-        with:
+
-          node-version: 16
+    runs-on: ${{ matrix.os }}
-      - run: npm ci
-      - run: npm test
 
-  publish-npm:
-    needs: build
-    runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - name: Checkout repository
-      - uses: actions/setup-node@v3
+        uses: actions/checkout@v3
+
+      - name: Setup .npmrc file to publish to npm
+        uses: actions/setup-node@v3
         with:
-          node-version: 16
+          node-version: ${{ matrix.node-version }}
-          registry-url: https://registry.npmjs.org/
+          registry-url: ${{ env.REGISTRY_URL }}
-      - run: npm ci
+          cache: 'npm'
-      - run: npm publish
+          cache-dependency-path: '**/package-lock.json'
+  
+      # [27/AUG/23] Adjusted from npm ci to prevent EBADPLATFORM error due to fsevents
+      - name: Install npm
+        run: npm i
+
+      - name: Publish package to npm
+        run: npm publish
         env:
-          NODE_AUTH_TOKEN: ${{secrets.npm_token}}
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.github/workflows/update.yml

@@ -1,37 +0,0 @@
-name: Update Hugo Dependencies
-on:
-  workflow_dispatch:
-  schedule:
-    - cron: '0 3 * * *' # run daily at 03:00 AM
-
-permissions:
-  pull-requests: write
-
-jobs:
-  update-dep:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v3
-        with:
-          fetch-depth: 0
-      - name: Set up Node.js
-        uses: actions/setup-node@v3
-        with:
-          node-version: "lts/*"
-      - name: Install dependencies
-        run: npm ci
-      - name: Update Hugo module dependencies
-        run: npm run mod:update
-      - name: Create Pull Request
-        uses: peter-evans/create-pull-request@v5
-        with:
-          token: ${{ secrets.HUGO_MOD_PR }}
-          commit-message: 'fix: update Hugo module dependencies'
-          branch: hugo-mod-dependencies
-          delete-branch: true
-          title: 'Update Hugo module dependencies'
-          body: >
-            This PR is auto-generated by 
-            [create-pull-request](https://github.com/peter-evans/create-pull-request).
-          labels: dependencies

.gitignore

@@ -4,5 +4,4 @@ resources/
 node_modules/
 
 .DS_store
-.hugo_build.lock
+.hugo_build.lock
-hugo_stats.json

.markdownlint-cli2.jsonc

@@ -4,7 +4,6 @@
     "MD013": false,
     "MD024": false,
     "MD026": false,
-    "MD033": false,
     "MD034": false,
     "MD051": false,
     "MD053": false

.stylelintignore

@@ -1,7 +1,6 @@
 assets/scss/common/_variables.scss
 assets/scss/components/_syntax-dark.scss
 assets/scss/components/_syntax-light.scss
-assets/scss/hotfix
 assets/scss/vendor
 assets/scss/theme/fonts.scss
 assets/scss/app.scss

README.md

@@ -1,5 +1,6 @@
 # Hugo Theme Hinode
 
+<!-- markdownlint-disable MD033 -->
 <!-- Tagline -->
 <p align="center">
     <b>A clean documentation and blog theme for your Hugo site based on Bootstrap 5</b>
@@ -47,6 +48,7 @@
   <a href="#donate">Donate</a> •
   <a href="#license">License</a>
 </p>
+<!-- markdownlint-enable MD033 -->
 
 ## About
 
@@ -56,54 +58,42 @@
 - [PageSpeed Insights][pagespeed]
 - [Mozilla Observatory][observatory]
 
-Hinode is a clean documentation and blog theme for [Hugo][hugo], an open-source static site generator. Based on the [Bootstrap 5][bootstrap] framework, the rendered site is fast, secure, and responsive. Hinode uses [FlexSearch][flexsearch] to enable full text search across your site. Finally, the theme supports [Node Package Manager][npm] to automate the build process and to keep track of dependencies.
+Hinode is a clean documentation and blog theme for [Hugo][hugo], an open-source static site generator. Based on the [Bootstrap 5][bootstrap] framework, the rendered site is fast, secure, and responsive. Hinode uses [FlexSearch][flexsearch] to enable full text search across your site. Finally, the theme supports [Node Package Manager][npm] (npm) to automate the build process and to keep track of dependencies.
-
-Additional features include:
-
-- Flexible configuration of Hugo modules
-- Switching between light mode and dark mode
-- Support for multiple languages
-- Reusable Bootstrap components through configurable shortcodes and partials
-- Embedded comments through light-weight integration with GitHub via [utteranc.es][utterances]
-- Integrated sidebar navigation for content-heavy sections, such as documentation pages
-- Reponsive image handling for multiple screen sizes and resolutions
-- Optimized search results, scoring 100 points for SEO on [PageSpeed Insights][pagespeed]
-- Secure by default, scoring A+ on [Mozilla Observatory test][observatory]
 
 Detailed information about Hinode is available on the [official website][website].
 
 ## Prerequisites
 
-Hinode requires Git, Node.js and npm for local development and testing. Download the Git binary from the [official website][git_download]. Next, download and install [Node.js][nodejs] (it includes npm) for your platform.
+Hinode is a [Hugo theme that uses modules][hugo_modules] to install and maintain various components. It can be installed using either Hugo or npm. If you would like to take advantage of automation, the npm approach is recommended. Refer to the [Hinode template][repository_template] for installation instructions with npm.
+
+The installation instructions in this readme install Hinode as a regular Hugo theme. Hinode requires the following software to be installed on your local machine.
+
+- [Go binary][golang_download]
+- [Hugo][nodejs] (extended version)
+
+[Git][git_download] is recommended, but is not a strict requirement.
 
 ## Installation
 
 Start a new Hinode project in three steps:
 
-1. Create a new site
+1. **Create a new site**
-
-    Hinode is available as a [template][repository_template], and a [main repository][repository]. The template [npm][npm] to link to the latest available version of Hinode. Unless you plan to customize a lot, it is recommended to use the template:
 
     ```bash
-    git clone https://github.com/gethinode/template.git my-hinode-site && cd my-hinode-site
+    hugo new site my-hinode-site && cd my-hinode-site
     ```
 
-    Use the main theme if you intend to customize the base code:
+1. **Initialize the module system**
 
     ```bash
-    git clone https://github.com/gethinode/hinode.git my-hinode-site && cd my-hinode-site
+    hugo mod init example.com/my-hinode-site
+    echo "[[module.imports]]\npath = 'github.com/gethinode/hinode'" >> hugo.toml
     ```
 
-1. Install dependencies
+1. **Start a development server**
 
     ```bash
-    npm install
+    hugo server
-    ```
-
-1. Start development server
-
-    ```bash
-    npm run start
     ```
 
 ## Configuration
@@ -123,11 +113,13 @@ Hinode is inspired by the following themes:
 
 ## Donate
 
+<!-- markdownlint-disable MD033 -->
 <a href="https://www.buymeacoffee.com/markdumay" target="_blank" rel="noopener noreferrer"><img src="https://cdn.buymeacoffee.com/buttons/lato-orange.png" alt="Buy Me A Coffee" style="height: 51px !important;width: 217px !important;"></a>
+<!-- markdownlint-enable MD033 -->
 
 ## License
 
-The `hinode` and `template` codebase is released under the [MIT license][license]. The documentation (including the "README" and `docs` codebase) is licensed under the Creative Commons [(CC BY-NC 4.0)][cc-by-nc-4.0] license.
+The `hinode`, `docs`, and `template` codebase is released under the [MIT license][license]. The documentation of Hinode is licensed under the Creative Commons [(CC BY-NC 4.0)][cc-by-nc-4.0] license. This includes all files within the repository's `/content` and `/exampleSite/content` folders and their children, as well as the "README" in the repository root. This applies to all public repositories maintained by `gethinode` on GitHub, including the `gethinode/hinode`, `gethinode/template`, and `gethinode/docs` repositories, unless specified otherwise.
 
 <!-- MARKDOWN PUBLIC LINKS -->
 [blist]: https://github.com/apvarun/blist-hugo-theme
@@ -137,6 +129,8 @@ The `hinode` and `template` codebase is released under the [MIT license][license
 [flexsearch]: https://github.com/nextapps-de/flexsearch
 [git_download]: https://git-scm.com
 [hugo]: https://gohugo.io
+[hugo_download]: https://gohugo.io/installation
+[hugo_modules]: https://gohugo.io/hugo-modules/
 [netlify]: https://www.netlify.com
 [nodejs]: https://nodejs.org
 [npm]: https://www.npmjs.com
@@ -147,6 +141,7 @@ The `hinode` and `template` codebase is released under the [MIT license][license
 <!-- MARKDOWN MAINTAINED LINKS -->
 [contribute]: https://gethinode.com/contribute
 [getstarted]: https://gethinode.com/docs
+[golang_download]: https://go.dev/dl/
 [demo]: https://demo.gethinode.com/
 [license]: https://github.com/gethinode/hinode/blob/main/LICENSE
 [repository]: https://github.com/gethinode/hinode.git

assets/js/critical/color.js

@@ -40,8 +40,7 @@
       })
 
       for (let i = 0; i < activeSelectors.length; ++i) {
-        activeSelectors[i].className = activeIcon.className
+        activeSelectors[i].innerHTML = activeIcon.innerHTML
-        activeSelectors[i].className = activeSelectors[i].className.replace('theme-icon', 'theme-icon-active')
       }
 
       for (let i = 0; i < activeButtons.length; ++i) {

assets/scss/app.scss

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

assets/scss/common/_variables-dark.scss

@@ -1,6 +1,7 @@
 @if $enable-dark-mode {
     @include color-mode(dark) {
         --bs-primary: #{$primary-text-emphasis-dark};
+        --bs-secondary: #{$secondary-text-emphasis-dark};
         --bs-primary-dark: #{$primary-bg-subtle-dark};
         --bs-primary-bg-subtle: #{$primary-bg-subtle-dark};
         --bg-primary-subtle: rgba(var(--bs-primary-rgb), var(--bs-link-opacity, 0.1));
@@ -29,7 +30,11 @@
         .form-range::-moz-range-thumb {
           background-color: var(--bs-primary);
         }
-                
+
+        .alert-primary {
+          --bs-alert-bg: var(--bg-primary-subtle);
+        }
+        
         .btn-outline-primary {
           --bs-btn-color: var(--bs-primary);
           --bs-btn-border-color: var(--bs-primary);
@@ -41,6 +46,17 @@
           --bs-btn-disabled-border-color: var(--bs-primary);
         }
         
+        .btn-outline-secondary {
+          --bs-btn-color: var(--bs-secondary);
+          --bs-btn-border-color: var(--bs-secondary);
+          --bs-btn-hover-bg: var(--bs-secondary);
+          --bs-btn-hover-border-color: var(--bs-secondary);
+          --bs-btn-active-bg: var(--bs-secondary);
+          --bs-btn-active-border-color: var(--bs-secondary);
+          --bs-btn-disabled-color: var(--bs-secondary);
+          --bs-btn-disabled-border-color: var(--bs-secondary);
+        }
+
         .link-primary {
           color: var(--bs-primary) if($enable-important-utilities, !important, null);
           text-decoration-color: var(--bs-primary) if($enable-important-utilities, !important, null);

assets/scss/common/_variables.scss

@@ -28,6 +28,7 @@ $carousel-dark-control-icon-filter:  invert(0) grayscale(100) !default;
 
 // scss-docs-start color-mode
 $primary-text-emphasis-dark:        mix(white, $primary, $dark-mode-tint) !default;
+$secondary-text-emphasis-dark:      mix(white, $secondary, $dark-mode-tint) !default;
 $link-color-dark:                   mix(white, $primary, $dark-mode-tint) !default;
 $primary-bg-subtle-dark:            mix(black, $primary, $dark-mode-shade) !default;
 $primary-border-subtle-dark:        mix(black, $primary, $dark-mode-shade / 2) !default;

assets/scss/components/_alert.scss

@@ -1,3 +1,18 @@
-.alert-no-decoration {
+.alert code {
-    --bs-alert-border-radius: none;
+    color: inherit;
 }
+
+/* stylelint-disable declaration-block-no-redundant-longhand-properties */
+.alert a {
+    color: inherit;
+    
+    &:link,
+    &:visited,
+    &:hover,
+    &:active {
+        text-decoration-line: underline;
+        text-decoration-style: dotted;
+        text-decoration-color: var(--bs-body);
+    }    
+}
+/* stylelint-enable declaration-block-no-redundant-longhand-properties */

assets/scss/components/_card.scss

@@ -48,6 +48,10 @@
     color: $body-color if($enable-important-utilities, !important, null);
 }
 
+.card-body-margin {
+    margin-bottom: $spacer * 1.5; // equals mb-4
+}
+
 @if $enable-dark-mode {
     @include color-mode(dark) {
         .card-body-link {

assets/scss/components/_sidebar.scss

@@ -69,24 +69,25 @@
 @if $enable-dark-mode {
     @include color-mode(dark) {
         .sidebar-item {
-            color: var(--bs-tertiary-color);
+            color: var(--bs-body-color);
             margin-left: 0 !important;
             padding-left: 0.85rem !important;
         
             &.active,
             &:hover,
             &:focus {
-                color: var(--bs-secondary-color);
+                color: white !important;
+                background-color: transparent;
             }
         }
 
         .btn-toggle {
-            color: var(--bs-tertiary-color);
+            color: var(--bs-body-color);
         
             &:hover,
             &:focus {
-                color: $secondary;
+                color: white !important;
-                background-color: tint-color($primary, 90%);
+                background-color: transparent;
             }
         
             &::before {
@@ -105,8 +106,8 @@
 
             &:hover,
             &:focus {
-                color: $secondary;
+                color: white !important;
-                background-color: tint-color($primary, 90%);
+                background-color: transparent;
             }
 
             &.active {

assets/scss/components/_syntax-dark.scss

@@ -6,9 +6,9 @@
 /* LineLink */ .chroma .lnlinks { outline: none; text-decoration: none; color: inherit }
 /* LineTableTD */ .chroma .lntd { vertical-align: top; padding: 0; margin: 0; border: 0; }
 /* LineTable */ .chroma .lntable { border-spacing: 0; padding: 0; margin: 0; border: 0; }
-/* LineHighlight */ .chroma .hl { background-color: #b8b800 }
+/* LineHighlight */ .chroma .hl { background-color: #373700 }
 /* LineNumbersTable */ .chroma .lnt { white-space: pre; -webkit-user-select: none; user-select: none; margin-right: 0.4em; padding: 0 0.4em 0 0.4em;color: #64686c }
-/* LineNumbers */ .chroma .ln { white-space: pre; -webkit-user-select: none; user-select: none; margin-right: 0.4em; padding: 0 0.4em 0 0.4em;color: #6e7681 }
+/* LineNumbers */ .chroma .ln { white-space: pre; -webkit-user-select: none; user-select: none; margin-right: 0.4em; padding: 0 0.4em 0 0.4em;color: #999fa8 }
 /* Line */ .chroma .line { display: flex; }
 /* Keyword */ .chroma .k { color: #ff7b72 }
 /* KeywordConstant */ .chroma .kc { color: #79c0ff }
@@ -83,4 +83,4 @@
 /* GenericSubheading */ .chroma .gu { color: #79c0ff }
 /* GenericTraceback */ .chroma .gt { color: #ff7b72 }
 /* GenericUnderline */ .chroma .gl { text-decoration: underline }
-/* TextWhitespace */ .chroma .w { color: #6e7681 }
+/* TextWhitespace */ .chroma .w { color: #999fa8 }

assets/scss/components/_syntax.scss

@@ -8,6 +8,14 @@
     background-color: transparent if($enable-important-utilities, !important, null);
 }
 
+.chroma {
+    display: flex;
+}
+
+.chroma code {
+    flex: 1;
+}
+
 .syntax-highlight {
     background-color: var(--bs-light) if($enable-important-utilities, !important, null);
     overflow-x: auto;
@@ -30,7 +38,10 @@
         }
 
         .bg,
-        .chroma {
+        .chroma,
+        .chroma .ge,
+        .chroma .gl,
+        .chroma .gs {
             color: #c9d1d9 if($enable-important-utilities, !important, null);
         }
     }

assets/scss/components/_table.scss

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

assets/scss/components/_timeline.scss

@@ -14,11 +14,7 @@ $semi-circle-border: 0.2rem;
     .timeline-#{$state} {
       --timeline-highlight: var(--#{$prefix}#{$state});
     }
-
+}
-    .timeline-bg-#{$state} {
-        --timeline-connector-bg: var(--#{$prefix}#{$state}-bg-subtle);
-      }
-  }
 
 // scss-docs-end timeline
 
@@ -27,10 +23,16 @@ $semi-circle-border: 0.2rem;
 }
 
 .timeline-sm {
-    --timeline-icon-radius: calc(#{$semi-circle-radius} / 2);
+    --timeline-icon-radius: calc(#{$semi-circle-radius} / 2.4);
     --timeline-offset: 25%
 }
 
+@include media-breakpoint-up(sm) {
+    .timeline-sm {
+        --timeline-icon-radius: calc(#{$semi-circle-radius} / 2);
+    }
+}
+  
 .timeline::before, .timeline-sm::before {
     content: "";
     width: 2 * $semi-circle-border;

assets/scss/components/_toc.scss

@@ -83,6 +83,10 @@
 
         .toc nav a {
             color: var(--bs-body-color);
+
+            &:hover {
+                color: white;
+            }
         }
     }
 }

config/_default/hugo.toml

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

config/_default/markup.toml

@@ -31,5 +31,5 @@ defaultMarkdownHandler = "goldmark"
         block = true
     [goldmark.renderer]
         hardWraps = false
-        unsafe = true
+        unsafe = false
         xhtml = false

config/_default/params.toml

@@ -27,6 +27,7 @@
 [debugging]
     showJS = false
     showSCSS = false
+    purgeHTMLComments = false
 # toml-docs-end debugging
 
 # toml-docs-start docs
@@ -55,6 +56,7 @@
     breadcrumb = true
     toc = true
     sidebar = true
+    size = "md"
 # toml-docs-end navigation
 
 # toml-docs-start messages
@@ -114,7 +116,7 @@
 #         header = "full"
 #         footer = "none"
 #         orientation = "stacked"
-#         style = "border-0 card-zoom"
+#         style = "border-0 card-zoom card-body-margin"
 #         homepage = 3
 #         separator = true
 # toml-docs-end sections

config/ci/hugo.toml

@@ -0,0 +1,23 @@
+# cachedir default on POSIX: '/tmp/hugo_cache_runner'
+# cachedir default on Windows: '~\AppData\Local\hugo_cache'
+# cachedir default on macOS: '/Users/runner/Library/Caches/hugo_cache'
+
+[caches]
+  [caches.assets]
+    dir = ':cacheDir/resources/_gen' # map to cacheDir instead of resourceDir to utilize GitHub action/cache
+    maxAge = -1
+  [caches.getcsv]
+    dir = ':cacheDir/:project'
+    maxAge = -1
+  [caches.getjson]
+    dir = ':cacheDir/:project'
+    maxAge = -1
+  [caches.getresource]
+    dir = ':cacheDir/:project'
+    maxAge = -1
+  [caches.images]
+    dir = ':cacheDir/resources/_gen' # map to cacheDir instead of resourceDir to utilize GitHub action/cache
+    maxAge = -1
+  [caches.modules]
+    dir = ':cacheDir/modules'
+    maxAge = -1

config/postcss.config.js

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

exampleSite/config/_default/hugo.toml

@@ -1,3 +1,4 @@
+resourcedir = '../resources/'
 title = "Hinode"
 copyright = "Copyright © 2023 Mark Dumay."
 paginate = 9

exampleSite/config/_default/markup.toml

@@ -31,5 +31,5 @@ defaultMarkdownHandler = "goldmark"
         block = true
     [goldmark.renderer]
         hardWraps = false
-        unsafe = true
+        unsafe = false
         xhtml = false

exampleSite/config/_default/params.toml

@@ -21,6 +21,7 @@
 [debugging]
     showJS = false
     showSCSS = false
+    purgeHTMLComments = true # prevents a Goldmark warning when processing HTML comments (as used by markdownlint)
 
 [docs]
     basePath = "/" # TODO: replace
@@ -44,6 +45,7 @@
     breadcrumb = true
     toc = true
     sidebar = true
+    size = "md"
 
 [messages]
     placement = "bottom-right"
@@ -96,7 +98,7 @@
         header = "full"
         footer = "none"
         orientation = "stacked"
-        style = "border-0 card-zoom"
+        style = "border-0 card-zoom card-body-margin"
         homepage = 3
         separator = true
     [sections.projects]
@@ -111,7 +113,7 @@
         padding = "3"
         header = "none"
         footer = "tags"
-        orientation = "horizontal"
+        orientation = "horizontal-sm"
         style = "border-1 card-emphasize"
         homepage = 3
         separator = false

exampleSite/config/ci/hugo.toml

@@ -0,0 +1,22 @@
+# cachedir default on POSIX: '/tmp/hugo_cache_runner'
+# cachedir default on Windows: '~\AppData\Local\hugo_cache'
+
+[caches]
+  [caches.assets]
+    dir = ':cacheDir/resources/_gen' # map to cacheDir instead of resourceDir to utilize GitHub action/cache
+    maxAge = -1
+  [caches.getcsv]
+    dir = ':cacheDir/:project'
+    maxAge = -1
+  [caches.getjson]
+    dir = ':cacheDir/:project'
+    maxAge = -1
+  [caches.getresource]
+    dir = ':cacheDir/:project'
+    maxAge = -1
+  [caches.images]
+    dir = ':cacheDir/resources/_gen' # map to cacheDir instead of resourceDir to utilize GitHub action/cache
+    maxAge = -1
+  [caches.modules]
+    dir = ':cacheDir/modules'
+    maxAge = -1

exampleSite/content/en/about.md

@@ -6,29 +6,19 @@ updated: 2023-08-02
 showComments: false
 ---
 
-<p class="text-center"><svg class="img-fluid w-50"><use href="/img/logo_var.svg#logo"></use></svg></p>
+{{< image src="/img/logo_var.svg#logo" class="img-fluid w-50" wrapper="text-center" >}}
 
-<section class="section section-sm mt-5 mb-5">
+{{< card-group class="text-center border-0" padding="3" >}}
-    <div class="container-fluid">
+    {{< card title="Bootstrap framework" icon="fab bootstrap" >}}
-        <div class="row justify-content-center text-center">
+        Build fast, responsive sites with Bootstrap 5. Easily customize your site with the source Sass files.
-            <div class="col-lg-4">
+    {{< /card >}}
-                {{< icon fab bootstrap fa-2xl >}}
+    {{< card title="Full text search" icon="fas magnifying-glass" >}}
-                <h2 class="h4">Bootstrap framework</h2>
+        Search your site with FlexSearch, a full-text search library with zero dependencies.
-                <p>Build fast, responsive sites with Bootstrap 5. Easily customize your site with the source Sass files.</p>
+    {{< /card >}}
-            </div>
+    {{< card title="Development tools" icon="fas code" >}}
-            <div class="col-lg-4">
+        Use Node Package Manager to automate the build process and to keep track of dependencies.
-                {{< icon fas magnifying-glass fa-2xl >}}
+    {{< /card >}}
-                <h2 class="h4">Full text search</h2>
+{{< /card-group >}}
-                <p>Search your site with FlexSearch, a full-text search library with zero dependencies.</p>
-            </div>
-            <div class="col-lg-4">
-                {{< icon fas code fa-2xl >}}
-                <h2 class="h4">Development tools</h2>
-                <p>Use Node Package Manager to automate the build process and to keep track of dependencies.</p>
-            </div>
-        </div>
-    </div>
-</section>
 
 Additional features include:
 

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

@@ -14,6 +14,16 @@ thumbnail:
 
 Hinode provides several shortcodes that wrap common Bootstrap components. Refer to the [official documentation]({{< param "links.hinode_docs" >}}) for more details.
 
+## Abbr
+
+As an example, the following shortcode displays the full text of an abbreviation on hover.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* abbr "CI/CD" */>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
 ## Accordion
 
 As an example, the following shortcode displays an accordion with three elements, of which the first element is expanded.
@@ -22,11 +32,11 @@ As an example, the following shortcode displays an accordion with three elements
 {{< example lang="hugo" >}}
 {{</* accordion */>}}
   {{</* accordion-item header="Accordion Item #1" show="true" */>}}
-    This is the first item's accordion body. It supports HTML content. The item is shown by adding the value
+    This is the first item's accordion body. It supports HTML content, if enabled in the goldmark
-    <code>show</code> to the <code>class</code> argument.
+    renderer. The item is shown by adding the value `show` to the `class` argument.
   {{</* /accordion-item */>}}
   {{</* accordion-item header="Accordion Item #2" */>}}
-    This is the second item's accordion body. It supports HTML content too.
+    This is the second item's accordion body.
   {{</* /accordion-item */>}}
   {{</* accordion-item header="Accordion Item #3" */>}}
     This is the third item's accordion body.
@@ -49,16 +59,29 @@ As an example, the following shortcode displays a simple alert.
 
 ## Badge
 
-Use HTML code to display a badge for a heading. See the Bootstrap [documentation]({{< param "links.bs_badge_heading" >}}) for more options.
+Use the badge shortcode to display a badge for a heading.
 
+<!-- markdownlint-disable MD037 -->
 {{< example >}}
-<h1>Example heading of size one <span class="badge bg-secondary">New</span></h1>
+Heading 1 {{</* badge title="New" */>}}
-<h2>Example heading of size two <span class="badge bg-secondary">New</span></h2>
+{.h1}
-<h3>Example heading of size three <span class="badge bg-secondary">New</span></h3>
+
-<h4>Example heading of size four <span class="badge bg-secondary">New</span></h4>
+Heading 2 {{</* badge title="New" */>}}
-<h5>Example heading of size five <span class="badge bg-secondary">New</span></h5>
+{.h2}
-<h6>Example heading of size six <span class="badge bg-secondary">New</span></h6>
+
+Heading 3 {{</* badge title="New" */>}}
+{.h3}
+
+Heading 4 {{</* badge title="New" */>}}
+{.h4}
+
+Heading 5 {{</* badge title="New" */>}}
+{.h5}
+
+Heading 6 {{</* badge title="New" */>}}
+{.h6}
 {{< /example >}}
+<!-- markdownlint-enable MD037 -->
 
 ## Breadcrumb
 
@@ -102,7 +125,28 @@ As an example, the following shortcode displays a stacked card that links to the
 
 <!-- markdownlint-disable MD037 -->
 {{< example lang="hugo" >}}
-{{</* card path="about" padding="3" class="w-50" color="body-tertiary" header="publication" footer="none" */>}}
+{{</* card path="about" padding="3" class="col-6 mx-auto" color="body-tertiary" header="publication" footer="none" /*/>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+## Card group
+
+As an example, the following shortcode displays a card group of three elements.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* card-group padding="3" gutter="3" */>}}
+    {{</* card title="Bootstrap framework" icon="fab bootstrap" */>}}
+        Build fast, responsive sites with Bootstrap 5. Easily customize your site with the source
+        Sass files.
+    {{</* /card */>}}
+    {{</* card title="Full text search" icon="fas magnifying-glass" */>}}
+        Search your site with FlexSearch, a full-text search library with zero dependencies.
+    {{</* /card */>}}
+    {{</* card title="Development tools" icon="fas code" */>}}
+        Use Node Package Manager to automate the build process and to keep track of dependencies.
+    {{</* /card */>}}
+{{</* /card-group */>}}
 {{< /example >}}
 <!-- markdownlint-enable MD037 -->
 
@@ -131,7 +175,7 @@ As an example, the following shortcode displays a button that, when clicked, tri
 {{</* /button */>}}
 
 {{</* collapse id="collapse-1" class="p-3 border rounded bg-primary-subtle" */>}}
-    Some placeholder content for the collapse component. This panel is <i>hidden by default</i> but
+    Some placeholder content for the collapse component. This panel is *hidden by default* but
     revealed when the user activates the relevant trigger.
 {{</* /collapse */>}}
 {{< /example >}}
@@ -217,6 +261,57 @@ As an example, the following shortcode displays an image with rounded corners an
 {{< /example >}}
 <!-- markdownlint-enable MD037 -->
 
+As an example, the following shortcode displays a regular vector image.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* image src="/img/logo_icon.svg" class="col-sm-6 col-lg-4" wrapper="text-center" */>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+As an example, the following shortcode displays a vector image with a symbol reference.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+{{</* image src="/img/logo_var.svg#logo" class="col-sm-6 col-lg-4" wrapper="text-center" */>}}
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+## Link
+
+As an example, the following shortcodes render links in different formats.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+
+- {{</* link hinode >}}Named link with default settings{{< /link */>}}
+- {{</* link name=hinode cue=false tab=false >}}Named link opening in current tab w/o icon{{< /link */>}}
+- {{</* link name=hinode cue=true tab=true >}}Named link opening in new tab with icon{{< /link */>}}
+- {{</* link hinode /*/>}}
+- {{</* link href="https://developer.mozilla.org" >}}External link{{< /link */>}}
+- {{</* link "./projects/another-project" >}}Internal link with title{{< /link */>}}
+- {{</* link url="projects/another-project" /*/>}}
+- {{</* link url="/projects/another-project" /*/>}}
+- {{</* link url="../projects/another-project" case=false /*/>}}
+- {{</* link "/about/" /*/>}}
+- {{</* link "/fr/about/" /*/>}}
+- {{</* link "/fr/about" >}}About (French){{< /link */>}}
+- {{</* link "#image" /*/>}}
+- {{</* link "components/#map" /*/>}}
+
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+## Mark
+
+Use the `mark` shortcode to highlight text. The inner content is used as input.
+
+<!-- markdownlint-disable MD037 -->
+{{< example lang="hugo" >}}
+Use the mark shortcode to {{</* mark >}}highlight{{< /mark */>}} specific text.
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
 ## Nav
 
 As an example, the following shortcode displays a tab group with vertically aligned pills.
@@ -225,11 +320,11 @@ As an example, the following shortcode displays a tab group with vertically alig
 {{< example lang="hugo" >}}
   {{</* nav type="pills" vertical="true" */>}}
     {{</* nav-item header="Nav Item #1" show="true" */>}}
-      This is the first item's nav body. It supports HTML content. The item is shown by adding the value
+      This is the first item's nav body. It supports HTML content, if enabled in the goldmark
-      <code>show</code> to the <code>class</code> argument.
+      renderer. The item is shown by adding the value `show` to the `class` argument.
     {{</* /nav-item */>}}
     {{</* nav-item header="Nav Item #2" */>}}
-      This is the second item's nav body. It too supports HTML content.
+      This is the second item's nav body.
     {{</* /nav-item */>}}
     {{</* nav-item header="Nav Item #3" */>}}
       This is the third item's nav body.
@@ -270,13 +365,33 @@ Loading...
 {{< /example>}}
 <!-- markdownlint-enable MD037 -->
 
+## Sub
+
+As an example, the following shortcode displays subscript text.
+
+<!-- markdownlint-disable MD037 -->
+{{< example >}}
+H{{</* sub 2 */>}}O is a liquid.
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
+## Sup
+
+As an example, the following shortcode displays superscript text.
+
+<!-- markdownlint-disable MD037 -->
+{{< example >}}
+2{{</* sup 10 */>}} is 1024.
+{{< /example >}}
+<!-- markdownlint-enable MD037 -->
+
 ## Timeline
 
-As an example, the following shortcode displays a timeline with the file `data/timeline-en.yml` as data.
+As an example, the following shortcode displays a timeline with the file `data/timeline.en.yml` as data.
 
 <!-- markdownlint-disable MD037 -->
 {{< example lang="hugo" >}}
-{{</* timeline data="timeline-en" background="dark" */>}}
+{{</* timeline data="timeline" background="dark" */>}}
 {{< /example >}}
 <!-- markdownlint-enable MD037 -->
 
@@ -295,11 +410,11 @@ As an example, the following shortcode displays a button that, when clicked, tri
 {{</* /button */>}}
 
 {{</* toast id="toast-example-1" header="First title" */>}}
-    This is the first toast message.
+    This is the first toast message. It supports `markdown.`
 {{</* /toast */>}}
 
 {{</* toast id="toast-example-2" header="Second title" */>}}
-    This is the second toast message.
+    This is the second toast message. It supports `markdown.`
 {{</* /toast */>}}
 {{< /example >}}
 <!-- markdownlint-enable MD037 -->
@@ -310,6 +425,6 @@ As an example, the following shortcode displays a tooltip for a colored hyperlin
 
 <!-- markdownlint-disable MD037 -->
 {{< example lang="hugo" >}}
-{{</* tooltip color="primary" title="Tooltip" href="#!" */>}}Tooltip{{</* /tooltip */>}} demonstration
+{{</* tooltip color="primary" title="Tooltip caption" href="#!" */>}}Tooltip{{</* /tooltip */>}} demonstration
 {{< /example >}}
 <!-- markdownlint-enable MD037 -->

exampleSite/content/fr/about.md

@@ -7,30 +7,19 @@ updated: 2023-08-02
 showComments: false
 ---
 
-<p class="text-center"><svg class="img-fluid w-50"><use href="/img/logo_var.svg#logo"></use></svg></p>
+{{< image src="/img/logo_var.svg#logo" class="img-fluid w-50" wrapper="text-center" >}}
 
-<section class="section section-sm mt-5">
+{{< card-group class="text-center border-0" padding="3" >}}
-  <div class="container-fluid">
+    {{< card title="Framework Bootstrap" icon="fab bootstrap" >}}
-    <div class="row justify-content-center text-center">
+        Créez des sites rapides et réactifs avec Bootstrap 5. Personnalisez facilement votre site avec les fichiers source Sass.
-    <div class="row justify-content-center text-center">
+    {{< /card >}}
-      <div class="col-lg-4">
+    {{< card title="Recherche en texte intégral" icon="fas magnifying-glass" >}}
-        {{< icon fab bootstrap fa-2xl >}}
+        Recherchez votre site avec FlexSearch, une bibliothèque de recherche en texte intégral avec zéro dépendances.
-        <h2 class="h4">Framework Bootstrap</h2>
+    {{< /card >}}
-        <p>Créez des sites rapides et réactifs avec Bootstrap 5. Personnalisez facilement votre site avec les fichiers source Sass.</p>
+    {{< card title="Outils de développement" icon="fas code" >}}
-      </div>
+        Utilisez Node Package Manager pour automatiser le processus de construction et suivre les dépendances.
-      <div class="col-lg-4">
+    {{< /card >}}
-        {{< icon fas magnifying-glass fa-2xl >}}
+{{< /card-group >}}
-        <h2 class="h4">Recherche en texte intégral</h2>
-        <p>Recherchez votre site avec FlexSearch, une bibliothèque de recherche en texte intégral avec zéro dépendances.</p>
-      </div>
-      <div class="col-lg-4">
-        {{< icon fas code fa-2xl >}}
-        <h2 class="h4">Outils de développement</h2>
-        <p>Utilisez Node Package Manager pour automatiser le processus de construction et suivre les dépendances.</p>
-      </div>
-    </div>
-  </div>
-</section>
 
 Les fonctionnalités supplémentaires incluent:
 

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

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

exampleSite/content/fr/blog/components.md

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

exampleSite/content/nl/about.md

@@ -7,30 +7,20 @@ updated: 2023-08-02
 showComments: false
 ---
 
-<p class="text-center"><svg class="img-fluid w-50"><use href="/img/logo_var.svg#logo"></use></svg></p>
 
-<section class="section section-sm mt-5">
+{{< image src="/img/logo_var.svg#logo" class="img-fluid w-50" wrapper="text-center" >}}
-  <div class="container-fluid">
+
-    <div class="row justify-content-center text-center">
+{{< card-group class="text-center border-0" padding="3" >}}
-    <div class="row justify-content-center text-center">
+    {{< card title="Bootstrap raamwerk" icon="fab bootstrap" >}}
-      <div class="col-lg-4">
+        Bouw snelle websites geschikt voor mobiele en desktop schermen met Bootstrap 5. Pas de site eenvoudig aan met bronbestanden in Sass.
-        {{< icon fab bootstrap fa-2xl >}}
+    {{< /card >}}
-        <h2 class="h4">Bootstrap raamwerk</h2>
+    {{< card title="Volledig doorzoekbaar" icon="fas magnifying-glass" >}}
-        <p>Bouw snelle websites geschikt voor mobiele en desktop schermen met Bootstrap 5. Pas de site eenvoudig aan met bronbestanden in Sass.</p>
+        Doorzoek je site met FlexSearch, een software bibliotheek zonder afhankelijkheden.
-      </div>
+    {{< /card >}}
-      <div class="col-lg-4">
+    {{< card title="Ontwikkelgereedschap" icon="fas code" >}}
-        {{< icon fas magnifying-glass fa-2xl >}}
+        Gebruik Node Package Manager om het bouwproces inclusief versiebeheer volledig te automatiseren.
-        <h2 class="h4">Volledig doorzoekbaar</h2>
+    {{< /card >}}
-        <p>Doorzoek je site met FlexSearch, een software bibliotheek zonder afhankelijkheden.</p>
+{{< /card-group >}}
-      </div>
-      <div class="col-lg-4">
-        {{< icon fas code fa-2xl >}}
-        <h2 class="h4">Ontwikkelgereedschap</h2>
-        <p>Gebruik Node Package Manager om het bouwproces inclusief versiebeheer volledig te automatiseren.</p>
-      </div>
-    </div>
-  </div>
-</section>
 
 Overige functies:
 

exampleSite/data/abbr.yml

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

exampleSite/data/timeline-fr.yml

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

exampleSite/go.mod

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

exampleSite/go.sum

@@ -4,10 +4,17 @@ github.com/gethinode/mod-flexsearch v1.2.0 h1:SSMpWzK9SMbi9QRYfil9PJZLLWWLHWzlTc
 github.com/gethinode/mod-flexsearch v1.2.0/go.mod h1:TXbGbWsvmhBdsTzRt887mcpFfr4ORpzG3+h/l4W3YM4=
 github.com/gethinode/mod-flexsearch v1.3.0 h1:RbfEDw219Y1rOVp9lHmy5ePdF9lyPalDu2J5oVeejrU=
 github.com/gethinode/mod-flexsearch v1.3.0/go.mod h1:TXbGbWsvmhBdsTzRt887mcpFfr4ORpzG3+h/l4W3YM4=
+github.com/gethinode/mod-flexsearch v1.4.0 h1:5e/NVRLyWzUZ9fO/fNsM5o+O7nw+xyln2rfEOtbgfWc=
+github.com/gethinode/mod-flexsearch v1.4.0/go.mod h1:TXbGbWsvmhBdsTzRt887mcpFfr4ORpzG3+h/l4W3YM4=
 github.com/gethinode/mod-fontawesome v1.2.4 h1:SqE3CQ+boaBIhrVh3MPu4nz0uoHPfEH5t60nNY1CfsI=
 github.com/gethinode/mod-fontawesome v1.2.4/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
 github.com/gethinode/mod-fontawesome v1.2.5 h1:RqkLRj6+s+gM4nKd0IwNMMDA8cRmxfp0fxkVH4FdAGU=
 github.com/gethinode/mod-fontawesome v1.2.5/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
+github.com/gethinode/mod-fontawesome v1.3.0 h1:oudeDBlAKu8vqYxumWuq5SG5F5itm33NgTrBLgvPulQ=
+github.com/gethinode/mod-fontawesome v1.3.0/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
+github.com/gethinode/mod-fontawesome v1.3.1 h1:EdnBuG2B+bi06OcYmcL1NfSxHpRMEGu8TXUqEEpVH4g=
+github.com/gethinode/mod-fontawesome v1.3.1/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
+github.com/gethinode/mod-katex v1.0.1/go.mod h1:byAfpI3wuqNJIooTGVEGc1cjBhhCy4+CcK1H6495MYg=
 github.com/gethinode/mod-katex v1.0.2 h1:pIG4n3qLl/IVe7BEiwn+GL8r5lOCtF6FDxlcrPKdAXk=
 github.com/gethinode/mod-katex v1.0.2/go.mod h1:byAfpI3wuqNJIooTGVEGc1cjBhhCy4+CcK1H6495MYg=
 github.com/gethinode/mod-leaflet v0.3.4 h1:oY+YQ0JiJuhFQNrk9XgFdg0NMsTUQPXNfnILp4ia4r4=

exampleSite/hugo_stats.json

@@ -0,0 +1,495 @@
+{
+  "htmlElements": {
+    "tags": [
+      "a",
+      "abbr",
+      "body",
+      "br",
+      "button",
+      "code",
+      "div",
+      "em",
+      "figcaption",
+      "figure",
+      "footer",
+      "form",
+      "h2",
+      "head",
+      "hr",
+      "html",
+      "i",
+      "img",
+      "input",
+      "li",
+      "link",
+      "mark",
+      "meta",
+      "nav",
+      "nil",
+      "noscript",
+      "ol",
+      "p",
+      "path",
+      "pre",
+      "script",
+      "small",
+      "span",
+      "strong",
+      "sub",
+      "sup",
+      "svg",
+      "time",
+      "title",
+      "ul",
+      "use"
+    ],
+    "classes": [
+      "accordion",
+      "accordion-body",
+      "accordion-button",
+      "accordion-collapse",
+      "accordion-header",
+      "accordion-item",
+      "active",
+      "alert",
+      "alert-danger",
+      "alert-dismissible",
+      "align-content-center",
+      "align-items-center",
+      "align-items-end",
+      "align-items-start",
+      "align-middle",
+      "align-self-center",
+      "anchor",
+      "badge",
+      "bg-body",
+      "bg-body-tertiary",
+      "bg-danger",
+      "bg-info",
+      "bg-opacity-10",
+      "bg-primary",
+      "bg-primary-subtle",
+      "border",
+      "border-0",
+      "border-1",
+      "border-bottom",
+      "border-end",
+      "border-none",
+      "border-start",
+      "border-top",
+      "bottom-0",
+      "bottom-bar",
+      "breadcrumb",
+      "breadcrumb-item",
+      "btn",
+      "btn-close",
+      "btn-group",
+      "btn-light",
+      "btn-outline-primary",
+      "btn-outline-secondary",
+      "btn-primary",
+      "btn-secondary",
+      "btn-sm",
+      "btn-social",
+      "card",
+      "card-body",
+      "card-body-link",
+      "card-body-margin",
+      "card-emphasize",
+      "card-img-top",
+      "card-img-wrap",
+      "card-text",
+      "card-title",
+      "card-zoom",
+      "carousel",
+      "carousel-caption",
+      "carousel-control-next",
+      "carousel-control-next-icon",
+      "carousel-control-prev",
+      "carousel-control-prev-icon",
+      "carousel-indicators",
+      "carousel-inner",
+      "carousel-item",
+      "chroma",
+      "col",
+      "col-12",
+      "col-3",
+      "col-4",
+      "col-6",
+      "col-8",
+      "col-9",
+      "col-lg-2",
+      "col-lg-4",
+      "col-lg-8",
+      "col-md-10",
+      "col-md-2",
+      "col-md-4",
+      "col-md-8",
+      "col-md-auto",
+      "col-sm-12",
+      "col-sm-3",
+      "col-sm-6",
+      "collapse",
+      "collapsed",
+      "container",
+      "container-fluid",
+      "container-xxl",
+      "d-block",
+      "d-flex",
+      "d-grid",
+      "d-inline",
+      "d-inline-flex",
+      "d-lg-block",
+      "d-md-block",
+      "d-md-flex",
+      "d-md-none",
+      "d-none",
+      "d-none-dark",
+      "d-none-light",
+      "d-sm-block",
+      "d-sm-none",
+      "display-1",
+      "display-4",
+      "dropdown",
+      "dropdown-divider-bg",
+      "dropdown-item",
+      "dropdown-menu",
+      "dropdown-menu-end",
+      "dropdown-toggle",
+      "emphasis",
+      "emphasis-dark",
+      "end-0",
+      "fa",
+      "fa-10x",
+      "fa-2x",
+      "fa-2xs",
+      "fa-4x",
+      "fa-arrow-left",
+      "fa-arrow-right",
+      "fa-bootstrap",
+      "fa-circle-check",
+      "fa-circle-half-stroke",
+      "fa-code",
+      "fa-docker",
+      "fa-ellipsis",
+      "fa-face-frown",
+      "fa-facebook",
+      "fa-fluid",
+      "fa-fw",
+      "fa-github",
+      "fa-globe",
+      "fa-heart",
+      "fa-house",
+      "fa-link",
+      "fa-linkedin",
+      "fa-magnifying-glass",
+      "fa-medium",
+      "fa-moon",
+      "fa-rocket",
+      "fa-share-nodes",
+      "fa-sort",
+      "fa-square-check",
+      "fa-sun",
+      "fa-up-right-from-square",
+      "fa-whatsapp",
+      "fa-wrapper",
+      "fa-x-twitter",
+      "fab",
+      "fade",
+      "fas",
+      "feature",
+      "figure-caption",
+      "fixed-top",
+      "flex-column",
+      "flex-fill",
+      "flex-grow-1",
+      "flex-wrap",
+      "font-monospace",
+      "footer",
+      "form-control",
+      "fs-3",
+      "fs-5",
+      "fw-30",
+      "fw-bold",
+      "fw-semibold",
+      "g-0",
+      "g-3",
+      "g-4",
+      "gap-2",
+      "gap-3",
+      "gradient",
+      "h-100",
+      "h1",
+      "h2",
+      "h3",
+      "h4",
+      "h5",
+      "h6",
+      "heading",
+      "highlight",
+      "hstack",
+      "img-fluid",
+      "img-wrap",
+      "invisible",
+      "is-search",
+      "justify-content-between",
+      "justify-content-center",
+      "justify-content-end",
+      "justify-content-start",
+      "lead",
+      "leaflet-map",
+      "link-bg-body",
+      "link-bg-body-tertiary",
+      "link-bg-footer",
+      "link-primary",
+      "link-secondary",
+      "link-success",
+      "link-warning",
+      "m-0",
+      "main-nav-toggler",
+      "mb-0",
+      "mb-3",
+      "mb-4",
+      "mb-5",
+      "mb-lg-5",
+      "me-3",
+      "me-auto",
+      "middle-bar",
+      "min-vh-100",
+      "ms-1",
+      "ms-3",
+      "ms-auto",
+      "ms-md-3",
+      "mt-2",
+      "mt-3",
+      "mt-5",
+      "mt-auto",
+      "multi-docs-collapse-15",
+      "multi-file-collapse-1",
+      "mx-auto",
+      "mx-md-2",
+      "my-2",
+      "my-auto",
+      "my-md-0",
+      "nav",
+      "nav-item",
+      "nav-link",
+      "nav-pills",
+      "nav-tabs",
+      "navbar",
+      "navbar-brand",
+      "navbar-collapse",
+      "navbar-contrast",
+      "navbar-expand-md",
+      "navbar-nav",
+      "navbar-nav-scroll",
+      "navbar-toggler",
+      "next",
+      "no-js",
+      "order-1",
+      "order-2",
+      "order-3",
+      "order-4",
+      "order-first",
+      "order-sm-2",
+      "order-sm-3",
+      "p-0",
+      "p-1",
+      "p-2",
+      "p-3",
+      "p-4",
+      "pb-2",
+      "pb-3",
+      "pb-5",
+      "pe-3",
+      "position-absolute",
+      "position-fixed",
+      "position-relative",
+      "post-date",
+      "previous",
+      "ps-1",
+      "ps-3",
+      "ps-xl-3",
+      "px-3",
+      "px-4",
+      "px-xxl-0",
+      "py-1",
+      "py-2",
+      "py-3",
+      "py-5",
+      "py-md-1",
+      "ratio",
+      "ratio-16x9",
+      "rounded",
+      "rounded-2",
+      "rounded-bottom",
+      "rounded-pill",
+      "rounded-top",
+      "row",
+      "row-cols-1",
+      "row-cols-2",
+      "row-cols-md-3",
+      "row-cols-sm-2",
+      "row-cols-sm-3",
+      "row-cols-sm-4",
+      "search",
+      "search-input",
+      "search-suggestions",
+      "shadow",
+      "show",
+      "slide",
+      "small",
+      "spinner-border",
+      "start-100",
+      "sticky-top",
+      "stretched-link",
+      "svg-inline--fa",
+      "switch-mode-collapsed",
+      "syntax-highlight",
+      "tab-content",
+      "tab-pane",
+      "tag-link",
+      "text-bg-body",
+      "text-bg-body-tertiary",
+      "text-bg-info",
+      "text-bg-primary",
+      "text-bg-secondary",
+      "text-bg-success",
+      "text-bg-warning",
+      "text-body",
+      "text-body-secondary",
+      "text-break",
+      "text-center",
+      "text-decoration-none",
+      "text-end",
+      "text-info",
+      "text-nowrap",
+      "text-right",
+      "text-secondary",
+      "text-sm-start",
+      "text-uppercase",
+      "theme-icon",
+      "theme-icon-active",
+      "tickmark",
+      "timeline",
+      "timeline-bg-dark",
+      "timeline-connector-end",
+      "timeline-connector-start",
+      "timeline-description-text-end",
+      "timeline-description-text-start",
+      "timeline-dot",
+      "timeline-info",
+      "timeline-panel-end",
+      "timeline-panel-start",
+      "timeline-primary",
+      "timeline-semi-circle-end",
+      "timeline-semi-circle-start",
+      "timeline-sm",
+      "timeline-success",
+      "timeline-warning",
+      "toast",
+      "toast-body",
+      "toast-container",
+      "toast-header",
+      "toc",
+      "toc-button",
+      "toc-panel",
+      "toc-sidebar",
+      "toggler-icon",
+      "top-0",
+      "top-bar",
+      "translate-middle",
+      "visually-hidden",
+      "vr",
+      "w-100",
+      "w-50"
+    ],
+    "ids": [
+      "-theme",
+      "-theme-collapsed",
+      "TableOfContents",
+      "abbr",
+      "accordion",
+      "accordion-0",
+      "accordion-0-heading-0",
+      "accordion-0-heading-1",
+      "accordion-0-heading-2",
+      "accordion-0-item-0",
+      "accordion-0-item-1",
+      "accordion-0-item-2",
+      "accordéon",
+      "alert",
+      "alerte",
+      "badge",
+      "barre-de-navigation",
+      "body-docs-collapse-15",
+      "body-file-collapse-1",
+      "bouton",
+      "breadcrumb",
+      "btn-webshare",
+      "button",
+      "button-group",
+      "card",
+      "card-group",
+      "carousel",
+      "carousel-0",
+      "carrousel",
+      "carte",
+      "chronologie",
+      "collapse",
+      "collapse-1",
+      "command-prompt",
+      "docs",
+      "documentation",
+      "example",
+      "exemple",
+      "fichier",
+      "fil-dariane",
+      "file",
+      "footer-docs-collapse-15",
+      "footer-file-collapse-1",
+      "formula-katex",
+      "formule-katex",
+      "groupe-de-boutons",
+      "groupe-de-cartes",
+      "icon",
+      "image",
+      "indicateur-de-chargement",
+      "infobulle",
+      "invite-de-commandes",
+      "leaflet-map-0",
+      "lien",
+      "link",
+      "map",
+      "mark",
+      "nav",
+      "nav-0",
+      "nav-0-0",
+      "nav-0-1",
+      "nav-0-2",
+      "nav-0-btn-0",
+      "nav-0-btn-1",
+      "nav-0-btn-2",
+      "navbar",
+      "navbar-0-collapse",
+      "navbar-sample-collapse",
+      "navigation",
+      "notification",
+      "publication",
+      "release",
+      "réduire",
+      "spinner",
+      "sub",
+      "sup",
+      "timeline",
+      "toast",
+      "toast-container",
+      "toast-copied-code-message",
+      "toast-example-1",
+      "toast-example-2",
+      "toast-message-email-4",
+      "toc-collapse",
+      "tooltip"
+    ]
+  }
+}

go.mod

@@ -4,8 +4,8 @@ go 1.19
 
 require (
 	github.com/gethinode/mod-bootstrap v1.1.1 // indirect
-	github.com/gethinode/mod-flexsearch v1.3.0 // indirect
+	github.com/gethinode/mod-flexsearch v1.4.0 // indirect
-	github.com/gethinode/mod-fontawesome v1.2.5 // indirect
+	github.com/gethinode/mod-fontawesome v1.3.1 // indirect
 	github.com/gethinode/mod-katex v1.0.2 // indirect
 	github.com/gethinode/mod-leaflet v0.3.4 // indirect
 )

go.sum

@@ -20,6 +20,8 @@ github.com/gethinode/mod-flexsearch v1.2.0 h1:SSMpWzK9SMbi9QRYfil9PJZLLWWLHWzlTc
 github.com/gethinode/mod-flexsearch v1.2.0/go.mod h1:TXbGbWsvmhBdsTzRt887mcpFfr4ORpzG3+h/l4W3YM4=
 github.com/gethinode/mod-flexsearch v1.3.0 h1:RbfEDw219Y1rOVp9lHmy5ePdF9lyPalDu2J5oVeejrU=
 github.com/gethinode/mod-flexsearch v1.3.0/go.mod h1:TXbGbWsvmhBdsTzRt887mcpFfr4ORpzG3+h/l4W3YM4=
+github.com/gethinode/mod-flexsearch v1.4.0 h1:5e/NVRLyWzUZ9fO/fNsM5o+O7nw+xyln2rfEOtbgfWc=
+github.com/gethinode/mod-flexsearch v1.4.0/go.mod h1:TXbGbWsvmhBdsTzRt887mcpFfr4ORpzG3+h/l4W3YM4=
 github.com/gethinode/mod-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=
@@ -36,6 +38,10 @@ github.com/gethinode/mod-fontawesome v1.2.4 h1:SqE3CQ+boaBIhrVh3MPu4nz0uoHPfEH5t
 github.com/gethinode/mod-fontawesome v1.2.4/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
 github.com/gethinode/mod-fontawesome v1.2.5 h1:RqkLRj6+s+gM4nKd0IwNMMDA8cRmxfp0fxkVH4FdAGU=
 github.com/gethinode/mod-fontawesome v1.2.5/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
+github.com/gethinode/mod-fontawesome v1.3.0 h1:oudeDBlAKu8vqYxumWuq5SG5F5itm33NgTrBLgvPulQ=
+github.com/gethinode/mod-fontawesome v1.3.0/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
+github.com/gethinode/mod-fontawesome v1.3.1 h1:EdnBuG2B+bi06OcYmcL1NfSxHpRMEGu8TXUqEEpVH4g=
+github.com/gethinode/mod-fontawesome v1.3.1/go.mod h1:Ki1qkWEOiF0hQpCgWeZRw+HkpL6nd1DxKFptU0O2feI=
 github.com/gethinode/mod-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=

hugo_stats.json

@@ -0,0 +1,186 @@
+{
+  "htmlElements": {
+    "tags": [
+      "a",
+      "body",
+      "button",
+      "div",
+      "footer",
+      "form",
+      "head",
+      "hr",
+      "html",
+      "img",
+      "input",
+      "li",
+      "link",
+      "meta",
+      "nav",
+      "p",
+      "path",
+      "script",
+      "small",
+      "span",
+      "strong",
+      "svg",
+      "title",
+      "ul"
+    ],
+    "classes": [
+      "active",
+      "align-content-center",
+      "align-items-center",
+      "align-self-center",
+      "bg-body",
+      "bg-info",
+      "bg-opacity-10",
+      "bg-primary",
+      "bottom-0",
+      "bottom-bar",
+      "btn",
+      "btn-close",
+      "btn-primary",
+      "col",
+      "col-12",
+      "col-lg-2",
+      "col-lg-4",
+      "col-md-2",
+      "col-md-4",
+      "col-md-8",
+      "col-md-auto",
+      "col-sm-12",
+      "col-sm-6",
+      "collapse",
+      "collapsed",
+      "container-fluid",
+      "container-xxl",
+      "d-block",
+      "d-flex",
+      "d-inline",
+      "d-lg-block",
+      "d-md-block",
+      "d-md-flex",
+      "d-md-none",
+      "d-none",
+      "d-sm-none",
+      "display-1",
+      "display-4",
+      "dropdown",
+      "dropdown-divider-bg",
+      "dropdown-item",
+      "dropdown-menu",
+      "dropdown-menu-end",
+      "dropdown-toggle",
+      "emphasis",
+      "end-0",
+      "fa",
+      "fa-10x",
+      "fa-2x",
+      "fa-book-open",
+      "fa-circle-half-stroke",
+      "fa-ellipsis",
+      "fa-face-frown",
+      "fa-fw",
+      "fa-github",
+      "fa-linkedin",
+      "fa-medium",
+      "fa-moon",
+      "fa-sun",
+      "fab",
+      "fas",
+      "feature",
+      "fixed-top",
+      "flex-column",
+      "flex-fill",
+      "flex-grow-1",
+      "flex-wrap",
+      "footer",
+      "form-control",
+      "fs-3",
+      "fw-30",
+      "fw-bold",
+      "h-100",
+      "img-fluid",
+      "img-wrap",
+      "invisible",
+      "is-search",
+      "justify-content-center",
+      "link-bg-footer",
+      "link-secondary",
+      "main-nav-toggler",
+      "mb-4",
+      "me-auto",
+      "middle-bar",
+      "min-vh-100",
+      "ms-auto",
+      "ms-md-3",
+      "mt-3",
+      "mt-5",
+      "mx-auto",
+      "mx-md-2",
+      "my-auto",
+      "nav-item",
+      "nav-link",
+      "navbar",
+      "navbar-brand",
+      "navbar-collapse",
+      "navbar-expand-md",
+      "navbar-nav",
+      "navbar-toggler",
+      "no-js",
+      "order-1",
+      "order-2",
+      "order-3",
+      "order-4",
+      "order-first",
+      "order-sm-2",
+      "order-sm-3",
+      "p-0",
+      "p-2",
+      "p-3",
+      "p-4",
+      "pb-5",
+      "pe-1",
+      "position-fixed",
+      "position-relative",
+      "px-3",
+      "px-4",
+      "px-xxl-0",
+      "py-2",
+      "py-5",
+      "py-md-1",
+      "rounded",
+      "row",
+      "row-cols-1",
+      "row-cols-sm-3",
+      "row-cols-sm-4",
+      "search",
+      "search-input",
+      "search-suggestions",
+      "shadow",
+      "svg-inline--fa",
+      "switch-mode-collapsed",
+      "text-center",
+      "text-decoration-none",
+      "text-secondary",
+      "text-sm-start",
+      "theme-icon",
+      "theme-icon-active",
+      "toast",
+      "toast-body",
+      "toast-container",
+      "toast-header",
+      "toggler-icon",
+      "top-bar",
+      "vr",
+      "w-100"
+    ],
+    "ids": [
+      "-theme",
+      "-theme-collapsed",
+      "navbar-0-collapse",
+      "toast-container",
+      "toast-copied-code-message"
+    ]
+  }
+}

i18n/fr.yaml

@@ -94,7 +94,7 @@
 
 # 404 page
 - id: pageNotFound
-  translation: "La page que vous recherchez n'existe pas ou une autre erreur s'est produite.Essayez de revenir à notre {{ . }}."
+  translation: "La page que vous recherchez n'existe pas ou une autre erreur s'est produite. Essayez de revenir à notre {{ . }}."
 - id: pageNotFoundTitle
   translation: "Page non trouvée"
 - id: pageNotFoundHome
@@ -112,4 +112,4 @@
 - id: show
   translation: "Afficher"
 - id: comments
-  translation: "Commentaires" 
+  translation: "Commentaires"

layouts/_default/baseof.html

@@ -30,7 +30,8 @@
                     "page" .
                     "fixed" (string .Site.Params.navigation.fixed)
                     "color" (.Site.Params.navigation.color)
-                    "style" (default "light" .Site.Params.navigation.style))
+                    "style" (default "light" .Site.Params.navigation.style)
+                    "size" (default "md" .Site.Params.navigation.size))
                 -}}
             </div>
             {{ if .IsHome -}}

layouts/_default/list.html

@@ -1,4 +1,5 @@
 {{- define "main" -}}
+    {{- $content := partial "utilities/ProcessContent" (dict "page" .Page "raw" .RawContent) -}}
     {{- partial "assets/section-list.html" (dict 
         "page" .
         "section" .Type
@@ -6,7 +7,7 @@
         "nested" .Params.Nested
         "title" (or .Title .Type)
         "description" .Description
-        "content" .Content
+        "content" $content
         "paginate" true)
     -}}
 {{- end -}}

layouts/_default/single.html

@@ -83,7 +83,8 @@
             {{- partial "assets/image.html" (dict "url" $thumbnail "ratio" "21x9" "outerClass" "img-wrap" "innerClass" "rounded" "title" .Params.title "caption" $credits) -}}
         {{ end -}}
     {{ end }}
-    {{ .Content }}
+
+    {{ partial "utilities/ProcessContent" (dict "page" .Page "raw" .RawContent) }}
 {{ end -}}
 
 {{ define "partials/footer.html" -}}

layouts/partials/assets/card-group.html

@@ -7,8 +7,10 @@
     The shortcode supports the following arguments:
     "page"          Required context of the current page.
     "list"          Required array of pages.
+    "cards"         Optional string of rendered cards.
     "max"           Required maximum number of cards to display.
     "cols"          Required number of columns for the grid, must be a value between 1 and 5.
+    "gutter"        Gutter between columns in a group, either "0", "1", "2", "3", "4" (default), or "5".
     "title"         Optional title of the card group.
     "paginate"      Optional flag indicating if pagination should be added to the card group, if the list exceeds the
                     maximum number of cards to display. 
@@ -16,6 +18,8 @@
                     maximum number of cards to display.
     "hrefTitle"     Optional title of the button or hyperlink as companion to href.
     "separator"     Optional flag to indicate a horizontal line should be added between items on small screens.
+    "wrapper"       Optional class attributes of the wrapper element, e.g. "p-4 px-xxl-0".
+    "responsive"    Optional flag if the number of columns should be responsive, defaults to "true".
 
     In addition, the following arguments are passed to the individual cards.
     "class"         Optional class attribute of the card element, e.g. “w-50”.
@@ -30,33 +34,18 @@
 -->
 
 {{- $page := .page -}}
-{{- if ne (printf "%T" $page) "*hugolib.pageState" -}}
+
-    {{- errorf "partial [assets/card-group.html] - Invalid value for param 'page'" -}}
+{{- if not (in (slice "*hugolib.pageState" "*hugolib.pageForShortcode") (printf "%T" $page)) -}}
+    {{- errorf "partial [assets/card-group.html] - Invalid value for param 'page': %T" $page -}}
 {{- end -}}
 
 {{- $supportedTypes := slice "page.Pages" "resource.Resources" -}}
-{{ $list := .list }}
+{{ $pages := .list }}
-{{- if not (in $supportedTypes (printf "%T" $list)) -}}
+{{- if and $pages (not (in $supportedTypes (printf "%T" $pages))) -}}
-    {{ warnf "Type: %T" $list }}
+    {{ warnf "Type: %T" $pages }}
     {{- errorf "partial [assets/card-group.html] - Invalid value for param 'list'" -}}
 {{- end -}}
-
+{{ $cards := .cards }}
-{{- $count := len $list -}}
-{{- $max := .max -}}
-{{- if ne (printf "%T" $max) "int" -}}
-    {{- errorf "partial [assets/card-group.html] - Invalid value for param 'max'" -}}
-{{- end -}}
-{{- $max = math.Min $max $count -}}
-
-{{- $cols := .cols -}}
-{{- if or (lt $cols 1) (gt $cols 5) -}}
-    {{- errorf "partial [assets/card-group.html] - Invalid value for param 'cols': %d" $cols -}}
-{{- end -}}
-{{- $colGrid := "row-cols-1" -}}
-{{- if eq $cols 2 }}{{ $colGrid = "row-cols-1 row-cols-sm-1 row-cols-md-2" -}}
-{{- else if eq $cols 3 }}{{ $colGrid = "row-cols-1 row-cols-sm-2 row-cols-md-3" -}}
-{{- else if eq $cols 4 }}{{ $colGrid = "row-cols-1 row-cols-sm-2 row-cols-md-4" -}}
-{{- else if eq $cols 5 }}{{ $colGrid = "row-cols-1 row-cols-sm-3 row-cols-md-5" }}{{ end -}}
 
 {{- $paginate := false -}}
 {{- with .paginate -}}
@@ -65,6 +54,70 @@
     {{- end -}}
     {{- $paginate = . -}}
 {{- end -}}
+
+{{ $paginator := "" }}
+{{ if $paginate }}
+    {{ $paginator = $page.Paginate $pages }}
+    {{ $pages = first $paginator.PageSize (after (mul (sub $paginator.PageNumber 1) $paginator.PageSize) $pages) }}
+{{ end }}
+{{ $list := slice }}
+{{ range $index, $element := $pages }}
+    {{ $params := dict }}
+    <!-- regular page -->
+    {{- if $element.RelPermalink -}}
+        {{- $params = merge $params (dict "path" $element.File.Path) -}}
+    <!-- headless page -->
+    {{- else -}}
+        {{- $thumbnail := (or (and (reflect.IsMap $element.Params.Thumbnail) $element.Params.Thumbnail.url) $element.Params.Thumbnail) -}}
+        {{- $params = merge $params (dict
+            "title" $element.Title
+            "href" $element.RelPermalink
+            "description" (partial "utilities/GetDescription.html" $element)
+            "thumbnail" $thumbnail
+            "icon" $element.Params.icon
+        ) -}}
+    {{- end -}}
+
+    {{- $list = $list | append $params }}
+{{ end }}
+
+{{- $count := len $list -}}
+{{- $max := $count -}}
+{{- with .max }}
+    {{- if ne (printf "%T" .) "int" -}}
+        {{- warnf "partial [assets/card-group.html] - Invalid value for param 'max': %s" . -}}
+    {{- else -}}
+        {{- $max = . -}}
+    {{- end -}}
+{{- end -}}
+{{- $max = math.Min $max $count -}}
+
+{{- $responsive := .responsive | default true -}}
+{{- with .responsive -}}
+    {{- if ne (printf "%T" .) "bool" -}}
+        {{- errorf "partial [assets/card-group.html] - Invalid value for param 'responsive'" -}}
+    {{- end -}}
+{{- end -}}
+
+{{- $cols := string .cols | default "3" -}}
+{{- $supportedCols := slice "0" "1" "2" "3" "4" "5" "auto" -}}
+{{- if not (in $supportedCols $cols) -}}
+    {{- errorf "partial [assets/card-group.html] - Invalid value for param 'cols': %s" $cols -}}
+{{- end -}}
+{{- $colGrid := "" -}}
+{{- if eq $cols "1" }}{{ $colGrid = "row-cols-1" -}}
+{{- else if eq $cols "2" }}{{ if $responsive }}{{ $colGrid = "row-cols-1 row-cols-sm-1 row-cols-md-2" }}{{ else }}{{ $colGrid = "row-cols-2" }}{{ end -}}
+{{- else if eq $cols "3" }}{{ if $responsive }}{{ $colGrid = "row-cols-1 row-cols-sm-2 row-cols-md-3" }}{{ else }}{{ $colGrid = "row-cols-3" }}{{ end -}}
+{{- else if eq $cols "4" }}{{ if $responsive }}{{ $colGrid = "row-cols-1 row-cols-sm-2 row-cols-md-4" }}{{ else }}{{ $colGrid = "row-cols-4" }}{{ end -}}
+{{- else if eq $cols "5" }}{{ if $responsive }}{{ $colGrid = "row-cols-1 row-cols-sm-3 row-cols-md-5" }}{{ else }}{{ $colGrid = "row-cols-5" }}{{ end -}}
+{{ end -}}
+
+{{- $gutter := .gutter | default "4" -}}
+{{- $supportedGutters := slice "0" "1" "2" "3" "4" "5" -}}
+{{- if not (in $supportedGutters $gutter) -}}
+    {{- errorf "partial [assets/card-group.html] - Invalid value for param 'gutter': %s" $gutter -}}
+{{- end -}}
+
 {{- if not $paginate -}}
     {{- $list = first $max $list -}}
 {{- end -}}
@@ -86,17 +139,12 @@
 {{- $header := .header -}}
 {{- $footer := .footer -}}
 {{- $orientation := .orientation -}}
+{{- $wrapper := .wrapper | default "p-4 px-xxl-0" -}}
 
 {{- if and (eq $cols 1) (eq $orientation "horizontal") }}{{ $orientation = "horizontal-sm" }}{{ end -}}
 
-<div class="container-fluid p-4 px-xxl-0">
+<div class="container-fluid {{ $wrapper }}">
-    {{ $paginator := "" }}
+    <div class="row {{ $colGrid }} g-{{ $gutter }}">
-    {{ if $paginate }}
-        {{ $paginator = $page.Paginate $list }}
-        {{ $list = first $paginator.PageSize (after (mul (sub $paginator.PageNumber 1) $paginator.PageSize) $list) }}
-    {{ end }}
-
-    <div class="row {{ $colGrid }}">
         {{ range $index, $element := $list }}
             {{- $params := (dict
                 "class" (printf "h-100 %s" $class)
@@ -106,21 +154,9 @@
                 "footer" $footer
                 "orientation" $orientation
             ) -}}
+            {{- $params = merge $params $element }}
 
-            {{- if $element.RelPermalink -}}
+            <div class="col">
-                {{- $params = merge $params (dict "path" $element.File.Path) -}}
-            {{- else -}}
-                {{- $thumbnail := (or (and (reflect.IsMap $element.Params.Thumbnail) $element.Params.Thumbnail.url) $element.Params.Thumbnail) -}}
-                {{- $params = merge $params (dict
-                    "title" $element.Title
-                    "href" $element.RelPermalink
-                    "description" (partial "utilities/GetDescription.html" $element)
-                    "thumbnail" $thumbnail
-                    "icon" $element.Params.icon
-                ) -}}
-            {{- end -}}
-
-            <div class="col pt-3 pb-3">
                 {{- partial "assets/card.html" $params -}}
             </div>
             {{- if and (lt $index (sub $max 1)) $separator -}}
@@ -129,6 +165,7 @@
                 </div>
             {{- end -}}
         {{- end -}}
+        {{- print $cards | safeHTML }}
     </div>
 
     {{ if $paginate }}

layouts/partials/assets/card.html

@@ -11,12 +11,14 @@
                     "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.
+    "alt"           Optional alternate text for the thumbnail, uses "title" by default.
     "icon"          Optional Font Awesome icon, displayed on top or the left of the card.
     "orientation"   Optional placecement of the thumbnail or icon, either "stacked" (default), "horizontal",
                     "horizontal-sm" or "none".
@@ -32,12 +34,12 @@
     {{- if $href -}}
         <a href="{{ $href }}" class="{{ if $color }}link-bg-{{ $color }}{{ else }}card-body-link{{ end }} stretched-link">
                 <p class="card-title fs-5 fw-bold">{{ $title }}</p>
-            {{ with $description }}<p class="card-text mb-4 {{ if $color }}link-bg-{{ $color }}{{ else }}card-body-link{{ end }}">{{ . }}</p>{{ end -}}
+            {{ with $description }}<p class="card-text {{ if $color }}link-bg-{{ $color }}{{ else }}card-body-link{{ end }}">{{ . }}</p>{{ end -}}
         </a>
     {{- else -}}
         <div>
-            <p class="card-title fs-5 fw-bold">{{ $title }}</p>
+            {{ with $title }}<p class="card-title fs-5 fw-bold">{{ . }}</p>{{ end -}}
-            {{ with $description }}<p class="card-text mb-4 {{ if $color }}link-bg-{{ $color }}{{ else }}card-body-link{{ end }}">{{ . }}</p>{{ end -}}
+            {{ with $description }}<p class="card-text">{{ . }}</p>{{ end -}}
         </div>
     {{- end -}}
 {{- end -}}
@@ -82,6 +84,7 @@
 {{- end }}
 
 {{- $title := .title -}}
+{{- $alt := .alt -}}
 {{- $href := .href -}}
 {{- $description := .description -}}
 {{- $thumbnail := .thumbnail -}}
@@ -126,6 +129,12 @@
     {{- errorf "partial [assets/card.html] - Invalid value for param 'padding': %s" $padding -}}
 {{- end -}}
 
+{{- $gutter := .gutter | default "0" -}}
+{{ $supportedGutters:= slice "0" "1" "2" "3" "4" "5" -}}
+{{ if not (in $supportedGutters $gutter) -}}
+    {{- errorf "partial [assets/card.html] - Invalid value for param 'gutter': %s" $gutter -}}
+{{ end -}}
+
 {{- $orientation := "stacked" -}}
 {{- with .orientation }}{{ $orientation = . }}{{ end -}}
 {{- $supportedOrientations := slice "stacked" "horizontal" "horizontal-sm" "none" -}}
@@ -134,6 +143,7 @@
 {{- end -}}
 {{- if eq $orientation "none" }}{{ $thumbnail = "" }}{{ $icon = "" }}{{ end -}}
 
+{{ if ne $gutter "0" }}<div class="g-{{ $gutter }}">{{ end }}
 {{- if hasPrefix $orientation "horizontal" -}}
     <div class="card {{ with $color }}bg-{{ . }} text-bg-{{ . }}{{ end }} {{ $class }}">
         <div class="row g-0 row-cols-1 h-100">
@@ -160,7 +170,7 @@
 {{- else -}}
     <div class="card {{ with $color }}bg-{{ . }} text-bg-{{ . }}{{ end }} {{ $class }}">
         {{- if $thumbnail -}}
-            {{- partial "assets/image.html" (dict "url" $thumbnail "ratio" "16x9" "outerClass" "card-img-wrap" "innerClass" "card-img-top" "title" $title) -}}
+            {{- partial "assets/image.html" (dict "url" $thumbnail "ratio" "16x9" "outerClass" "card-img-wrap" "innerClass" "card-img-top" "title" (or $alt $title)) -}}
         {{- else if $icon -}}
             <div class="p-{{ $padding }}">
                 {{- partial "assets/icon.html" (dict "icon" (printf "%s fa-4x text-secondary" $icon)) -}}
@@ -173,3 +183,4 @@
         </div>
     </div>
 {{- end -}}
+{{ if ne $gutter "0" }}</div>{{ end }}

layouts/partials/assets/carousel-item.html

@@ -0,0 +1,16 @@
+{{- $page := .page -}}
+{{- $active := .active -}}
+{{- $src := .src -}}
+{{- $caption := .caption -}}
+{{- $ratio := .ratio -}}
+{{- $portrait := .portrait -}}
+
+<div class="carousel-item{{ if $active }} active{{ end }}">
+    {{ partial "assets/image.html" (dict "url" $src "ratio" $ratio "page" $page "innerClass" "d-block w-100" "portrait" $portrait) }}
+    <div class="carousel-caption gradient"></div>
+    {{ with $caption }}
+        <div class="carousel-caption d-none d-md-block">
+            <div class="d-flex justify-content-center align-items-end h-100 w-100 p-4">{{ . }}</div>
+        </div>
+    {{ end }}
+</div>

layouts/partials/assets/image.html

@@ -2,22 +2,43 @@
     Render a local or remote image with responsive image sizing. Images are resized using default media breakpoints
     and are converted to webp format. The image is processed using the quality setting specified in the [imaging]
     section of the main config file (defaults to 75). A fallback image is provided for older browsers. The image is
-    wrapped in a figure if a caption is provided, else the image is wrapped in a div with a ratio constraint. The
+    wrapped in a figure if a caption is provided, else the image is wrapped in a div with a ratio constraint.
-    partial supports the following arguments:
+    
-    "url":          Required relative url of the image, e.g. "img/example.jpg"
+    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 supports the following bitmap image formats: "png", "jpeg", "gif", "tiff", "bmp", and  "webp". Vector
+    graphics of type "svg" are supported too, although these images do no support additional processing. This means
+    the arguments "ratio" and "portrait" have no effect for vector images. Vector graphics support an optional anchor
+    "#" in their url to denote a styling reference.
+    
+    The partial supports the following arguments:
+    "url":          Required path or url of the image, e.g. "img/example.jpg"
     "mode":         Optional flag indicating if the image should support color modes.
-    "ratio":        Optional ratio of the image, either "1x1", "4x3", "16x9", or "21x9". If set, the image is
+    "ratio":        Optional ratio of the image, either "1x1", "3x2", "4x3", "16x9", or "21x9". If set, the image is
-                    resized and cropped to match the ratio. Else the original aspect ratio of the image is kept.
+                    resized and cropped to match the ratio. Else the original aspect ratio of the image is kept. Not
+                    applicable to vector graphics.
+    "portrait":     Optional 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.
     "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.
     "caption":      Optional figure caption.
+    "page":         Optional page context, used to match page resources.
 -->
 
-{{- $validRatios := slice "1x1" "4x3" "16x9" "21x9" -}}
 {{- $absoluteURL := site.Params.main.canonifyAssetsURLs | default false -}}
+{{- $validRatios := slice "1x1" "3x2" "4x3" "16x9" "21x9" -}}
 {{- $ratio := .ratio -}}
+{{- if $ratio -}}
+    {{ if not (in $validRatios $ratio) -}}
+        {{- errorf "partial [assets/image.html] - Invalid value for param 'ratio'" -}}
+    {{ end -}}
+{{- end -}}
+{{- $portrait := .portrait -}}
 {{- $url := .url -}}
+
 {{- $mode := false -}}
 {{- with .mode -}}
     {{ $mode = . -}}
@@ -30,12 +51,37 @@
     {{- errorf "partial [assets/image.html] - Invalid value for param 'mode'" -}}
 {{- end -}}
 {{- $modes := site.Params.main.modes | default (slice "light" "dark") -}}
+{{- $page := .page -}}
 
 
+{{- define "partials/image-portrait.html" -}}
+    {{- $dimensions := slice }}
+    {{- $dim := .dim -}}
+    {{- $dimensions = $dimensions | append $dim -}}
+    {{- $portraits := slice }}
+    {{- range $d := $dimensions -}}
+        {{- $p := split $d "x" }}
+        {{ if ne (len $p) 2 }}
+            {{- warnf "partial [assets/image.html] - Invalid dimension: %s" $d -}}
+            {{- $portraits = $portraits | append $d -}}
+        {{- else -}}
+            {{- $portraits = $portraits | append (printf "%sx%s" (index $p 1) (index $p 0)) -}}
+        {{- end -}}
+    {{- end -}}
+    {{- $ret := "" }}
+    {{- if reflect.IsSlice $dim -}}
+        {{ $ret = $portraits -}}
+    {{- else if gt (len $portraits) 0 -}}
+        {{- $ret = index $portraits 0 -}}
+    {{- end -}}
+    {{- return $ret -}}
+{{- end -}}
+
 <!-- Generate a fallback image of type jpg -->
 {{- define "partials/image-default.html" -}}
     {{- $img := .img -}}
     {{- $ratio := .ratio -}}
+    {{- $portrait := and .portrait .ratio -}}
     {{- $width := "1400" -}}
     {{- $dim := "" -}}
     {{- $fallback := "" -}}
@@ -43,6 +89,8 @@
     {{- with $img -}}
         {{- if eq $ratio "4x3" -}}
             {{- $dim  = "1400x1050" }}
+        {{- else if eq $ratio "3x2" -}}
+            {{- $dim  = "1400x933" }}
         {{- else if eq $ratio "1x1" -}}
             {{- $dim  = "1400x1400" }}
         {{- else if eq $ratio "16x9" -}}
@@ -53,6 +101,10 @@
             {{- $dim = printf "%sx%d" $width (int (math.Round (mul (div (float $width) $img.Width) $img.Height))) -}}
         {{- end -}}
 
+        {{- if $portrait -}}
+            {{- $dim = partial "partials/image-portrait.html" (dict "dim" $dim) -}}
+        {{- end -}}
+
         {{- if $ratio -}}
             {{- $fallback = ($img.Fill (printf "%s jpg" $dim)) -}}
         {{- else -}}
@@ -72,6 +124,7 @@
     {{- $absoluteURL := site.Params.main.canonifyAssetsURLs | default false -}}
     {{- $img := .img -}}
     {{- $ratio := .ratio -}}
+    {{- $portrait := and .portrait .ratio -}}
     {{- $imgset := "" -}}
 
     {{- $widths := slice "576" "768" "992" "1200" "1400" -}}
@@ -79,6 +132,8 @@
     {{- with $img -}}
         {{- if eq $ratio "4x3" -}}
             {{- $dims  = slice "576x432" "768x576" "992x744" "1200x900"  "1400x1050" -}}
+        {{- else if eq $ratio "3x2" -}}
+            {{- $dims = slice "576x384"  "768x512" "992x661" "1200x800"  "1400x933" -}}
         {{- else if eq $ratio "1x1" -}}
             {{- $dims  = slice "576x576" "768x768" "992x992" "1200x1200" "1400x1400" -}}
         {{- else if eq $ratio "16x9" -}}
@@ -91,6 +146,10 @@
             {{- end -}}
         {{- end -}}
 
+        {{- if $portrait -}}
+            {{- $dims = partial "partials/image-portrait.html" (dict "dim" $dims) -}}
+        {{- end -}}
+
         {{- $scaled := "" -}}
         {{- range $index, $dim := $dims -}}
             {{- $clean := path.Ext $img.RelPermalink -}}
@@ -116,28 +175,41 @@
 {{- define "partials/image-definition.html" -}}
     {{- $absoluteURL := site.Params.main.canonifyAssetsURLs | default false -}}
     {{- $ratio := .ratio -}}
+    {{- $portrait := .portrait -}}
     {{- $url := .url -}}
     {{- $outerClass := .outerClass -}}
     {{- $innerClass := .innerClass -}}
     {{- $title := .title -}}
     {{- $caption := .caption -}}
     {{- $fallbackURL := "" -}}
+    {{- $anchor := "" -}}
     {{- $imgset := "" -}}
     {{- $mode := .mode -}}
     {{- $modes := .modes -}}
+    {{- $page := .page -}}
+    {{- $isVector := false -}}
+
+    {{- $segments := split $url "#" -}}
+    {{- if gt (len $segments) 2 -}}
+        {{- errorf "Invalid path or url: %q" $url -}}
+    {{- else if eq (len $segments) 2 }}
+        {{- $url = index $segments 0 -}}
+        {{- $anchor = index $segments 1 -}}
+    {{- end -}}
 
     {{- if hasSuffix $url "svg" -}}
         {{- $fallbackURL = $url -}}
+        {{- $isVector = true -}}
     {{- else -}}
-        {{- $img := partial "utilities/GetImage.html" (dict "url" $url) -}}
+        {{- $img := partial "utilities/GetImage.html" (dict "url" $url "page" $page) -}}
         {{- if $img -}}
-            {{- $fallback := partial "partials/image-default.html" (dict "img" $img "ratio" $ratio) -}}
+            {{- $fallback := partial "partials/image-default.html" (dict "img" $img "ratio" $ratio "portrait" $portrait) -}}
                 {{- if $absoluteURL -}}
                     {{- $fallbackURL = $fallback.Permalink -}}
                 {{- else -}}
                     {{- $fallbackURL = $fallback.RelPermalink -}}
                 {{- end -}}
-            {{- $imgset = partial "partials/image-scaled.html " (dict "img" $img "ratio" $ratio) -}}
+            {{- $imgset = partial "partials/image-scaled.html " (dict "img" $img "ratio" $ratio "portrait" $portrait) -}}
         {{- end -}}
     {{- end -}}
 
@@ -150,7 +222,8 @@
     {{- if $caption -}}
         <figure {{ with $outerClass }}class="{{ . }}"{{ end }}>
     {{ end }}
-        <div class="{{ with $ratio }}ratio ratio-{{ . }}{{ end }}{{ if not $caption }} {{ $outerClass }}{{ end }}">
+    <div class="{{ if not $caption }}{{ $outerClass }}{{ end }}">
+        {{- if not $anchor -}}
             <img class="img-fluid {{ $innerClass }}"
                 {{ with $imgset -}}
                 srcset="{{ . }}"
@@ -158,11 +231,16 @@
                 {{- end }}
                 src="{{ $fallbackURL }}"
                 alt="{{ $title }}">
-        </div>
+        {{- else }}
+            <svg class="{{ $innerClass }}">
+                <use href="{{ $fallbackURL }}#{{ $anchor }}"></use>
+            </svg>
+        {{ end }}
+    </div>
     {{- if $caption -}}
         <figcaption class="figure-caption">{{ $caption | safeHTML }}</figcaption>
     </figure>
-{{- end -}}
+    {{- end -}}
 {{- end -}}
 
 <!-- Initiate the regular or color-mode image -->
@@ -177,22 +255,26 @@
         {{- $image := printf "%s-%s%s" $base $suffix $ext -}}
         {{- partial "partials/image-definition.html" (dict 
             "ratio" $ratio
+            "portrait" $portrait
             "url" $image
             "outerClass" $outerClass
             "innerClass" $innerClass
             "title" $title
             "caption" $caption
             "mode" $suffix
-            "modes" $modes)
+            "modes" $modes
+            "page" $page)
         -}}
     {{- end -}}
 {{- else -}}
     {{- partial "partials/image-definition.html" (dict 
         "ratio" $ratio
+        "portrait" $portrait
         "url" $url
         "outerClass" $outerClass
         "innerClass" $innerClass
         "title" $title
-        "caption" $caption)
+        "caption" $caption
+        "page" $page)
     -}}
 {{- end -}}

layouts/partials/assets/nav-item.html

@@ -0,0 +1,29 @@
+<!-- 
+    Defines an individual nav item. The shortcode supports the following arguments:
+    
+    "id"            Required unique ID of the nav-item.
+    "parentID"      Required ID of the parent (e.g. nav control).
+    "class"         Optional class attributes to be added to the nav-item.
+    "fade"          Optional flag to make the tab pane fade in.
+    "header"        Required header of the nav item.
+    "class"         Optional class attribute of the nav item.
+    "body"          The body content of the nav-item, supports Markdown and HTML (if enabled).
+    "show"          Optional flag to indicate the item should be shown as expanded (only one can be shown at a time).
+    "disabled"      Optional flag to indicate the item should be in a disabled state.
+-->
+
+{{- $id := .id -}}
+{{- $parentID := .parentID -}}
+{{- $class := .class -}}
+{{- $fade := .fade -}}
+{{- $header := .header -}}
+{{- $class := .class -}}
+{{- $body := .body -}}
+{{- $show := .show -}}
+{{- $disabled := .disabled -}}
+
+<div class="tab-pane{{ if $show }} active {{ if $fade }}show{{ end }}{{ end }} {{ if $fade}}fade{{ end }}{{ with $class }} {{ . }}{{ end }}" id="{{ $parentID }}-{{ $id }}" 
+    role="tabpanel" aria-labelledby="{{ $parentID }}-btn-{{ $id }}" tabindex="0" data-header="{{ $header }}" {{ if $show }}data-show-id="{{ $id }}"{{ end }} 
+    data-has-content="{{ gt (len $body) 0 }}" {{ if $disabled }} data-disabled-id="{{ $id }}"{{ end }}>
+    {{ $body }}
+</div>

layouts/partials/assets/navbar-item.html

@@ -6,7 +6,7 @@
 
 {{- $menuURL := (or $menu.PageRef $menu.URL) | relLangURL -}}
 {{- $pageURL := $page.RelPermalink | relLangURL -}}
-{{- $isActive := hasPrefix $pageURL $menuURL -}}
+{{- $isActive := or (and (hasPrefix $pageURL $menuURL) (ne $menuURL ("/" | relLangURL))) (eq $pageURL $menuURL) -}}
 {{- $isAlias := $menu.Params.alias -}}
 {{- $isIcon := $menu.Params.icon -}}
 {{- $cue := .cue | default site.Params.main.externalLinks.cue -}}

layouts/partials/assets/navbar.html

@@ -1,9 +1,10 @@
 <!-- 
     Displays a navigation header with a toggler. The partial supports the following arguments:
-    "id"            Optional id of the navbar toggler, defaults to "navbar-collapse-0".
+    "id"            Optional 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.
     "page"          Required object reference to the current page.
     "menus"         Optional name of the menu configuration, defaults to "main".
-    "size"          Optional size of the button, either "sm", "md" (default), or "lg".
+    "size"          Optional breakpoint of the navbar toggler, either "xs", "sm", "md" (default), "lg", or "xl".
     "fixed"         Optional flag to indicate the navbar should stick to the top, defaults to false.
     "color"         Optional background color of the navbar, either "primary", "secondary", "success",
                     "danger", "warning", "info", "white", "black", "body", or "body-tertiary". The default color is
@@ -20,13 +21,14 @@
 {{- define "partials/navbar-mode.html" -}}
     {{- $size := .size -}}
     {{- $collapsed := .collapsed -}}
+    {{- $id := .id -}}
 
     <li class="nav-item dropdown {{ if $collapsed }}d-{{ $size }}-none{{ else }}d-none d-{{ $size }}-block{{ end }}">
-        <a class="nav-link dropdown-toggle" href="#!" role="button" data-bs-toggle="dropdown" aria-label="{{ T "colorMode" }}" aria-expanded="false" id="navbar-color-theme{{ if $collapsed }}-collapsed{{ end }}">
+        <a class="nav-link dropdown-toggle" href="#!" role="button" data-bs-toggle="dropdown" aria-label="{{ T "colorMode" }}" aria-expanded="false" id="{{ $id }}-theme{{ if $collapsed }}-collapsed{{ end }}">
-            <span class="theme-icon-active">{{- partial "assets/icon.html" (dict "icon" "fas sun fa-fw") }} {{ if $collapsed }} {{ T "colorMode" }} {{ end }}</span>
+            <span class="theme-icon-active">{{- partial "assets/icon.html" (dict "icon" "fas sun fa-fw") }}</span>{{ if $collapsed }} {{ T "colorMode" }} {{ end }}
             <span class="d-md-none"></span>
         </a>
-        <ul class="dropdown-menu dropdown-menu-end" aria-labelledby="navbar-color-theme{{ if $collapsed }}-collapsed{{ end }}">
+        <ul class="dropdown-menu dropdown-menu-end" aria-labelledby="{{ $id }}-theme{{ if $collapsed }}-collapsed{{ end }}">
             <li>
                 <a class="dropdown-item{{ if $collapsed }} switch-mode-collapsed{{ end }}" data-bs-theme-value="light" href="#!">
                     <span class="theme-icon">{{- partial "assets/icon.html" (dict "icon" "fas sun fa-fw") }}</span>&nbsp;
@@ -55,13 +57,14 @@
     {{- $collapsed := .collapsed -}}
     {{- $page := .page -}}
     {{- $list := site.Params.docs.releases -}}
+    {{- $id := .id -}}
     {{- $version := partial "utilities/GetVersion.html" (dict "page" $page) -}}
 
     <li class="nav-item dropdown {{ if $collapsed }}d-{{ $size }}-none{{ else }}d-none d-{{ $size }}-block{{ end }}">
-        <a class="nav-link dropdown-toggle" href="#!" role="button" data-bs-toggle="dropdown" aria-expanded="false" id="navbar-version-switch">
+        <a class="nav-link dropdown-toggle" href="#!" role="button" data-bs-toggle="dropdown" aria-expanded="false" id="{{ $id }}-version-switch">
             {{ if $collapsed }}{{ site.Title }} {{ end }}{{ $version }}
         </a>
-        <ul class="dropdown-menu dropdown-menu-end" aria-labelledby="navbar-version-switch">
+        <ul class="dropdown-menu dropdown-menu-end" aria-labelledby="{{ $id }}-version-switch">
             {{- range $index, $item := $list -}}
                 {{- $active := eq $item.label $version -}}
                 {{- $disabled := false -}}
@@ -97,7 +100,7 @@
 {{- $absoluteURL := site.Params.main.canonifyAssetsURLs | default false -}}
 {{- $supportedFlags := slice "true" "false" -}}
 
-{{- $id := printf "navbar-collapse-%d" 0 -}}
+{{- $id := printf "navbar-%d" 0 -}}
 {{ with .id }}
     {{ $id = . }}
 {{ end }}
@@ -171,7 +174,32 @@
 {{- $enableLanguage := or $page.IsTranslated site.IsMultiLingual -}}
 
 {{- $logo := site.Params.navigation.logo -}}
-{{- with .logo }}{{ $logo = . }}{{ end -}}
+{{- $logoLight := "" -}}
+{{- $logoDark := "" -}}
+{{- with .logo }}
+    {{ $logo = . }}
+{{- end -}}
+{{- if $enableDarkMode -}}
+    {{ $ext := path.Ext $logo -}}
+    {{- $logoLight = printf "%s-light%s" (strings.TrimSuffix $ext $logo) $ext -}}
+    {{- $logoDark = printf "%s-dark%s" (strings.TrimSuffix $ext $logo) $ext -}}
+    {{- $light := fileExists (path.Join "/static" $logoLight) -}}
+    {{- $dark := fileExists (path.Join "/static" $logoDark) -}}
+    {{- if and $light (not $dark) -}}
+        {{- warnf "partial [assets/navbar.html] - Missing file: %s" $logoDark -}}
+        {{- $logoLight = "" -}}
+        {{- $logoDark = "" -}}
+    {{- end -}}
+    {{- if and (not $light) $dark -}}
+        {{- warnf "partial [assets/navbar.html] - Missing file: %s" $logoLight -}}
+        {{- $logoLight = "" -}}
+        {{- $logoDark = "" -}}
+    {{- end -}}
+    {{- if not (or $light $dark) -}}
+        {{- $logoLight = "" -}}
+        {{- $logoDark = "" -}}
+    {{- end -}}
+{{- end -}}
 
 {{- $title := site.Title -}}
 {{- if .title -}}
@@ -185,12 +213,12 @@
 {{- $theme := "light" -}}
 {{- if in (slice "primary" "secondary" "success" "danger" "black") $color }}{{ $theme = "dark" }}{{ end -}}
 {{- if in (slice "body" "body-tertiary") $color }}{{ $theme = "" }}{{ end -}}
+{{- if not $color }}{{ $theme = "" }}{{ end -}}
 {{- $class := .class -}}
 
 {{- $contrast := false -}}
 {{- if in (slice "primary" "secondary" "success" "danger") $color }}{{ $contrast = true }}{{ end -}}
 
-
 <div class="container-fluid {{ if $fixed }}fixed-top{{ end }} p-0{{ with $class }} {{ . }}{{ end }}">
     {{- partial "assets/page-alert.html" (dict "page" $page) -}}
     <nav class="navbar navbar-expand-{{ $size }}{{ if $contrast }} navbar-contrast{{ end }}{{ with $color }} bg-{{ . }}{{ end }} p-4"{{ with $theme }} data-bs-theme="{{ . }}"{{ end }}>
@@ -211,7 +239,10 @@
     
             <!-- Insert the brand logo or name -->
             <a class="navbar-brand mx-auto" href="{{ site.Home.RelPermalink }}">
-                {{- if $logo -}}
+                {{- if (and $logoLight $logoDark) -}}
+                    <img src="{{if $absoluteURL }}{{ absURL $logoLight }}{{ else }}{{ $logoLight }}{{ end }}" class="d-none-dark" alt="{{ $title }} logo" height="30">
+                    <img src="{{if $absoluteURL }}{{ absURL $logoDark }}{{ else }}{{ $logoDark }}{{ end }}" class="d-none-light" alt="{{ $title }} logo" height="30">
+                {{- else if $logo -}}
                     <img src="{{if $absoluteURL }}{{ absURL $logo }}{{ else }}{{ $logo }}{{ end }}" alt="{{ $title }} logo" height="30">
                 {{- else -}}
                     <span class="fw-bold">{{ $title }}</span>
@@ -220,7 +251,7 @@
     
             <!-- Insert main navigation toggler -->
             <div class="d-flex fw-30">
-                <button class="navbar-toggler main-nav-toggler collapsed p-0" type="button" data-bs-toggle="collapse" data-bs-target="#{{ $id }}"
+                <button class="navbar-toggler main-nav-toggler collapsed p-0" type="button" data-bs-toggle="collapse" data-bs-target="#{{ $id }}-collapse"
                     aria-controls="{{ $id }}" aria-expanded="false" aria-label="{{ T "toggleMainNav" }}">
                     <span class="toggler-icon top-bar emphasis{{ with $theme }}-{{ . }}{{ end }}"></span>
                     <span class="toggler-icon middle-bar emphasis{{ with $theme }}-{{ . }}{{ end }}"></span>
@@ -228,7 +259,7 @@
                 </button>
             </div>
     
-            <div class="navbar-collapse collapse" id="{{ $id }}">
+            <div class="navbar-collapse collapse" id="{{ $id }}-collapse">
                 <!-- Insert search input -->
                 {{- if $search }}{{ partial "assets/search-input.html" -}}{{ end -}}
                 
@@ -281,8 +312,8 @@
                                     
                     <!-- Insert version switcher -->
                     {{- if $enableVersions -}}
-                        {{- partial "partials/navbar-versions.html" (dict "page" $page "size" $size "collapsed" true ) -}}
+                        {{- partial "partials/navbar-versions.html" (dict "page" $page "size" $size "collapsed" true "id" .id) -}}
-                        {{- partial "partials/navbar-versions.html" (dict "page" $page "size" $size "collapsed" false) -}}
+                        {{- partial "partials/navbar-versions.html" (dict "page" $page "size" $size "collapsed" false "id" .id) -}}
                     {{- end -}}
     
                     <!-- Insert color mode switcher -->
@@ -293,8 +324,8 @@
                         </li>
                         <li><hr class="dropdown-divider-bg"></li>
     
-                        {{- partial "partials/navbar-mode.html" (dict "size" $size "collapsed" true) -}}
+                        {{- partial "partials/navbar-mode.html" (dict "size" $size "collapsed" true "id" .id) -}}
-                        {{- partial "partials/navbar-mode.html" (dict "size" $size "collapsed" false) -}}
+                        {{- partial "partials/navbar-mode.html" (dict "size" $size "collapsed" false "id" .id) -}}
                     {{- end -}}
                 </ul>
             </div>

layouts/partials/footer/social.html

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

layouts/partials/head/favicon.html

@@ -2,10 +2,14 @@
 {{- $absoluteURL := site.Params.main.canonifyAssetsURLs | default false -}}
 {{ if .Site.Params.favicon.logo -}}
     {{ $favicon := resources.Get .Site.Params.favicon.logo -}}
-    {{ range $i := .Site.Params.favicon.sizes -}} 
+    {{- if $favicon -}}
-        {{ $image := $favicon.Resize (printf "%dx%d CatmullRom" $i $i) -}}
+        {{ range $i := .Site.Params.favicon.sizes -}} 
-        <link rel="icon" type="image/png" sizes="{{$i}}x{{$i}}" href="{{ if $absoluteURL }}{{ $image.Permalink }}{{ else }}{{ $image.RelPermalink }}{{ end }}">
+            {{ $image := $favicon.Resize (printf "%dx%d CatmullRom" $i $i) -}}
-    {{ end -}} 
+            <link rel="icon" type="image/png" sizes="{{$i}}x{{$i}}" href="{{ if $absoluteURL }}{{ $image.Permalink }}{{ else }}{{ $image.RelPermalink }}{{ end }}">
-    {{ $image := $favicon.Resize "180x CatmullRom" -}}
+        {{ end -}} 
-    <link rel="apple-touch-icon" sizes="180x180" href="{{ if $absoluteURL }}{{ $image.Permalink }}{{ else }}{{ $image.RelPermalink }}{{ end }}">
+        {{ $image := $favicon.Resize "180x CatmullRom" -}}
+        <link rel="apple-touch-icon" sizes="180x180" href="{{ if $absoluteURL }}{{ $image.Permalink }}{{ else }}{{ $image.RelPermalink }}{{ end }}">
+    {{ else }}
+        {{- errorf "partial [head/favicon.html] - Cannot find file: %s" .Site.Params.favicon.logo -}}
+    {{ end }}
 {{ end -}}

layouts/partials/utilities/GetArg.html

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

@@ -1,18 +1,28 @@
 <!-- 
-    Retrieve a local or remote resource compatible with Hugo's image processing. The path of a remote image is
+    Retrieve a local or remote resource compatible with Hugo's image processing. If the url starts with 'http', the
-    rewritten to ensure processed files are stored in the final '/img' folder. The partial returns nil if the
+    image is retrieved from an external location. Else, the url is matched with a page resource and site asset (in that
-    resource cannot be found or is incompatibile. The partial supports the following arguments:
+    order). The path of a remote image is rewritten to ensure processed files are stored in the final '/img' folder. The
-    "url":          Required path or url of the image, e.g. "img/example.jpg" or "https://example.com/img.jpg"
+    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 -}}
+
 {{ $supportedMediaTypes := slice "image/png" "image/jpeg" "image/gif" "image/tiff" "image/bmp" "image/webp" -}}
 {{ $img := "" }}
 {{ $remote := hasPrefix (lower $url) "http" }}
 {{ if $remote }}
     {{ $img = resources.GetRemote $url -}}
 {{ else }}
-    {{ $img = resources.GetMatch $url -}}
+    {{ if $page }}
+        {{ $img = $page.Resources.Get $url -}}
+    {{ end }}
+    {{ if not $img }}
+        {{ $img = resources.GetMatch $url }}
+    {{ end }}
 {{ end }}
 
 {{ with $img -}}

layouts/partials/utilities/ProcessContent.html

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

@@ -9,24 +9,16 @@
 {{- $cue := .cue | default site.Params.main.externalLinks.cue -}}
 {{- $tab := .tab | default site.Params.main.externalLinks.tab -}}
 {{- $isExternal := ne (urls.Parse (absURL $destination)).Host (urls.Parse site.BaseURL).Host -}}
-
+{{- $page := .page -}}
-{{ $text := .text }}
+{{- $anchor := "" -}}
-{{- if not $text -}}
+{{- $text := .text -}}
-    {{ if $isExternal }}
+{{- $class := .class -}}
-        {{ $text = (urls.Parse (absURL $destination)).Host }}
-    {{ else }}
-        {{ $target := site.GetPage $destination }}
-        {{ if not $target }}
-            {{- errorf "partial [utilities/link.html] - Cannot find page: %s" $destination -}}
-        {{ else }}
-            {{ $text = $target.Title }}
-            {{ if not $case }}{{ $text = lower $text }}{{ end }}
-            {{ $destination = $target.RelPermalink }}
-        {{ end }}
-    {{ end }}
-{{- end -}}
 
 {{- if $isExternal -}}
+    {{- if not $text -}}
+        {{- $text = (urls.Parse (absURL $destination)).Host -}}
+    {{- end -}}
+
     {{- if $tab -}}
         {{- $target = "_blank" -}}
         {{- $rel = "noopener noreferrer" -}}
@@ -36,10 +28,45 @@
         {{ $suffix := partial "assets/icon.html" (dict "icon" "fas up-right-from-square fa-2xs") }}
         {{- $text = printf "%s %s" $text $suffix | safeHTML -}}
     {{- end -}}
-{{ else }}
+{{- else -}}
-    {{ $destination = relLangURL $destination }}
+    {{- if strings.Contains $destination "#" }}
+        {{ $segments := split $destination "#" }}
+        {{- if ne (len $segments) 2 }}
+            {{- errorf "partial [utilities/link.html] - Malformed path, expected one anchor '#' only: %s" $destination -}}
+        {{ else }}
+            {{- $destination = index $segments 0 -}}            
+            {{- $anchor = index $segments 1 -}}            
+        {{ end }}
+    {{ end }}
+    {{- $destination = strings.TrimSuffix "/" $destination -}}
+    {{- $ref := $page.GetPage $destination -}}
+
+    {{- if not $ref }}
+        {{- $segments := split $destination "/" -}}
+        {{- if and (hasPrefix $destination "/")  (gt (len $segments) 1) -}}
+            {{- $prefix := index $segments 1 -}}
+            {{- $page := .Page -}}
+            {{ with index (where site.Sites "Language.Lang" $prefix) 0 }}
+                {{- $path := printf "/%s" (strings.TrimPrefix (printf "/%s/" $prefix) $destination) }}
+                {{- $ref = .GetPage $path -}}
+            {{ end }}
+        {{- end -}}
+    {{- end -}}
+
+    {{- if not $ref -}}
+        {{- errorf "partial [utilities/link.html] - Cannot find page: %s" $destination -}}
+    {{- else -}}
+        {{- $destination = $ref.RelPermalink -}}
+        {{- with $anchor }}{{ $destination = printf "%s#%s" (strings.TrimSuffix "/" $destination) . -}}{{ end -}}
+        {{- if not $text -}}
+            {{- if $anchor -}}
+                {{- $text = $anchor -}}
+            {{- else -}}
+                {{- $text = $ref.LinkTitle -}}
+            {{- end -}}
+        {{ end -}}
+        {{- if not $case }}{{ $text = lower $text }}{{ end -}}
+    {{- end -}}
 {{- end -}}
 
-{{- $class := .class -}}
-
 <a {{ with $class }}class="{{ . }}" {{ end }}href="{{ $destination | safeURL }}"{{ with $target }} target="{{ . }}"{{ end }}{{ with $rel }} rel="{{ . }}"{{ end }}>{{ $text }}</a>

layouts/shortcodes/abbr.html

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

layouts/shortcodes/accordion-item.html

@@ -12,7 +12,7 @@
 {{- end -}}
 
 {{- $id := .Ordinal -}}
-{{ $header := .Get "header" -}}
+{{ $header := .Get "header" | default "" -}}
 {{ if not $header -}}
     {{ if .Parent }}
         {{ errorf "Missing value for param 'header': %s" .Parent.Position -}}
@@ -21,7 +21,7 @@
     {{ end }}
 {{ end -}}
 
-{{ $class := .Get "class" -}}
+{{ $class := .Get "class" | default "" -}}
 {{ $body := trim .Inner " \r\n" -}}
 {{ if not $body -}}
     {{ if .Parent }}
@@ -50,6 +50,6 @@
     </h2>
     {{- end -}}
     <div id="{{ $parent }}-item-{{ $id }}" class="accordion-collapse collapse{{ if $show }} show{{ end }}{{ with $class }} {{ . }}{{ end }}" aria-labelledby="{{ $parent }}-heading-{{ $id }}" data-bs-parent="#{{ $parent }}">
-        <div class="accordion-body">{{ $body | markdownify | safeHTML }}</div>
+        <div class="accordion-body">{{ $body | .Page.RenderString | safeHTML }}</div>
     </div>
 </div>

layouts/shortcodes/accordion.html

@@ -10,7 +10,7 @@
 {{ with .Get "id" }}
     {{ $id = . }}
 {{ end }}
-{{- $class := .Get "class" -}}
+{{- $class := .Get "class" | default "" -}}
 
 {{- $openParam := "false" -}}
 {{- $open := false -}}
@@ -26,7 +26,7 @@
 {{- $body := .Inner -}}
 {{- if $open -}}
     {{- $pattern := printf "data-bs-parent=\"#%s\"" $id -}}
-    {{- $body = (replace .Inner $pattern "") | markdownify | safeHTML }}
+    {{- $body = (replace .Inner $pattern "") | .Page.RenderString | safeHTML }}
 {{- end -}}
 
 <div id="{{ $id }}" class="accordion mb-3{{ with $class }} {{ . }}{{ end }}">

layouts/shortcodes/alert.html

@@ -49,13 +49,13 @@
     {{ $error = true -}}
 {{ end -}}
 
-{{- $class := .Get "class" -}}
+{{- $class := .Get "class" | default "" -}}
 
 {{- if not $error -}}
     <div class="d-flex alert alert-{{ $color }} {{ if $dismissible }}alert-dismissible fade show{{ end }}{{ with $class }} {{ . }}{{ end }}" role="alert">
         {{ with $icon }}<div class="pt-1 pe-2">{{ . }}</div>{{ end }}
         <div class="flex-grow-1 my-auto">
-            {{ trim .Inner " \r\n" | markdownify | safeHTML -}}
+            {{ trim .Inner " \r\n" | .Page.RenderString | safeHTML -}}
             {{ if $dismissible }}<button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button>{{ end }}
         </div>
     </div>

layouts/shortcodes/badge.html

@@ -0,0 +1,23 @@
+<!-- 
+    Adds an inline badge. The shortcode supports the following arguments:
+    "title"         Required title of the badge.
+    "class"         Optional class attributes of the badge element.
+    "color"         Optional theme color of the element, either "primary", "secondary" (default), "success",
+                    "danger", "warning", "info", "light", "dark", "white", or "black".
+-->
+
+{{- $error := false -}}
+{{- $title := .Get "title" | default "" -}}
+{{- $class := .Get "class" | default "" -}}
+{{- $color := "secondary" -}}
+{{- with .Get "color" }}{{ $color = . }}{{ end -}}
+{{- $supportedColors := slice "primary" "secondary" "success" "danger" "warning" "info" "light" "dark" "white" "black" -}}
+{{- if not (in $supportedColors $color) -}}
+    {{- errorf "Invalid value for param 'color': %s" .Position -}}
+{{- end -}}
+
+{{- if not $title }}
+    {{ errorf "Missing title: %s" .Position -}}
+{{ else -}}
+    <span class="badge text-bg-{{ $color }}{{ with $class }} {{ . }}{{ end }}">{{ $title | plainify }}</span>
+{{ end -}}

layouts/shortcodes/breadcrumb.html

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

layouts/shortcodes/button-group.html

@@ -3,6 +3,13 @@
     "aria-label"    Optional assistive label for the button group.
 -->
 
+{{ $inner := .Scratch.Get "inner" }}
+{{ $input := trim .Inner " \r\n" }}
+{{ if $input }}
+    {{ $input = replace $input "\n" "\n  " }}
+    {{ warnf "Unexpected inner content: %s\r\n      %s" .Position $input }}
+{{ end }}
+
 <div class="btn-group" role="group" {{ with .Get "aria-label" }}aria-label="{{ . }}"{{ end }}>
-    {{ .Inner }}
+    {{ $inner | safeHTML }}
 </div>

layouts/shortcodes/button.html

@@ -31,8 +31,8 @@
 {{ $error := false }}
 {{ $type := "button" -}}
 
-{{- $icon := .Get "icon" }}
+{{- $icon := .Get "icon" | default "" }}
-{{ $title := trim .Inner " \r\n" -}}
+{{ $title := trim .Inner " \r\n" | .Page.RenderString -}}
 {{ if not (or $title $icon) -}}
     {{ errorf "Missing icon or inner element text: %s" .Position -}}
     {{ $error = true }}
@@ -71,17 +71,17 @@
     {{ errorf "Invalid value for param 'outline': %s" .Position -}}
 {{ end -}}
 
-{{ $badge := .Get "badge" -}}
+{{ $badge := .Get "badge" | default "" -}}
-{{ $label := .Get "aria-label" -}}
+{{ $label := .Get "aria-label" | default "" -}}
-{{ $tooltip := .Get "tooltip" -}}
+{{ $tooltip := .Get "tooltip" | default "" -}}
-{{ $collapse := .Get "collapse" -}}
+{{ $collapse := .Get "collapse" | default "" -}}
-{{ $href := .Get "href" -}}
+{{ $href := .Get "href" | default "" -}}
-{{ $relref := .Get "relref" }}
+{{ $relref := .Get "relref" | default "" -}}
-{{ $id := .Get "id" -}}
+{{ $id := .Get "id" | default "" -}}
 {{ if $relref }}
     {{ $href = relref . $relref }}
 {{ end }}
-{{ $class := .Get "class" -}}
+{{ $class := .Get "class" | default "" -}}
 
 {{ $placement := "top" -}}
 {{ with .Get "placement" }}{{ $placement = . }}{{ end -}}
@@ -91,7 +91,7 @@
     {{ $error = true }}
 {{ end -}}
 
-{{- $toast := .Get "toast" -}}
+{{- $toast := .Get "toast" | default "" -}}
 
 {{- $order := "last" -}}
 {{- with .Get "order" }}{{ $order = . }}{{ end -}}
@@ -113,7 +113,7 @@
 {{- $tab := .Get "tab" | default site.Params.main.externalLinks.tab -}}
 
 {{ if not $error }}
-    {{- partial "assets/button.html" (dict 
+    {{- $output := partial "assets/button.html" (dict 
         "type" $type
         "title" $title
         "size" $size
@@ -134,5 +134,16 @@
         "cue" $cue
         "tab" $tab
         "toast" $toast)
-    -}} 
+    -}}
+
+    {{- if .Parent -}}
+        {{ $current := .Parent.Scratch.Get "inner" }}
+        {{ if $current }}
+            {{ .Parent.Scratch.Set "inner" (print $current $output) }}
+        {{ else }}
+            {{ .Parent.Scratch.Set "inner" $output }}
+        {{ end }}
+    {{- else -}}
+        {{ $output | safeHTML }}
+    {{- end -}}
 {{ end }}

layouts/shortcodes/card-group.html

@@ -0,0 +1,63 @@
+<!-- 
+    Displays a grid of Bootstrap cards with 1 to 5 columns. The cards are rendered using a provided list of pages.
+    Cards on the same row are aligned to each other. The grid renders pages up to a provided maximum amount. The
+    remaining items are accessible via either a paginator or button to a list page (default behavior). Be aware a page
+    can only contain one paginator at a time.
+    
+    The shortcode supports the following arguments:
+    "cols"          Required number of columns for the grid, must be a value between 1 and 5.
+    "title"         Optional title of the card group.
+    "separator"     Optional flag to indicate a horizontal line should be added between items on small screens.
+    "gutter"        Gutter between columns in a group, either "0", "1", "2", "3", "4" (default), or "5".
+    "wrapper"       Optional class attributes of the wrapper element, e.g. "p-4 px-xxl-0".
+    "responsive"    Optional flag if the number of columns should be responsive, defaults to "true".
+
+    In addition, the following arguments are passed to the individual cards.
+    "class"         Optional class attribute of the card element, e.g. “w-50”.
+    "color":        Optional theme color of the card, either "primary", "secondary", "success", "danger",
+                    "warning", "info", "light", "dark", or "body". By default, no color is specified.
+    "padding":      Optional padding of the content, either "0", "1", "2", "3" (default), "4", "5", or "auto".
+    "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".
+-->
+
+{{- $cols := .Get "cols" | default "3" -}}
+{{- $gutter := .Get "gutter" | default "4" -}}
+{{- $title := .Get "title" | default "" -}}
+{{- $separator := .Get "separator" | default "" -}}
+{{- $class := .Get "class" | default "" -}}
+{{- $wrapper := .Get "wrapper" | default "" -}}
+{{- $responsive := .Get "responsive" | default true -}}
+{{- $color := .Get "color" | default "" -}}
+{{- $padding := .Get "padding" | default "3" -}}
+{{- $header := .Get "header" | default "" -}}
+{{- $footer := .Get "footer" | default "" -}}
+{{- $orientation := .Get "orientation" | default "" -}}
+
+{{ $inner := .Scratch.Get "inner" }}
+{{ $input := trim .Inner " \r\n" }}
+{{ if $input }}
+    {{ $input = replace $input "\n" "\n  " }}
+    {{ warnf "Unexpected inner content: %s\r\n      %s" .Position $input }}
+{{ end }}
+
+{{- partial "assets/card-group.html" (dict 
+    "page" .Page
+    "cards" $inner
+    "cols" $cols
+    "gutter" $gutter
+    "title" $title
+    "separator" $separator
+    "wrapper" $wrapper
+    "responsive" $responsive
+    "class" $class
+    "color" $color
+    "padding" $padding
+    "header" $header
+    "footer" $footer
+    "orientation" $orientation
+    ) 
+-}}

layouts/shortcodes/card.html

@@ -1,31 +1,39 @@
 <!-- 
-    Displays a Bootstrap card that links to a page. The shortcode supports the following arguments:
+    Displays a Bootstrap card that links to a page. Any inner text is used as description The shortcode supports the
-    "path"          Required path of the page.
+    following arguments:
+    "path"          Optional path of the page. If omitted, specify the title, icon, thumbnail, and body as needed. 
+    "title"         Optional title of the card.
     "class"         Optional class attribute of the card element, e.g. “w-50”.
-    "color":        Optional theme color of the card, either "primary", "secondary", "success", "danger",
+    "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).
+    "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 := .Get "path" }}
+{{ $path := or (.Get "path") "" }}
-{{ $page := .Site.GetPage $path }}
+{{ $page := .Page }}
-{{ if not $page }}
+{{ with $path }}
-    {{ errorf "Invalid or missing value for param 'path': %s" .Position -}}
+    {{ $page = $.Site.GetPage $path }}
-    {{ $error = true }}
+    {{ if not $page }}
+        {{ errorf "Invalid or missing value for param 'path': %s" .Position -}}
+        {{ $error = true }}
+    {{ end }}
 {{ end }}
 
-{{ $class := .Get "class" }}
+{{- $class := partial "utilities/GetArg" (dict "page" . "arg" "class" "merge" true) -}}
 
-{{ $color := "" -}}
+{{- $color := partial "utilities/GetArg" (dict "page" . "arg" "color") -}}
-{{ with .Get "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) -}}
@@ -34,43 +42,76 @@
     {{ end -}}
 {{ end -}}
 
-{{ $header := "full" }}
+{{- $header := partial "utilities/GetArg" (dict "page" . "arg" "header") | default "full" -}}
-{{ with .Get "header" }}{{ $header = . }}{{ end -}}
 {{ $supportedKeywords := slice "full" "publication" "tags" "none" -}}
 {{ if not (in $supportedKeywords $header) -}}
     {{ errorf "Invalid value for param 'header': %s" .Position -}}
 {{ end -}}
 
-{{ $footer := "none" }}
+{{- $footer := partial "utilities/GetArg" (dict "page" . "arg" "footer") | default "none" -}}
-{{ with .Get "footer" }}{{ $footer = . }}{{ end -}}
 {{ if not (in $supportedKeywords $footer) -}}
     {{ errorf "Invalid value for param 'footer': %s" .Position -}}
 {{ end -}}
 
-{{ $padding := "auto" }}
+{{- $padding := partial "utilities/GetArg" (dict "page" . "arg" "padding") | default "auto" -}}
-{{ with .Get "padding" }}{{ $padding = . }}{{ end -}}
 {{ $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 -}}
 
-{{ $orientation := "stacked" -}}
+{{- $gutter := partial "utilities/GetArg" (dict "page" . "arg" "gutter") | default "0" -}}
-{{ with .Get "orientation" }}{{ $orientation = . }}{{ end -}}
+{{ $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 := "rich" -}}
+{{- $layout := partial "utilities/GetArg" (dict "page" . "arg" "layout") | default "rich" -}}
-{{ with .Get "layout" }}{{ $layout = . }}{{ end -}}
 {{ $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 not $error -}}
-    {{- partial "assets/card.html" (dict "path" $path "class" $class "color" $color "padding" $padding "header" $header "footer" $footer "orientation" $orientation) -}}
+    {{- $output := partial "assets/card.html" (dict 
+        "path" $path
+        "title" $title
+        "class" (printf "h-100 %s" $class)
+        "gutter" $gutter
+        "color" $color
+        "padding" $padding
+        "header" $header
+        "footer" $footer
+        "orientation" $orientation
+        "description" $description
+        "icon" $icon
+        "thumbnail" $thumbnail
+        "alt" $alt
+    ) -}}
+
+    {{ with .Parent }}
+        {{ $current := .Scratch.Get "inner" }}
+        {{ if $current }}
+            {{ .Scratch.Set "inner" (print $current $output) }}
+        {{ else }}
+            {{ .Scratch.Set "inner" $output }}
+        {{ end }}
+    {{ else }}
+        {{ print $output | safeHTML }}
+    {{ end }}
 {{ end -}}

layouts/shortcodes/carousel.html

@@ -2,8 +2,10 @@
     Displays a carousel of several responsive images (see the image shortcode for more details). Add inner <img> 
     elements to define individual image slides. The shortcode supports the following arguments:
     "id":           Optional id of the carousel, defaults to "carousel-" with a sequential number.
-    "ratio":        Optional ratio of the image, either "1x1", "4x3", "16x9", or "21x9". Other values are ignored.
+    "ratio":        Optional ratio of the images, either "1x1", "4x3", "16x9", or "21x9". Other values are ignored.
                     Instead, the original aspect ratio of the image is preserved.
+    "portrait":     Optional flag to adjust the ratio from landscape to portrait. The images themselves are not rotated,
+                    only the crop area is adjusted.
     "class":        Optional class attribute of the carousel element, e.g. “w-75”.
 -->
 
@@ -12,10 +14,15 @@
     {{ $id = . }}
 {{ end }}
 
-{{ $ratio := .Get "ratio" -}}
+{{ $class := .Get "class" | default "" -}}
-{{ $class := .Get "class" -}}
+
-{{ $images := .Inner -}}
+{{ $inner := .Scratch.Get "inner" }}
-{{ $items := len (findRE "carousel-item" $images) -}}
+{{ $input := trim .Inner " \r\n" }}
+{{ if $input }}
+    {{ $input = replace $input "\n" "\n  " }}
+    {{ warnf "Unexpected inner content: %s\r\n      %s" .Position $input }}
+{{ end }}
+{{ $items := len (findRE "carousel-item" $inner) -}}
 
 <div id="{{ $id }}" class="carousel slide mb-3{{ with $class }} {{ . }}{{ end }}" data-bs-ride="true">
     <div class="carousel-indicators">
@@ -24,7 +31,7 @@
         {{ end -}}
     </div>
     <div class="carousel-inner">
-        {{ $images }}
+        {{ $inner | safeHTML }}
     </div>
     <button class="carousel-control-prev" type="button" data-bs-target="#{{ $id }}" data-bs-slide="prev">
         <span class="carousel-control-prev-icon" aria-hidden="true"></span>

layouts/shortcodes/collapse.html

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

layouts/shortcodes/command.html

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

layouts/shortcodes/docs.html

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

layouts/shortcodes/example.html

@@ -5,30 +5,24 @@
     Hugo's highlight function. The shortcode supports the following named arguments:
 
     "id"            Optional identifier of the element's container.
-    "lang"          Language used to display the code. Use "hugo" to process Hugo (escaped) shortcodes, default value is "html".
+    "lang"          Language used to display the code, default value is "markdown".
     "show_markup"   If the markup should be output in the HTML, defaults to "true".
     "show_preview"  If the preview should be output in the HTML, defaults to "true".
     "class"         Optional class attributes of the element's container.
 -->
 
-{{- $id := .Get "id" -}}
+{{- $id := .Get "id" | default "" -}}
-{{- $class := .Get "class" -}}
+{{- $class := .Get "class" | default "" -}}
-{{- $lang := .Get "lang" | default "html" -}}
+{{- $lang := .Get "lang" | default "markdown" -}}
 {{- $show_markup := .Get "show_markup" | default true -}}
 {{- $show_preview := .Get "show_preview" | default true -}}
-{{- $input := .Inner -}}
+{{- $content := .InnerDeindent -}}
-{{- $content := .Inner -}}
+{{- if eq $lang "hugo" }}{{ $lang = "markdown" }}{{ end -}}
-
-{{ $preprocess := slice "hugo" "markdown" }}
-{{- if in $preprocess $lang -}}
-    {{- $content = (trim $content "\r\n") | markdownify }}
-    {{ $lang = "markdown" }}
-{{- end -}}
 
 <div class="rounded border mb-3">
     {{- if eq $show_preview true -}}
         <div {{ with $id }}id="{{ . }}"{{ end }} class="rounded-top p-3 {{ with $class }} {{ . }}{{ end }}">
-            {{- $content -}}
+            {{- $content | .Page.RenderString -}}
         </div>
     {{- end -}}
     {{- if eq $show_markup true -}}
@@ -36,7 +30,7 @@
             <small class="font-monospace text-body text-uppercase">{{- $lang -}}</small>
         </div>
         <div class="rounded-bottom syntax-highlight border-none">
-            {{- highlight (trim $input "\r\n") $lang "" -}}
+            {{- highlight (trim $content "\r\n") $lang "" -}}
         </div>
     {{- end -}}
 </div>

layouts/shortcodes/file.html

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

layouts/shortcodes/image.html

@@ -4,8 +4,11 @@
     section of the main config file (defaults to 75). A fallback image is provided for older browsers. The partial
     supports the following arguments:
     "src":          Required relative url of the image, e.g. "img/example.jpg"
-    "ratio":        Optional ratio of the image, either "1x1", "4x3", "16x9", or "21x9". Leave empty to keep the
+    "ratio":        Optional ratio of the image, either "1x1", "3x2", "4x3", "16x9", or "21x9". Leave empty to keep the
                     original aspect ratio of the image.
+    "portrait":     Optional flag to adjust the ratio from landscape to portrait. The image itself is not rotated, only
+                    the crop area is adjusted.
+    "wrapper":      Optional class attributes of the wrapper element, e.g. "mx-auto".
     "class":        Optional class attribute of the inner img element, e.g. "rounded".
     "title":        Optional alternate text of the image.
     "caption":      Optional figure caption.
@@ -13,18 +16,19 @@
 -->
 
 {{- if isset .Params "src" -}}
-    {{ $url := .Get "src" -}}
+    {{ $url := .Get "src" | default "" -}}
-    {{- $validRatios := slice "1x1" "4x3" "16x9" "21x9" -}}
+    {{- $validRatios := slice "1x1" "3x2" "4x3" "16x9" "21x9" -}}
-    {{ $ratio := .Get "ratio" -}}
+    {{ $ratio := .Get "ratio" | default "" -}}
     {{ if $ratio -}}
         {{ if not (in $validRatios $ratio) -}}
             {{ errorf "Invalid value for param 'ratio': %s" .Position -}}
         {{ end -}}
     {{ end -}}
     
-    {{- $class := .Get "class" -}}
+    {{- $class := .Get "class" | default "" -}}
-    {{ $title := .Get "title" -}}
+    {{- $wrapper := .Get "wrapper" | default "" -}}
-    {{ $caption := .Get "caption" -}}
+    {{ $title := .Get "title" | default "" -}}
+    {{ $caption := .Get "caption" | default "" -}}
     {{ $supportedFlags := slice "true" "false" -}}
     {{ $modeParam := "false" -}}
     {{ $mode := false -}}
@@ -34,14 +38,25 @@
     {{ else -}}
         {{ errorf "Invalid value for param 'mode': %s" $modeParam -}}
     {{ end -}}
+    {{ $portraitParam := "false" -}}
+    {{ $portrait := false -}}
+    {{ with .Get "portrait" }}{{ $portraitParam = . }}{{ end -}}
+    {{ if in $supportedFlags $portraitParam -}}
+        {{ if eq $portraitParam "true" }}{{ $portrait = true }}{{ else }}{{ $portrait = false }}{{ end -}}
+    {{ else -}}
+        {{ errorf "Invalid value for param 'portrait': %s" $portraitParam -}}
+    {{ end -}}
     
     {{- partial "assets/image.html" (dict 
         "url" $url
         "ratio" $ratio
+        "outerClass" $wrapper
         "innerClass" $class
         "title" $title
         "caption" $caption
-        "mode" $mode)
+        "mode" $mode
+        "portrait" $portrait
+        "page" .Page)
     -}} 
 {{ else -}}
     {{ errorf "Missing value for param 'src': %s" .Position -}}

layouts/shortcodes/img.html

@@ -2,34 +2,39 @@
     Renders a carousel item with a responsive image (see the image shortcode for more details). The shortcode
     supports the following arguments:
     "src":          Required relative url of the image, e.g. "img/example.jpg"
-    "ratio":        Optional ratio of the image, either "1x1", "4x3", "16x9", or "21x9". Other values are ignored.
+    "ratio":        Optional ratio of the image, either "1x1", "3x2", "4x3", "16x9", or "21x9". Other values are
-                    Instead, the original aspect ratio of the image is preserved.
+                    ignored. Instead, the original aspect ratio of the image is preserved.
+    "portrait":     Optional flag to adjust the ratio from landscape to portrait. The image itself is not rotated, only
+                    the crop area is adjusted.
     "caption":      Optional carousel slide caption.
 -->
 
-{{- $src := .Get "src" -}}
+{{ if not .Parent }}
-{{ $caption := .Get "caption" -}}
+    {{ errorf "The img shortcode should be contained within a carousel shortcode: %s" .Position }}
-{{- $ratio := "" -}}
-{{ with .Parent -}}
-    {{ with .Get "ratio" }}{{ $ratio = . }}{{ end -}}
 {{ else }}
-    {{ with .Get "ratio" }}{{ $ratio = . }}{{ end -}}
+    {{- $src := .Get "src" | default "" -}}
-{{ end -}}
+    {{- if $src -}}
+        {{- $caption := .Get "caption" | default "" -}}
+        {{- $ratio := partial "utilities/GetArg" (dict "page" . "arg" "ratio") -}}
+        {{- $portrait := partial "utilities/GetArg" (dict "page" . "arg" "portrait") | default false -}}
+        {{- $active := eq .Ordinal 0 -}}
+        {{- $output := partial "assets/carousel-item" (dict 
+            "page" .Page
+            "active" $active
+            "src" $src
+            "caption" $caption
+            "ratio" $ratio
+            "portrait" $portrait                
+        ) }}
 
-{{- if $src -}}
+        {{ $current := .Parent.Scratch.Get "inner" }}
-    <div class="carousel-item {{ if eq .Ordinal 0 }}active{{ end }}">
+        {{ if $current }}
-        {{ partial "assets/image.html" (dict "url" $src "ratio" $ratio "innerClass" "d-block w-100") }}
+            {{ .Parent.Scratch.Set "inner" (print $current $output) }}
-        <div class="carousel-caption gradient"></div>
+        {{ else }}
-        {{ with $caption }}
+            {{ .Parent.Scratch.Set "inner" $output }}
-            <div class="carousel-caption d-none d-md-block">
-                <div class="d-flex justify-content-center align-items-end h-100 w-100 p-4">{{ . }}</div>
-            </div>
         {{ end }}
-    </div>
+    
-{{ else -}}
-    {{ with .Parent -}}
-        {{ errorf "Missing value for param 'src': %s" .Position -}}
     {{ else -}}
-        {{ errorf "Missing value for param 'src': %s" .Position -}}
+        {{ errorf "Missing value for param 'src': %s" .Parent.Position -}}
     {{ end -}}
 {{ end -}}

layouts/shortcodes/kbd.html

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

layouts/shortcodes/link.html

@@ -1,12 +1,14 @@
 <!-- 
     Generates a link for a given named link or url. The shortcode supports a single unnamed parameter, or various named
-    parameters. The unnamed parameter is recognized as a named link if it does not contain any "/", otherwise it is
+    parameters. The unnamed parameter is recognized as a url if it starts with "http", else it is treated as either a
-    treated as a url. Any inner text is rendered as the link title, otherwise it uses the host name (for external links)
+    named link or internal reference (in that order). Any inner text is rendered as the link title, otherwise it uses
-    or page name (for internal links). The shortcode supports the following named arguments:
+    the host name (for external links), link title (for internal links), or anchor name (for any local references
-    "name"          Optional name of the link maintained in the "links" section of the site's parameters. If omitted,
+    containing a `#`). The shortcode supports the following named arguments:
-                    the "url" argument should be provided instead.
+    "href"          Required reference to either an external link (if it starts with http), a named link (if it can be
-    "url"           Optional url of the link, including the scheme ("http" or "https"). If omitted, the "name" argument
+                    found in params.links), or internal reference. External and internal references may include an
-                    should be provided instead.
+                    anchor "#".
+    "name"          Alias of href.
+    "url"           Alias of href.
     "cue"           Optional flag to indicate if an external link should show a visual cue, defaults to setting
                     "main.externalLinks.cue" in the site's parameters.
     "tab"           Optional flag to indicate if an external link should open in a new tab, defaults to setting
@@ -17,42 +19,91 @@
 -->
 
 {{- $error := false -}}
+{{ $href := "" }}
 {{ $name := "" }}
 {{ $url := "" }}
+{{ $class := "" }}
 {{ $case := true }}
 {{ $cue := site.Params.main.externalLinks.cue }}
 {{ $tab := site.Params.main.externalLinks.tab }}
+{{ $text := trim .Inner " \r\n" | .Page.RenderString | safeHTML }}
+{{- $anchor := "" -}}
 
 {{ if .IsNamedParams }}
-    {{ $name = .Get "name" }}
+    {{- $href = .Get "href" | default "" -}}
-    {{ $url = .Get "url" }}
+    {{- $name = .Get "name" | default "" -}}
-    {{ $cue = .Get "cue" | default site.Params.main.externalLinks.cue }}
+    {{- $url = .Get "url" | default "" -}}
-    {{ $tab = .Get "tab" | default site.Params.main.externalLinks.tab }}
+    {{- $cue = .Get "cue" | default site.Params.main.externalLinks.cue -}}
-    {{ $case = .Get "case" | default true }}
+    {{- $tab = .Get "tab" | default site.Params.main.externalLinks.tab -}}
-{{ else if strings.Contains (.Get 0) "/" }}
+    {{- $case = .Get "case" | default true -}}
-    {{ $url = .Get 0 }}
+    {{- $class = .Get "class" | default "" -}}
 {{ else }}
-    {{ $name = .Get 0 }}
+    {{ $href = .Get 0 }}
 {{ end }}
 
-{{ if not (or $name $url) }}
+{{- $href = or (or $href $name) $url -}}
-    {{ errorf "Expected param 'name' or 'url': %s" .Position -}}
+{{ if not $href }}
+    {{ errorf "Expected param 'href': %s" .Position -}}
     {{ $error = true -}}
 {{ end }}
 
-{{ if $name }}
+{{- if hasPrefix $href "http" -}}
-    {{ $url = index site.Params.links $name }}
+    {{ $url = $href }}
-    {{ if not $url }}
+{{- else if not (strings.Contains $href "/") -}}
-        {{ errorf "Cannot find link '%s': %s" $name .Position -}}
+    {{ $url = index site.Params.links $href }}
-        {{ $error = true -}}
+{{- end -}}
+
+{{ if not $url }}
+    {{- $href = strings.TrimPrefix "./" $href -}}
+    {{- if strings.Contains $href "#" }}
+        {{ $segments := split $href "#" }}
+        {{- if ne (len $segments) 2 }}
+            {{ errorf "Malformed path, expected one anchor '#' only: '%s' at %s" $href .Position -}}
+        {{ else }}
+            {{- $url = index $segments 0 -}}            
+            {{- $anchor = index $segments 1 -}}            
+            {{ if not $url }}
+                {{ $url = .Page.File.Path }}
+            {{ end }}
+        {{ end }}
+    {{ else }}
+        {{- $url = $href -}}
     {{ end }}
 {{ end }}
 
-{{ $text := trim .Inner " \r\n" | markdownify | safeHTML }}
+{{- $isExternal := ne (urls.Parse (absURL $url)).Host (urls.Parse site.BaseURL).Host -}}
+{{- if not $isExternal -}}
+    {{- $url = strings.TrimSuffix "/" $url -}}
 
-{{- $class := .Get "class" -}}
+    {{- $ref := "" -}}
+    {{- if not $ref -}}
+        {{- $ref = .Page.GetPage $url -}}
+    {{- end -}}
 
-{{- if not $error -}}
+    {{- if not $ref }}
-    {{ partial "utilities/link.html" (dict "destination" $url "text" $text "cue" $cue "tab" $tab "case" $case "class" $class) }}
+        {{- $segments := split $url "/" -}}
+        {{- if and (hasPrefix $url "/")  (gt (len $segments) 1) -}}
+            {{- $prefix := index $segments 1 -}}
+            {{- $page := .Page -}}
+            {{ with index (where site.Sites "Language.Lang" $prefix) 0 }}
+                {{- $path := printf "/%s" (strings.TrimPrefix (printf "/%s/" $prefix) $url) }}
+                {{- $ref = .GetPage $path -}}
+            {{ end }}
+        {{- end -}}
+    {{- end -}}
+
+    {{- if not $ref -}}
+        {{- errorf "Cannot find page: '%s' at %s" $href .Position -}}
+        {{- $error = true -}}
+    {{- end -}}
 {{- end -}}
 
+{{ with $anchor }}
+    {{ $url = printf "%s#%s" $url .}}
+{{ end }}
+{{- if not $error -}}
+    {{ partial "utilities/link.html" (dict "destination" $url "text" $text "cue" $cue "tab" $tab "case" $case "class" $class "page" .Page) }}
+{{- end -}}
+
+
+

layouts/shortcodes/mark.html

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

layouts/shortcodes/nav-item.html

@@ -5,50 +5,66 @@
     "show"          Optional flag to indicate an item should be shown.
 -->
 
-{{- $id := .Ordinal -}}
+{{ $current := "" }}
-{{- $parent := printf "nav-%d" .Parent.Ordinal -}}
+{{ $error := false -}}
-{{- with (.Parent.Get "id") -}}
-    {{- $parent = . -}}
-{{- end -}}
 
-{{- $fade := false -}}
+{{ if not .Parent }}
-{{- if eq (.Parent.Get "fade") "true" -}}
+    {{ errorf "The nav-item shortcode should be contained within a nav shortcode: %s" .Position }}
-    {{- $fade = true -}}
+{{ else }}
-{{- end -}}
+    {{- $id := .Ordinal -}}
-
+    {{- $parent := printf "nav-%d" .Parent.Ordinal -}}
-{{- $header := .Get "header" -}}
+    {{- with (.Parent.Get "id") -}}
-{{- if not $header -}}
+        {{- $parent = . -}}
-    {{- if .Parent -}}
-        {{- errorf "Missing value for param 'header': %s" .Parent.Position -}}
-    {{- else -}}
-        {{- errorf "Missing value for param 'header': %s" .Position -}}
     {{- end -}}
-{{- end -}}
 
-{{- $class := .Get "class" -}}
+    {{- $fade := false -}}
-{{- $body := trim .Inner " \r\n" -}}
+    {{- if eq (.Parent.Get "fade") "true" -}}
+        {{- $fade = true -}}
+    {{- end -}}
 
-{{- $supportedFlags := slice "true" "false" -}}
+    {{- $header := .Get "header" | default "" -}}
-{{- $showParam := "false" -}}
+    {{- if not $header -}}
-{{- $show := false -}}
+        {{- errorf "Missing value for param 'header': %s" .Parent.Position -}}
-{{- with .Get "show" }}{{ $showParam = . }}{{ end -}}
+    {{- end -}}
-{{- if in $supportedFlags $showParam -}}
-    {{- if eq $showParam "true" }}{{ $show = true }}{{ else }}{{ $show = false }}{{ end -}}
-{{- else -}}
-    {{- errorf "Invalid value for param 'show': %s" $showParam -}}
-{{- end -}}
 
-{{- $disabledParam := "false" -}}
+    {{- $class := .Get "class" | default "" -}}
-{{- $disabled := false -}}
+    {{- $body := trim .Inner " \r\n" | .Page.RenderString -}}
-{{- with .Get "disabled" }}{{ $disabledParam = . }}{{ end -}}
-{{- if in $supportedFlags $disabledParam -}}
-    {{- if eq $disabledParam "true" }}{{ $disabled = true }}{{ else }}{{ $disabled = false }}{{ end -}}
-{{- else -}}
-    {{- errorf "Invalid value for param 'disabled': %s" $disabledParam -}}
-{{- end -}}
 
-<div class="tab-pane{{ if $show }} active {{ if $fade}}show{{ end }}{{ end }} {{ if $fade}}fade{{ end }}" id="{{ $parent }}-{{ $id }}" 
+    {{- $supportedFlags := slice "true" "false" -}}
-    role="tabpanel" aria-labelledby="{{ $parent }}-btn-{{ $id }}" tabindex="0" data-header="{{ $header }}" {{ if $show }}data-show-id="{{ $id }}"{{ end }} 
+    {{- $showParam := "false" -}}
-    data-has-content="{{ gt (len $body) 0 }}" {{ if $disabled }} data-disabled-id="{{ $id }}"{{ end }}>
+    {{- $show := false -}}
-    {{ $body | markdownify | safeHTML }}
+    {{- with .Get "show" }}{{ $showParam = . }}{{ end -}}
-</div>
+    {{- if in $supportedFlags $showParam -}}
+        {{- if eq $showParam "true" }}{{ $show = true }}{{ else }}{{ $show = false }}{{ end -}}
+    {{- else -}}
+        {{- errorf "Invalid value for param 'show': %s" $showParam -}}
+    {{- end -}}
+
+    {{- $disabledParam := "false" -}}
+    {{- $disabled := false -}}
+    {{- with .Get "disabled" }}{{ $disabledParam = . }}{{ end -}}
+    {{- if in $supportedFlags $disabledParam -}}
+        {{- if eq $disabledParam "true" }}{{ $disabled = true }}{{ else }}{{ $disabled = false }}{{ end -}}
+    {{- else -}}
+        {{- errorf "Invalid value for param 'disabled': %s" $disabledParam -}}
+    {{- end -}}
+
+    {{ $output := partial "assets/nav-item" (dict 
+        "id" $id
+        "parentID" $parent
+        "fade" $fade
+        "header" $header
+        "class" $class
+        "body" $body
+        "show" $show
+        "disabled" $disabled
+        )
+    }}
+
+    {{ $current := .Parent.Scratch.Get "inner" }}
+    {{ if $current }}
+        {{ .Parent.Scratch.Set "inner" (print $current $output) }}
+    {{ else }}
+        {{ .Parent.Scratch.Set "inner" $output }}
+    {{ end }}
+{{ end }}

layouts/shortcodes/nav.html

@@ -12,8 +12,8 @@
     {{ $id = . }}
 {{ end }}
 
-{{- $class := .Get "class" -}}
+{{- $class := .Get "class" | default "" -}}
-{{ $type := .Get "type" -}}
+{{ $type := .Get "type" | default "" -}}
 {{ $supportedNavTypes := slice "tabs" "pills" "underline" -}}
 {{ if $type }}
     {{ if not (in $supportedNavTypes $type) -}}
@@ -41,7 +41,13 @@
     {{- errorf "Tabs do not support vertical layout" -}}
 {{- end -}}
 
-{{- $inner := .Inner -}}
+{{ $inner := .Scratch.Get "inner" }}
+{{ $input := trim .Inner " \r\n" }}
+{{ if $input }}
+    {{ $input = replace $input "\n" "\n  " }}
+    {{ warnf "Unexpected inner content: %s\r\n      %s" .Position $input }}
+{{ end }}
+
 {{- $items := findRE "data-header=\"(.+?)\"" $inner -}}
 {{- $showVal := findRE "data-show-id=\"(.+?)\"" $inner -}}
 {{- $showID := -1 -}}
@@ -71,7 +77,7 @@
 
 {{- if $hasContent -}}
     <div class="tab-content {{ if eq $type "tabs" }}border border-top-0 p-3{{ else if $vertical }}ms-3{{ else }}mt-3{{ end }}">
-        {{- $inner -}}
+        {{- $inner | safeHTML -}}
     </div>
 {{- end -}}
 {{ if $vertical }}</div>{{ end }}

layouts/shortcodes/navbar.html

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

layouts/shortcodes/persona.html

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

layouts/shortcodes/release.html

@@ -10,11 +10,10 @@
 -->
 
 {{- $error := false -}}
-{{- $version := .Get "version" -}}
+{{- $version := .Get "version" | default "" -}}
 {{- $inline := false -}}
 
-{{- $state := "new" -}}
+{{- $state := .Get "state" | default "new" -}}
-{{- with .Get "state" }}{{ $state = . }}{{ end -}}
 {{- $supportedStates := slice "new" "deprecated" -}}
 {{- if not (in $supportedStates $state) -}}
     {{- errorf "Invalid value for param 'state': %s" .Position -}}
@@ -84,7 +83,7 @@
     {{- $error = true -}}
 {{- end -}}
 
-{{- $class := .Get "class" -}}
+{{- $class := .Get "class" | default "" -}}
 
 {{- if not $error -}}
     {{- if not $inline }}<div class="pb-3">{{ end -}}

layouts/shortcodes/spinner.html

@@ -29,6 +29,6 @@
 
 {{ with $class }}<div class="{{ . }}">{{ end }}
     <div class="spinner-{{ if $grow }}grow{{ else }}border{{ end }} text-{{ $color }}" role="status">
-        <span class="visually-hidden">{{ trim .Inner " \r\n" -}}</span>
+        <span class="visually-hidden">{{ trim .Inner " \r\n" | plainify -}}</span>
     </div>
 {{ if $class }}</div>{{ end }}

layouts/shortcodes/sub.html

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

layouts/shortcodes/sup.html

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

layouts/shortcodes/table.html

@@ -8,7 +8,7 @@
     {{ $responsive = (slice "table-responsive") -}}
 {{- end -}}
 
-{{- $input := .Inner | markdownify }}
+{{- $input := .Inner | .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\"" -}}

layouts/shortcodes/timeline.html

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

layouts/shortcodes/toast.html

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

layouts/shortcodes/tooltip.html

@@ -2,7 +2,7 @@
     Displays a tooltip for a link. The shortcode supports the following arguments:
     "color":        Optional theme color of the element, either "primary" (default), "secondary", "success",
                     "danger", "warning", "info", "light", or "dark".
-    "title"         Required text to display in the tooltip.
+    "title"         Required plain text to display in the tooltip.
     "href"          Required address for the button or hyperlink.
     "placement"     Optional position of the tooltip: "top" (default), "bottom", "left", or "right". 
     "class"         Optional class attribute of the tooltip's button element.
@@ -11,7 +11,7 @@
 {{ $error := false }}
 {{ $type := "link" -}}
 
-{{ $title := trim .Inner " \r\n" -}}
+{{ $title := trim .Inner " \r\n" | plainify -}}
 {{ if not $title -}}
     {{ errorf "Missing inner element text: %s" .Position -}}
     {{ $error = true }}
@@ -25,9 +25,9 @@
     {{ $error = true }}
 {{ end -}}
 
-{{ $tooltip := .Get "title" -}}
+{{ $tooltip := .Get "title" | default "" -}}
 
-{{ $href := .Get "href" -}}
+{{ $href := .Get "href" | default "" -}}
 {{ if not $href -}}
     {{ errorf "Missing value for param 'href': %s" .Position -}}
     {{ $error = true }}
@@ -41,8 +41,10 @@
     {{ $error = true }}
 {{ end -}}
 
-{{- $class := .Get "class" -}}
+{{- $class := .Get "class" | default "" -}}
 
 {{ if not $error }}
-    <div class="d-inline-flex">{{- partial "assets/button.html" (dict "type" $type "title" $title "color" $color "tooltip" $tooltip "href" $href "placement" $placement "class" $class) -}}</div>
+    <div class="d-inline-flex">
+        {{- partial "assets/button.html" (dict "type" $type "title" $title "color" $color "tooltip" $tooltip "href" $href "placement" $placement "class" $class) -}}
+    </div>
 {{ end }}

layouts/tags/list.html

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