A meta.properties File Example

The album folder structure for this example is shown below. The album created can be viewed here.

By default, JAlbum will process all files in a folder as if they are intended to be part of the album, which causes thumbnail and slide ‘images’ as well as slide image pages to be created for audio files, wallpaper files, and pretty much anything else. To work around this, by default BPP ignores files beginning with an underscore (‘_’) and with a period (‘.’), as well as files with extension ‘.mp3’, ‘.wav’, ‘.wma’, ‘.rm’, and ‘.mid’ . This FAQ describes how to add other extensions to the list of files JAlbum ignores. Hence the wallpaper and audio image files in this example all begin with ‘_’.

We want our album to have the following characteristics:

• the ‘my_vacation’ album is to have a custom title, header and footer, and the ‘_my_vacation.mp3’ file is to play when the album is first opened
• the ‘at_the_river’ subalbum is to have a custom title and footer
• the image ‘leaving.jpg’ is to have a custom title and description, and the audio file ‘_leaving.mp3’ should play when the slide page for the image ‘leaving.jpg’ is opened
• the image ‘river.jpg’ is to have a custom title and description, and the audio file ‘_river.mp3’ should play when the slide page for the image ‘river.jpg’ is opened
• we want all image audio files in one place and have hence placed both of the audio files associated with the images into a subfolder (called ‘_image_audio_file _folder’) of the main album folder
• the index page of the at_the_river subalbum is to have a background image (‘wallpaper’) using image file ‘_index_background.jpg’
• the slide pages of the at_the_river subalbum are to have a background image (‘wallpaper’) using image file ‘_slide_background.jpg.’
• the slide and index pages of the ‘day_3’ subalbum are NOT to have custom background images
• the ‘day_3’ subalbum is to have a different style (bluish.css)
• the index thumbnail for the ‘day_3’ subalbum’ is to have the custom image icon ‘sunset.jpg’ (i.e., the same image as the slide in the subalbum)

The contents of the three meta.properties files are given below:

Notes:
(A) Since the file ‘_my_vacation.mp3’ is in the same folder as the meta.properties file, just the file name needs to be specified
(B) Since the file ‘_leaving.mp3’ is in the folder BELOW the meta.properties file, the subfolder name must be specified

Notes:
(C) Since the file ‘river.mp3’ is in a subfolder of the folder one level up, one writes ‘../_audio_files/_river.mp3’; the ‘../’ indicates that we are moving up a level, and then the ‘_audio_files/_river.mp3’ indicates the subfolder and file name

Notes:
(D) BPP will clear a previously specified background image file by specifying these variables with no values.