FAQ

Appearance Troubleshooting Miscellaneous
Q: How do I eliminate/change the word ‘Comment:’ before the comments that appear on slide image pages?
A: Many of the built-in text elements are specified in a ‘language pack’ file. These files are named ‘texts_xx.properties’ (where ‘xx’ is the two-character language code) and are located in the BluPlusPlus folder. Using a text editor, open the appropriate language pack file and find the line that reads ‘comment=Comment:’. To eliminate the ‘Comment:’ prefix, edit this line to read ‘comment=’; to change the prefix, replace ‘Comment:’ with the desired text.
Q: I don’t want the shadow bar above the footer to appear; can I omit it?
A: Yes! To omit the shadow bar one must edit the css file of the style(s) being used. Locate the ‘shadow’ selector and add ‘visibility: hidden;’. See the example of an altered css file for an example.
Q: Is it possible to remove the captions from below thumbnail images on an index page and/or from below slide images on a slide image page?
A: Yes! To remove thumbnail captions, on the BPP Index tab, type the word “none” (without quotes) into the value for Thumbnail Caption Content and/or Folder Caption Content. To remove slide image captions, on the BPP Slide tab, type the word “none” (without quotes) into the value for Slide Caption Content.
Q: I do not want my albums to display EXIF data; can I make the “i” icon disappear?
A: Yes! To omit the “i” icon uncheck the "Extract photographic information (EXIF)” checkbox on the JAlbum Advanced-General tab.
Q: I get a “phantom vertical scrollbar” (see image) on my album pages; can I get rid of it?
A:

Yes, but at a price. Internet Explorer has some idiosyncratic ways of rendering scrollbars. Ideally, a vertical or horizontal scrollbar only appears when it is needed, and not otherwise. By default, IE does NOT behave this way! By default, IE will display both a vertical AND horizontal scrollbar when EITHER a vertical or horizontal scrollbar is required. In JAlbum photo albums, since vertical scrollbars are often needed, this creates the annoying presence of an unnecessary horizontal scrollbar.

There is a workaround for this which BluPlusPlus implements. In the CSS file (the style file), the html selector has its overflow-x property given the value ‘auto’ while the overflow-y property is omitted entirely (see the arc.css file listing). This makes the horizontal and vertical scrollbars appear/disappear when they should. However, the “phantom vertical scrollbar” is an undesirable byproduct.

If one prefers to suppress the “phantom vertical scrollbar” and live with a horizontal scrollbar when it is not needed, add ‘overflow-y:auto;’ to the style files (see here for more information about altering style files).

Hopefully, Microsoft will fix this bug in Internet Explorer.

Q: Can I change the name of the HOME link in the top blue bar?
A: Yes. The text ‘HOME’ is set in the language file in the main BluPlusPlus folder. Edit the language file of your choice (‘texts_en.properties’ for English). DO NOT edit the ‘texts.properties’ file! Change the line that begins ‘home=’ (‘home=HOME in the English file) to ‘home=whatever_you_want_instead_of_HOME’
Q: My generated album pages are way too wide and require significant horizontal scrolling; how can I eliminate this problem?
A:

This problem usually occurs because the amount of text in the top bar is greater than what easily fits without creating a horizontal scrollbar. There are two ways to resolve this issue:

  • Shorten the album title and other text that appears in the top bar.
  • Use the text truncation feature to force BluPlusPlus to truncate long tob bar texts
Q: BluPlusPlus and/or JAlbum aren’t working as expected. Help!
A: Be sure that you are using the latest version of BluPlusPlus and JAlbum. The opening page of this documentation gives the latest versions of each. To be absolutely sure, visit the JAlbum web site for the latest version of JAlbum and for the latest version of BluPlusPlus.
Q: I get an “out-of-memory” error when generating an album or clicking “Preview” on the Frames tab—why?
A: Particularly complex XBorderFilters can cause this problem. The only fix at this time is to reduce the number of filters used within a given .xbp file.
Q: Why doesn’t the watermark feature correctly with JAlbum on the Mac?
A:

With the release of Java version 1.4.2 and Mac OS 10.3.5, the watermark feature should work correctly. If you have an older version of either Java or the Mac OS, see below.

As of Java version 1.4.1, it is not possible to control the opacity of the watermark on a Mac (the Java implementation somehow broke this). If one really wants an semi-transparent watermark, it is possible to force JAlbum to use an earlier version of Java. See this post on the JAlbum forum. Note that everytime a new version of JAlbum is installed, this fix will need to be repeated.

Q: Why don’t my custom movie icons work?
A:

Both Mac OS X and Windows XP have a “feature” called “extension hiding”. This feature is designed to spare novices the need to worry about file name extensions and help avoid difficulties caused by accidently changing a file name extension.

Unfortunately, this can cause problems with the custom movie icon feature. If extension hiding is enabled (it is enabled by default), a file called ‘niceicon.jpg’ will appear to the user to be called only ‘niceicon’, and when the suffix ‘.thumb’ is added per the instructions, the actual file name becomes ‘niceicon.thumb.jpg’, although to the user it appears that the filename is ‘niceicon.thumb’.

