llgalrc - Configuration file for llgal
Contents
Captions:
captions_removal_line="string"
This line will be added to the caption file llgal will generate when called with --gc. If the
user doesn't want llgal to remove this caption file when called with --clean, he just needs to
remove this line from the file. Default is "REMOVETHISLINEIFLLGALSHOULDNOTREMOVETHISFILE".
make_caption_from_filename=<0/1>
Generate captions from filenames. The extension is removed, except for directories. [--cf].
Default is 0 (disabled).
make_caption_from_extension=<0/1>
Generate captions from filenames with their extension. 0 (disabled).
make_caption_from_image_comment=,-separatedstringsof+-separatedstrings
Generate captions from image comment tag [--cc]. Default is "" (disabled).
make_caption_from_image_timestamp=<0/1>
Add image timestamp to generated captions [--ct]. Default is 0 (disabled).
show_dimensions=<0/1>
Show image dimensions [-a, -ad]. Default is 0 (disabled).
show_size=<0/1>
Show file sizes [-a, -as]. Default is 0 (disabled).
slide_counter_format="format"
Change the format of the counter on the slides. %n is replaced with the slide number, %0n gets
leading zeros, and %t is replaced with the number of slides. Default is
" (%0n/%t)". Slide counter may be disabled by setting to an empty string [--nc].
Index:
index_cellpadding=<pixels>
Cellpadding in the index table [-p<n>]. Default is 3.
list_links=<0/1>
Display links and text as regular text instead of thumbnails in the main gallery thumbnail index
[-L]. Default is 0 (disabled).
pixels_per_row=<pixels>
Pixels per row of thumbnails in index [-wx<n>]. Default is 0 (unlimited).
thumbnails_per_row=<pixels>
Thumbnails per row in index [-w<n>]. Default is 5.
thumbnails_dimensions_from_css=<0/1>
Do not output any absolute thumbnails size in HTML code and assume the CSS style sheet will take
care of it (in table.index [td.thumb [img]]). Default is 0 (disabled).
thumbnail_height_max=<pixels>
Maximal height of thumbnails [--ty<n>]. Default is 75. Changing this value does not affect the
maximal width (see thumbnail_width_max).
thumbnail_width_max=<pixels>
Maximal width of thumbnails [--tx<n> ]. If 0 is used, the width is unlimited. If not 0, all
thumbnails are padded to the given width. Default is 113. Changing this value does not affect
the maximal height (see thumbnail_height_max).
show_caption_under_thumbnails=<0/1>
Write captions under thumbnails [-u]. Default is 0 (disabled).
show_film_effect=<0/1>
Show film effect [--fe]. Default is 0 (disabled).
MVI_link_to_target=<0/1>
Make movie thumbnails links point to the movie instead of the corresponding slide. Default is 1
(linktothemovie).
FIL_link_to_target=<0/1>
Make file thumbnails links point to the file instead of the corresponding slide. Default is 1
(linktothefile).
DIR_link_to_target=<0/1>
Make directory thumbnails links point to the movie instead of the corresponding slide. Default is
1 (linktothedirectory).
LNK_link_to_target=<0/1>
Make link thumbnails point to the link instead of the corresponding slide. It is similar to using
LNKNOSLIDE: entries instead of LNK:. Default is 1 (linktothelinktarget).
Location And Name Of Generated Files:
local_llgal_dir="subdirectoryname"
The name of the subdirectory where llgal generated files will be stored. This option is only
available in system- and user-wide configuration files. Default is .llgal/.
index_filename="filename"
Name of the generated index file [-i<s>]. Default is index.
slide_filenameprefix="filenameprefix"
Prefix of generated HTML slide filenames. Default is "slide_". Note that this prefix is used to
decide what HTML to delete when --clean is passed. Setting this option to an empty string will
make llgal remove all HTML files.
scaled_image_filenameprefix="filenameprefix"
Prefix used to determine slide-image filenames from original images (in case of --sx or --sy).
Default is "scaled_".
thumbnail_image_filenameprefix="filenameprefix"
Prefix used to determine thumbnail filenames from original images. Default is "thumb_".
captions_filename="filename"
Name of the caption file that will be generated when llgal is called with --gc, or will be
automatically used if it exists to generate slide captions. Default is "captions".
user_scaled_image_filenameprefix="filenameprefix"
Additional prefix of user-provided scaled images. Default is my.
user_thumbnail_image_filenameprefix="filenameprefix"
Additional prefix of user-provided thumbnails. Default is my.
path_separator_replacement="char"
Character to use to replace / in the thumbnail/scaled of subdir images. Default is @.
Location Of Llgal Files If Available On The Web
css_location="url"
The location of the CSS on the web instead of a local one [--uc<url>]. If ending with a slash,
css_filename will be appended.
filmtile_location="url"
The location of the filmtile image on the web instead of a local one [--ui<url>]. If ending with
a slash, filmtile_filename will be appended.
index_link_image_location="url"
The location of the index link image on the web instead of a local one [--ui<url>]. If ending
with a slash, index_link_image_filename will be appended.
prev_slide_link_image_location="url"
The location of the prev slide link image on the web instead of a local one [--ui<url>]. If
ending with a slash, prev_slide_link_image_filename will be appended.
next_slide_link_image_location="url"
The location of the next slide link image on the web instead of a local one [--ui<url>]. If
ending with a slash, next_slide_link_image_filename will be appended.
Name
llgalrc - Configuration file for llgal
Names Of Generic Llgal Files:
captions_header_filename="filename"
Name of the captions header file that is inserted at the beginning of generated captions files.
Default is captions.header.
css_filename="filename"
Name of the CSS file. Default is llgal.css.
filmtile_filename="filename"
Name of the film tile image. Default is tile.png. Note that it must match the one that is used
in the CSS file.
index_link_image_filename="filename"
Change image name for link to the index. Default is index.png.
next_slide_link_image_filename="filename"
Change image name for link to the next slide. Default is next.png.
previous_slide_link_image_filename="filename"
Change image name for link to the previous slide. Default is prev.png.
indextemplate_filename="filename"
Name of the HTML index template. Default is indextemplate.html.
slidetemplate_filename="filename"
Name of the HTML slide template. Default is slidetemplate.html.
Recursion:
recursive=<0/1>
Run recursively in subdirectories [-R]. Default is 0 (disabled).
link_subgalleries=<0/1>
Add links between subgalleries [--Rl]. Default is 0 (disabled).
parent_gallery_link=<0/1>
Add links to the parent directory [--parent]. Default is 0 (disabled).
Sections:
section_dir="subdir"
Include subdirectory contents in the gallery [-P<subdir>]. This option may be used several
times. Subdirectory path must be given relatively to the working directory. Default is to use
the content of the working directory.
recursive_sections=<0/1>
Add all subdirectories to the list of sections [--Pall]. Default is 0 (disabled).
entitle_sections=<0/1>
Add the subdirectory name as a title at the beginning each section [--Ps]. Default is 0
(disabled).
separate_sections=<0/1>
Add a horizontal line at the beginning of each section in the index [--Ps]. Default is 0
(disabled).
See Also
llgal(1)
The llgalrc template file provided within the documentation directory.
Slides:
make_no_slides=<0/1>
Make no slides [-s]. Default is 0 (makeslides).
make_slide_filename_from_filename=<0/1>
Use filenames as slide filenames [-n]. Default is 0 (disabled).
make_slide_filename_from_extension=<0/1>
Also use extension in slide filename when generated from filename. Default is 0 (disabled).
slide_dimensions_from_css=<0/1>
Do not output any absolute image size in the HTML code and assume the CSS style sheet will take
care of it (in table.slide td.image-slide img). Default is 0 (disabled).
slide_width_max=<pixels>
Maximal width of slides [--sx<n>]. Default is 0 (unlimited).
slide_height_max=<pixels>
Maximal height of slides [--sy<n>]. Default is 0 (unlimited).
text_slide_width=<pixels>
Default width of text slides. Default is 400.
text_slide_height=<pixels>
Default height of text slides. Default is 300.
index_link_image=<0/1>
Use an image instead of a text label for the link to the index [--li]. Default is 0 (disabled).
prev_slide_link_image=<0/1>
Use an image instead of a text label for the link to the previous slide [--li]. Default is 0
(disabled).
next_slide_link_image=<0/1>
Use an image instead of a text label for the link to the next slide [--li]. Default is 0
(disabled).
prev_slide_link_preview=<0/1>
Use a thumbnail preview instead of a text label for the link to the previous slide [--lt].
Default is 0 (disabled).
next_slide_link_preview=<0/1>
Use a thumbnail preview instead of a text label for the link to the next slide [--lt]. Default is
0 (disabled).
link_between_last_and_first=<0/1>
Generate links between last and first slides or galleries. Default is 1 (enabled).
make_slide_title_from_caption=<0/1>
Generate slide titles from captions [-k]. Default is 0 (disabled).
show_exif_tags=<tag1,tag2,...>
Display a table of EXIF tags under each image slide [--exif]. The tags are given with their name
in exiftool-list and separated with a comma.
show_all_exif_tags=<0/1>
Display a table of all available EXIF tags under each image slide [--exif].
slide_link_to_full_image=<0/1>
Link scaled image in slides to full unscaled images [--nf]. Default is 1 (enabled).
Text:
index_title_default="string"
Default title of the gallery. May be overridden with [--title <s>] or TITLE: in the captions
file. Default is "Indexofpictures".
parent_gallery_link_text="string"
Label of the link to the parent directory. Default is "Backtoparentgallery".
prev_gallery_link_text="string"
Label of the link to the previous gallery. Default is "Previousgallery".
next_gallery_link_text="string"
Label of the link to the next gallery. Default is "Nextgallery".
index_link_text="string"
Label of the link from a slide to the index. Default is "Index".
prev_slide_link_text="string"
Label of the link from a slide to the prev one. Default is "Prev>>".
next_slide_link_text="string"
Label of the link from a slide to the next one. Default is "Next>>".
MVI_link_text="string"
Text prefixing the filename when generating link text for movies without a captions file. Default
is "Openmovie".
FIL_link_text="string"
Text prefixing the filename when generating link text for files without a captions file. Default
is "Downloadfile".
DIR_link_text="string"
Text prefixing the filename when generating link text for directories without a captions file.
Default is "Opensubgallery".
alt_full_text="string"
Text shown as an image alternative for full-size images in slides. Default is "".
alt_scaled_text="string"
Text shown as an image alternative for scaled images in slides. Default is "Scaledimage".
alt_thumbnail_text="string"
Text shown as an image alternative for thumbnails in the index. Default is "Thumbnail".
alt_film_tile_text="string"
Text shown as an image alternative for the film tile in the index. Default is "FilmTile".
over_scaled_text="string"
Text shown when the mouse pointer is over a scaled image in a slide. Default is "Clicktoseefullsize".
over_thumbnail_text="string"
Text shown when the mouse pointer is over a thumbnail. Default is "Clicktoenlarge".
over_index_link_text="string"
Text shown when the mouse pointer is over a link from a slide to the index. Default is "Returntotheindex".
over_prev_slide_link_text="string"
Text shown when the mouse pointer is over a link from a slide to the previous one. Default is
"Previousslide".
over_next_slide_link_text="string"
Text shown when the mouse pointer is over a link from a slide to the next one. Default is "Nextslide".
show_size_unit="string"
Unit to be used when printing sizes [--asu<s>] Default is "kB".
timestamp_format_in_caption=timestampformat
Change the strftime format used when generating captions from image date [--ct<s>]. Default is
"%Y-%m-%d%H:%M:%S".
credits_text="string"
Credits text at the bottom of the index Default is "createdwith<ahref="http://bgoglin.free.fr/llgal">llgal</a>".
Various:
additional_configuration_file="filename"
Additional configuration file that is parsed immediately (before processing the following lines)
[--config<s>]. This option may be used several times.
additional_template_dir="path"
Additional template directories [--templates]. This option may be used multiple times.
codeset="codeset"
Codeset to be set in HTML headers [--codeset<s>].
language="locale"
Language to be used for generated text in HTML pages [--lang<s>]. If set, the LANGUAGE
environment variable might prevent this option from working.
scaled_create_command="string"
Command to use to create scaled images for slides. Default is "convert--scale<MAXW>x<MAXH>--<IN><OUT>". See THUMBNAILSANDSCALEDIMAGESGENERATION for details.
thumbnail_create_command="string"
Command to use to create thumbnails for the index. Default is "convert--scale<MAXW>x<MAXH>--<IN><OUT>". See THUMBNAILSANDSCALEDIMAGESGENERATION for details.
force_image_regeneration=<0/1>
Force regeneration of thumbnails and scaled images [-f]. Default is 0 (disabled).
verbose=<0/1>
Print notice messages [-v]. Default is 0 (disabled).
www_access_rights=<0/1>
Make all generated files world readable [--www]. Default is 0 (disabled).
www_extension="string"
Extension of generated webpages [--php]. Default is "html".
What Files To Insert In The Gallery:
image_extensions="|-separatedstrings"
Extensions that are matched when searching images Default is "jpg|jpeg|png|gif|tif|tiff|bmp".
movie_extensions="|-separatedstrings"
Extensions that are matched when searching movies Default is "mpg|mpeg|avi|mov|ogm|wmv".
add_all_files=<0/1>
Add all files to the list of entries, not only images and movies [-A]. Default is 0 (disabled).
add_subdirs=<0/1>
Add subdirectories to the list of entries [-S]. Default is 0 (disabled).
exclude="string"
Exclude files whose name matches [--exclude<s>]. This option may be used several times. Dot
beginning files and html files are excluded by default.
include="string"
Include files whose name matches and were previously excluded [--include<s>]. This option may be
used several times. The order of includes and excludes is respected.
sort_criteria="string"
Sort criteria when scanning files in the working directory. Default is "name".
