Scaled album macro

Introduction

The scaled-album macro will create an album of scaled images. It puts floating images inside a div.

Examples

Album of attached images.

Album of attached images

This is the default behaviour: use all attached images in an album with default sizes. Default caption is "auto", which displays filename without extension.

{scaled-album}
Floating album

You can create a floating album with a width of 50%:

{scaled-album:album-float=right:album-width=50%}

You can also refer to the image attachments of another snip with the "snip" attribute.

{scaled-album:snip=scaled-image-test}

You can upload a zip file with multiple images and use the images in the zip file.

{scaled-album:zip=album.zip}
No captions

Disable captions with caption=none

{scaled-album:caption=none}

Select ranges

Just like the scaled-image macro, you can select ranges.

{scaled-album:range=1-2|thumb=120|size=original} {scaled-album}

Multiple, comma delimited ranges.

{scaled-album:range=1-2,4-6,10-20|thumb=120|size=original} {scaled-album}

You can upload a zip file with multiple images and display images in the zip file.

{scaled-album:range=1-2,4-6,10-20|zip=album.zip|thumb=120|size=original} {scaled-album}

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:

{scaled-album:target=myimages|thumb=120|size=640} {scaled-album}

Macro scaled-album

Attributes

  • 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 inside the div container: "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" (this is the default), it will display filenames as caption. If set to "none", no caption are displayed. Otherwise, the body of the macro is used as caption.
  • album-float - the side where to float the div container to: "right" or "left".
  • album-width - the width of the div container, can be pixels (px) or percentage (%).