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 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! |
|