Basics
How do I use llgal?
Place some images and movies in a directory and simply run
llgal inside it.
It will generate an index file and some slides.
How do I modify a gallery?
You may add or remove some images in the working directory, and re-run
llgal with different options to update the gallery contents
or layout.
If an image has been modified, you may have to force the regeneration
of thumbnails and scaled images with
-f.
How do I reduce the size of the slides?
If your images are large, you should try
llgal --sy 480
to limit the height of the image to 480 pixels in slides.
Note that a click on the slide will actually open the
original full-size image.
How do I set the title and captions?
You may set the title on the command line through:
llgal --title "My title"
To change captions, the easiest way is to ask
llgal
to generate captions first, with:
llgal --gc
Then, you may edit the captions file (
.llgal/captions)
to update all captions.
You then run
llgal again, it will detect the existence
of the captions file and use it.
llgal
Captions and special slides
How do I generate captions from images?
When generating the captions file with
--gc,
llgal
may automatically generate several fields for each image.
Available fields are
image comments,
filename and
image timestamp.
llgal will try to generate each field and concat them
to create the caption.
To generate captions from the filename only, run:
llgal --gc --cf
To generate captions from the image timestamp (extracted from
Exif tags when existing) and filename:
llgal --gc --cf --ct
To generate captions from the image comments (extract from
JFIF or Exif), timestamp and filename:
llgal --gc --cc --cf --ct
These commands will generate a captions file that you might then
use when generating the gallery.
You might also directly generate captions during the gallery
generation through something like:
llgal --cc --ct
Note that if a captions file exists, command line options about
captions generation are omitted.
How do I add a slide containing some text or link?
After generating the captions file with
--gc, you might add
a special slide containing only some text by inserting the following
line in the file:
TXT: the text that is shown in the slide ---- the caption under the slide
Regenerating the gallery will then add this slide.
The following line add a special slide with a link instead of plain text:
LNK: the url ---- the label of the link in the slide ---- the caption under the slide
If you do not want those slide containing a single link or text to appear like this,
you may use
-L so that they will be listed as a text line in the index
and they will not appear in any slide at all (except the TXT slides).
How do I add new entries to a captions file?
Re-running
llgal with
--gc will rescan the existing files and
add the missing ones at the end of the captions file.
You then re-run
llgal to update the gallery regarding the new captions file.
How do I keep the list of images involved in a gallery?
The captions file may also be used to keep track of the contents of a gallery.
Even if you do not add some captions or title in the captions file, you may use
it to list the exact set of images that you want to appear in the gallery.
Managing slides
How do I change the order of the slides?
The order of the slides might be changed with the
sort option
on command-line.
For instance,
--sort=iname sorts by name case insensitively,
while
--sort=revdate sorts by date, in reverse order.
It is also possible to set the order by changing captions positions
in the captions file.
How do I select which files are included in a gallery?
By default,
llgal does only include images and movies in the
gallery.
It is possible to force it to use all existing files in the directory
(except
*.html and
.*) with:
llgal -A
It is also possible to exclude some files with
--exclude regexp
where
regexp is a Perl regexp. For instance, to exclude all
AVI files starting with
MVI:
llgal --exclude 'MVI.*\.AVI'
File that were excluded might be reincluded by using the similar
--include option.
Finally, it is always possible to exclude files by generating a captions
file and removing some entries.
Note that the captions file is a good way to keep the list of images that
are involved in the gallery, even if you do not want any caption.
Layout
How do I change the layout of the slides and index?
The main layout of generated webpages is based on HTML templates
(
indextemplate.html and
slidetemplate.html)
and a CSS style-sheet (
llgal.css).
It is possible to place modified versions of these files in the
.llgal
directory (or in
$HOME/.llgal/) to change the layout.
How do I change the text that llgal generates in slides and index?
All text that appears in generated slides might be configured through configuration
options.
One day, there might be a full internationalization support through
gettext.
How do I set a thumbnail for a video or a subgallery?
All non-image slides and thumbnails are usually basic text.
It is possible to force
llgal to use a special thumbnail or scaled image
by adding a special file in the local
.llgal directory.
mythumb_foo.jpg will be used as a thumbnail for the entry called
foo
while
myscaled_bar.jpg will be used as a scaled image for
bar.
The extension may be any image extension that
llgal recognizes.
How do I get image EXIF tags in my slides?
Most images contains some meta-data called EXIF tags that may be useful to some people.
llgal can display a table of some EXIF values under each image slide.
The name of the tags correspond to what the
exiftool program uses
(see for instance
exiftool --list).
llgal --exif Aperture,FocalLength,ImageHeight,ImageWidth,FileModifyDate
Configuration
How do I save/restore a configuration?
If you like using the same options for all your galleries and don't
want to remember the option, you may ask
llgal to generate
a configuration file with:
llgal --gencfg my_llgalrc
This file might be used later with
llgal --config my_llgalrc
It may also be placed in the user llgal configuration file
$HOME/.llgal/llgalrc.
The configuration file contains a list of configuration lines.
All command line options, and even much more, are available by
this way.
It is possible to pass any configuration option on the
command line with
--option.
For instance, to set which file extensions
llgal will
match to find movies, use:
llgal --option 'movie_extensions="mpe?g|avi|mov|ogm"'
Multiple directories and subdirectories
How do I include several subdirectories in a unique gallery?
If your photos are organized in several subdirectories of the working directory,
you can use
-P to take the photos from them instead of from the working
directory.
llgal -P subdir1 -P subdir2 -P subdir3
If you want these subdirectories to appear as sections,
llgal can generate
a horizontal line between each subdirectory and add a title in the index with
--Ps.
Additionaly,
llgal can display the title as regular text in the index instead
of a text thumbnail with
-L.
llgal -P subdir1 -P subdir2 -P subdir3 --Ps -L
As usual, these horizontal lines and titles are generated as TXT and LINE entries
are processed from the captions file. Thus, you may start by creating a captions file,
edit it and then generate the gallery.
llgal -P subdir1 -P subdir2 -P subdir3 --Ps --gc
vi .llgal/captions
llgal -L
How do I include all subdirectories in a unique gallery?
Instead of passing
-P for each subdirectory, you may ask
llgal to include all images from all subdirectories.
llgal --Pall
How do I add a new subdirectory contents to a gallery?
You may a the list of files of a subdirectory to an existing gallery if its
captions file if available, by regenerating it:
llgal -P newsubdir --gc
The directory contents is added at the end of the captions file, which may
be reordered by the user.
The gallery may then be regenerated from the new captions file by re-running
llgal.
How do I create multiple subgalleries at once?
If your directory contains subdirectories, you might use
-S
to create slides linking to these subgalleries.
With
-R, the subgalleries will even be generated right after
the main gallery.
The list of subgalleries might be changed by modifying
DIR:
entries in the captions file.
How do I modify a single gallery in a set of subgalleries?
Galleries that were created recursively (with
-R) may be
linked with their parents, children and brothers.
If you plan to regenerate some galleries independently, you should
take care of saving the configuration with
--gencfg or
generating a captions file.
All linking information is stored inside these files.
Regeneration is then easy (with
--config in the first case).
Miscellaneous
How do I add keyboard shortcuts to my gallery?
The HTML accesskey feature may be use to navigate in
llgal's
galleries with keyboard shortcuts. But as this feature is very browser
dependant and might conflict with some regular shortcuts in certain
browsers, it is not enabled by default in
llgal.
Access keys can be configured by changing the templates and adding
accesskey=<letter> to links.
For instance, changing the
slidetemplate.html code to the
following one will define
p,
n and
i as
accesskeys to previous slide, next slide and return to the index.
It means that
Alt+p,
Alt+n and
Alt+i will
be the actual shortcuts in Mozilla Firefox.
<a href="<!--PREV-SLIDE-->" accesskey=p><!--PREV-SLIDE-LINK-TEXT--></a>
<a href=">!--INDEX-FILE-->" accesskey=i><!--INDEX-LINK-TEXT--></a>
<a href="<!--NEXT-SLIDE-->" accesskey=n><!--NEXT-SLIDE-LINK-TEXT--></a>
Note that the slide template might be modified by getting a copy with
in the local or user-wide configuration directory using
--gt.