Caption templates

1 Thumbnail caption

Used both on the index page, and in the thumbnail strip on image pages. Set up the template with: Thumbnail caption template

Default

<span class="nr">${imageNum}</span> <strong>${fileTitle}</strong> <small>${comment}</small>

2 Image caption

Used below the image on the Info panel. Set up the template with: Image caption template

Default

<h2>${fileLabel}</h2><div class="comment">${comment}</div>

In Turtle skin Caption is a HTML formatted text attached to a picture, compiled from the caption template, and using jAlbum variables. Historically jAlbum didn't use the word "caption", and used comment for images and description for folders – this is why Turtle skin has started using it. With version 12, however jAlbum started using the Caption button in Explore mode for both the comment and the description. Please note, this is not the same as Turtle's caption, which is a HTML-formatted, compiled string, containing both the "comment" and "title" by default.

In the caption templates you can use jAlbum variables, e.g.:

${Exif.author}: ${comment} / ${keywords}

Beanshell scripts, e.g.:

<%= (fileSize > 1000000)? "Large file!" : "" %>

and jAlbum control blocks, e.g.:

<ja:if exists="originalPath"><a href="${originalPath}">Download</a></ja:if>

You can use simple HTML formatting, e.g.

<h4>${fileTitle}</h4><p class="comment">${comment}</p>

Turtle has one variable added above the other jAlbum variables, called fileLabel . This equals to the file title, but in case it's missing, it falls back to the file name. This is used in the Image caption template in order to avoid the empty captions.

Editing titles

Editing the caption

The two most important image-specific variables are the Title and Caption . You can edit them straight in the Explore mode, but also in Edit mode. Use TAB and Shift-TAB to move between the thumbnails easily in Explore (thumbnails) mode.

If you want to use captions, never use the file name for this purpose! The file names should work on any file system with any encoding, therefore it's better to avoid using apostrophes ', ", punctuation :#!? and accented characters. Some servers are able to handle them, but if you want to make sure your album works on any device, please leave the file name simple, containing only web-safe characters: A-Z, a-z, 0-9, .-_ and use jAlbum's Title and Caption fields!

The Title supposed to be a simple text containing any characters, but no HTML tags allowed here.

The Caption might contain a lenghtier block of text and HTML formatting. Please don't use complex HTML blocks in order to avoid rendering problems.

Thumbnail caption placement

As tooltip

Below

You can choose to place caption of thumbnails Below or As tooltip (default) on the Thumbnails page.