To get around this problem, follow the instructions for your operating system:

  • Mac OS X—Click once on the custom movie icon file. Select ‘Get Info’ from the File menu. Be sure that the ‘Hide extension’ check box is NOT checked. Rename the file by editting the file name in the box. Close the ‘Get Info’ dialogue box.
  • Windows XP—Open the folder containing the custom movie icon file. Select ‘Folder Options’ from the ‘Tools’ menu and click on the ‘View’ tab. Be sure that the ‘Hide extensions for know file types’ check box is NOT checked. Click ‘OK’ and rename the file per the instructions.
Q: Why do I get thumbnail images and slide images of files that aren’t pictures?
A:

JAlbum will process files with filetypes specified in ‘filetypes.xml’ (found in the JAlbum program directory). This results in albums with “thumbnail images” and “slide images” that are not images at all, but are other types of files. By editing ‘filetypes.xml’ JAlbum can process additional file types.

JAlbum knows not to treat certain other files as images, such as ‘header.inc’, ‘footer.inc’. For some types of files, such as audio files, background image (‘wallpaper’) image files, and any other file that can be processed via the meta.properties file, one can begin the file name with an period (‘.’); JAlbum never treats files or folders that begin with ‘.’ as images. Note that Mac users cannot begin filenames with a period. See this FAQ for more information.

Q: What is the ‘filetypes.xml’ file and how do I edit it?
A:

‘filetypes.xml’ is a JAlbum file (located in the JAlbum program folder) that lists the filetypes that JAlbum will recognize and process. Any file with an extension not listed in ‘filetypes.xml’ will be ignored. ‘filetypes.xml’ also associates each file type with an icon.

To add an additional filetype to a kind of file already contained in ‘filetypes.xml’, add a line of the form <ext>extension</ext> to the bottom of an existing list of filetypes within ‘filetypes.xml’ .

To add a completely new filetype, add the following lines to the bottom of ‘filetypes.xml’ right above the ‘</filetypes>’ tag:

<type name="filetype description" icon="icon filename">
    <ext>extension</ext>
</type>

If you are using a new icon to associate with this filetype, be sure to place the icon file in the JAlbum ‘res’ folder (NOT the BPP ‘res’ folder!)

   
Q: Do JAlbum and BPP support languages other than English?
A: Yes! The list of supported languages is here.
Q: When I click on the HOME link in the top BPP bar, I get taken out of my browser or get taken to a folder listing; why?
A: The HOME link is only present if a value is given to the externalHomePath user variable on the BPP-General tab. When a generated album is viewed on a local computer (as opposed to a web site), this link often takes one out of a browser entirely or to a folder listing. This is expected behavior because BPP cannot know exactly what you consider ‘HOME’! If the generated album is on a website, including an ‘index.htm’ or ‘index.html’ file in the folder containing the generated album will result in end users being taken to that index page when HOME is clicked.
Q: I am tired of redoing all the settings I have specified each time I generate a new album in BPP; is there a way to save those settings?
A: Yes! Settings can be saved in a project file.
Q: I have files/folders in my album structure that I do NOT want processed by JAlbum; is there a way to have JAlbum ignore some files and/or folders?
A:

Yes. There are two ways of accomplishing this:

  • JAlbum’s Advanced-General tab has an ‘ignore pattern’, which accepts a “regular expression” defining the filenames JAlbum is to skip. By default, BluPlusPlus skips files beginning with ‘.’ (dot, or period), or‘_’ (underscore); it also ignores files with extension ‘mp3’, ‘wav’, ‘wma’, ‘rm’, and ‘mid’. Thus, the easiest way to have a file not processed is to begin the file name with dot or underscore, or have the file have one of the extensions specified above.
  • JAlbum’s main window allows one to include or exclude individual files and/or folders by right-clicking (ctrl-clicking on a Mac) the image or folder and selecting ‘include’ or ‘exclude’ from the contextual menu. The ‘albumfiles.txt’ should be saved to the top level album input folder.
Q: There are so many BluPlusPlus files! Do I really need them all? Can I delete any unneeded files?
A: BluPlusPlus is smart about this. The output album folder will not contain unneeded files (except possibly for a very few). The few unneeded files that remain are probably not worth worrying about.
Q: I’d like to edit a bsh file but I can’t open it!
A: bsh files do not have a ‘natural’ program to open them on either a PC or a Mac. However, they can be opened and editted easily on both platforms.
Q: Why are the CSS files in the ‘styles’ folder in the BPP distribution folder zero length files?
A: JAlbum uses the CSS files within the ‘styles’ folder to populate the ‘skin’ drop-down menu on the main window. Then, during album generation, JAlbum copies the selected skin to the file entitled ‘styles.css’ within the ‘res’ folder of the output folder. BPP has the wonderful feature of being able to change styles in subfolders, which means that BPP must make ALL used styles (not just the one chosen on the main window) available to the generated album. The real CSS files are found within the ‘styles’ folder inside the ‘res’ folder.
Q: The JAlbum documentation refers to “closeups”—what are they?
A: “closeups” are what this documentation refers to “slide images”, i.e. the images on the slide pages
Q: Where are all the JAlbum support files on the Mac OS X version of JAlbum?
A: Beginning with JAlbum 7.0, on OS X JAlbum is an “application bundle”. All of the JAlbum support files are inside the application. To access these support files, control-click (or right-click) on the JAlbum application and choose “Show Package Contents” from the contextual menu that pops up. Then, open the “Contents” folder and then open the “Resources” folder inside. Finally, open the “Java” folder. The JAlbum support files are in there!