Updated for Sparkle 2.1
A basic image gallery can be up and running with a few clicks.
One way to create a gallery is to add it from the Sparkle interface (toolbar, Insert menu or the element popup) and then add the images. A quicker way is to drag the images from the Finder directly to the Sparkle window and let Sparkle create a gallery.
When adding images to the gallery you need to pay attention to the image storage method. By default images are stored in the document and this is usually the safest choice, however many large images will make the Sparkle document very big. The other option is to store images “In Original Location” which isn’t compatible with moving the document to a different Mac (for example via iCloud), but limits the document size.
There are several configuration options.
“Transition” controls the image transition effect, currently either slide or cross fade. The “Transition Speed” is expressed in seconds and represent the time for the transition effect.
The “Thumbnails” option is applicable only with 5 or more images and adds a quick shortcut for gallery navigation. The thumbnails can be positioned above or below the gallery and can display 5 to 15 elements.
Please report any shortcoming in this documentation and we’ll fix it as soon as possible!
The thumbnail “Vertical Distance” parameter sets the distance between the thumbnails and the gallery, while “Thumbnail margin” controls the size of the margin around the thumbnail, which is transparent except for the current thumbnail, whose color is controlled by the “Selected” color swatch.
The “Left/right arrows” option enables or disables the arrow buttons that allow user navigation for the gallery. You will typically disable user navigation for automatic slideshow. Arrows can be customized in color and position (through the “Outside / Inside” slider).
“Dots” are an alternative for gallery navigation, displaying small clickable dots under the gallery. Dots navigation can coexist with thumbnails, but you will typically choose just one of the two modes.
“Wrap around” enables gallery navigation loop, it restarts from the first image when pressing “next” (right arrow) on the last and, vice-versa, from the last when pressing “previous” on the first. It is particularly useful for a looping slideshow.
Enabling “Automatic slideshow” each image is shown for the specified amount of time (expressed in seconds) before passing to the next, without user interaction.