Scaled image macro
Introduction
The snipscale macro package consists of snipsnap macros to make it easier to create a photo album in snipsnap.
The scaled-image macro will scale one or more images, provides a thumbnail with link and an optional caption.
Examples
Single image
This is how you do a single image with one caption.
You can choose not to scale the linked image with "original".
You can also refer to an image attachment of another snip with the "snip" attribute.
You can upload a zip file with multiple images and use the images in the zip file.
Multiple images
These are multiple images with no caption. You can use the "range" attribute to select multiple attached images.
Or, you can use a range with numbers to select images.
Multiple, comma delimited ranges.
You can upload a zip file with multiple images and display images in the zip file.
Use the filename as caption, with caption=auto
Captions
You can add captions to your images. The simplest option is to use the caption parameter of a single image:
If the caption is very long, you may put the caption in the body:
You may want to use the filename as caption, with the "caption=auto" parameter.
If you have a large collection of images and you want to specify captions for each image in the collection, you may use this pattern in the body:
Opening images in separate window
To display images in a new window, you can add the 'target' parameter. If this is set, a target attribute will be added to the link. Example:
Making an album
To display multiple images with their own caption, also use these macro's:
- image-container - Groups images into a div section.
- scaled-image-settings - Sets common attributes for following scaled-image macro's, saves you some typing.
Macro scaled-image
Attributes
- img - filename of the image attachment or file contained in zip file.
- thumb - integer as the maximum size of the thumbnail, the string "original" to indicate no scaling
- size - integer as the maximum size of the thumbnail, the string "original" to indicate no scaling, the string "nolink" to indicate that no link to image should be created.
- alt - alt text of the image
- float - the side where to float the image: "right" or "left"
- zip - filename of zip file attachment.
- snip - name of snip that contains the attachment of the image file or zip file.
- range - the string "all" for all images in zip file, comma delimited integers or integers with from-to.
- target - the name of the window target to be used in the link
- caption - if this is "auto", it will display filenames as caption, if no caption is given in the body, otherwise this string will be used as caption.