Slideshow Shortcode

The slideshow shortcode allows you to create an interactive image slider with optional captions.
It supports multiple images, custom width, and navigation buttons. Images can come from page resources (i.e. same folder as the markdown file) or the assets folder.

Usage

1
2
3
4
5
6
7
8
{{< slideshow
    slidewidth="90%"
    caption="Journey through the Alps"
    image1="/images/img_mountains.jpg" caption1="Sunrise over the peaks"
    image2="/images/img_forest.jpg" caption2="Morning mist"
    image3="/images/img_lights.jpg" caption3="Reflections on the lake"
    image4="/images/avatar.png" caption4="Avatar"
>}}

Parameters

**Table:** Slideshow Shortcode Parameters
Parameter	Required	Default	Description
slidewidth	No	100%	Width of the slideshow container (supports %, px, or rem)
caption	No	-	Optional main caption displayed below the slideshow
image1..image20	No	-	Paths to images to include in the slideshow
caption1..caption20	No	-	Optional captions for each corresponding image

Note: You can include up to 20 images by default. The slideshow automatically skips any empty image parameters.

To increase the number of images that can be included in a slideshow.Go to config/params.toml and edit this:
TOML
1
2
3
    
 [slideshow]
  maxSize=20 