Album
view release on metacpan or search on metacpan
lib/Album/Tutorial.pm view on Meta::CPAN
The javascript for keyboard navigation.
=item $image
Image pages only: The actual image.
=item $lbot
Image pages only: The text below the image, left.
=item $rbot
Image pages only: The text below the image, right.
=item $contents
Index pages only: The table with all the images for this page.
=item $tag
Journal pages only: The tag for this page.
=item $journal
Journal pages only: The journal for this page.
=back
=head3 External style sheets
When 'album' is run with B<--extcss> it will create a directory 'css'
and, in this directory, the css style sheets for all types of pages
that 'album' will generate. Existing files in this directory will
B<not> be overwritten, so it is safe to change the templates to your
liking. When 'album' is run again to process images, it will use the
external style sheets if they are available.
To obtain good results, the style sheets must match the formats.
'album' will try to verify this by reading the first line of the style
sheets and the formats, and verify that it contains a version
indication of the form
ALBUM-FMT-VERSION: <major>.<minor> (for formats)
ALBUM-CSS-VERSION: <major>.<minor> (for style sheets)
For all style sheet - format pairs, the major numbers must be the
same.
Older versions of 'album' always created external style sheets. As a
consequence, if you upgrade to the newer version, you'll get a fatal
error the first time you run 'album'.
*************************************************************************
Existing style sheet ... is not compatible with this version.
It has probably been created by an older version of this program, or it
has been modified manually.
If you did not change any style sheets, just remove the css directory and
try again.
If you did modify the style sheets move them away to a backup location,
run the program with '--extcss', and apply your changes to the new style
sheets.
*************************************************************************
We apologise for the inconvenience.
=head2 Keyboard navigation
While browsing the album, some actions can be performed from the keyboard.
The C<Enter> key will go to an enlarged version of the image, if available.
The C<Space> key will advance to the next page.
The C<Backspace> key will advance to the previous page.
Key C<d> will go to the index page.
Key C<u> will go up, i.e., the reverse of the C<Enter> key.
Key C<j> will go to the journal entry of the current image.
=head2 Additional notes
The B<--clobber> command line option will force regeneration of all
medium and thumbnail images, and HTML pages. It will not force
re-import of the 'large' images. To completely rebuild everything
save info.dat, remove all the files in the album directory (including
.cache), restore info.dat and re-run the 'album' program.
The digital camera import is designed for cameras that adhere to the
ISO DCF standard. Handling of MPG movies and voice images is probably
specific for my Sony DSC-V1.
When importing images from different camera's, there's an extremely
small chance that the EXIF information would lead to identical file
names. This can only happen if the pictures were taken at the exact
same time (according to the camera's notion of time!), and have the
same internal sequence number.
When parsing C<info.dat>, Album treats anything up to a known file
name extension to be part of the file name. In general, this means
that you can safely enter file names with whitespace and other
uglyness.
Known file name extensions are C<jpg>, C<jpeg>, C<png>, and C<gif> for
images, C<mpg>, C<mpeg>, C<mov>, and C<avi> for movies, and C<html>
and C<htm> for links.
=head1 AUTHOR AND CREDITS
Johan Vromans (jvromans@squirrel.nl) wrote this module.
=head1 COPYRIGHT AND DISCLAIMER
This program is Copyright 2004,2007 by Squirrel Consultancy. All
rights reserved.
This program is free software; you can redistribute it and/or modify
it under the terms of either: a) the GNU General Public License as
( run in 0.596 second using v1.01-cache-2.11-cpan-c966e8aa7e8 )