llgalrc(5)							File Formats Manual							llgalrc(5)

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.

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_file-
	      name 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.

Location and name of generated files:
       local_llgal_dir = "subdirectory name"
	      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 = "filename prefix"
	      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 = "filename prefix"
	      Prefix used to determine slide-image filenames from original images (in case of --sx or --sy).  Default is "scaled_".
       thumbnail_image_filenameprefix = "filename prefix"
	      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 gener-
	      ate slide captions.  Default is "captions".
       user_scaled_image_filenameprefix = "filename prefix"
	      Additional prefix of user-provided scaled images.  Default is my.
       user_thumbnail_image_filenameprefix = "filename prefix"
	      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 @.

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.
       thumbnail_height_max = <pixels>
	      Maximal height of thumbnails [--ty <n>].	Default is 75.	Changing this  value  does  not  affect  the  maximal  width  (see  thumb-
	      nail_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 (link to the movie).
       FIL_link_to_target = <0/1>
	      Make file thumbnails links point to the file instead of the corresponding slide.	Default is 1 (link to the file).
       DIR_link_to_target = <0/1>
	      Make directory thumbnails links point to the movie instead of the corresponding slide.  Default is 1 (link to the directory).
       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 (link to the link target).

Slides:
       make_no_slides = <0/1>
	      Make no slides [-s].  Default is 0 (make slides).
       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).

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 "REMOVE THIS LINE IF  LLGAL
	      SHOULD NOT REMOVE THIS FILE".
       make_caption_from_filename = <0/1>
	      Generate captions from filenames without their extension [--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 = ,-separated strings of +-separated strings
	      Generate captions from image comment tag [--cc].	Default is "" (disabled).
       make_caption_from_image_comment = <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 "&nbsp;&nbsp;&nbsp;(%0n/%t)".  Slide counter may be disabled by setting to  an  empty  string
	      [--nc].

Text:
       index_title_default = "string"
	      Default title of the gallery.  May be overridden with [--title <s>] or TITLE: in the captions file.  Default is "Index of pictures".
       parent_gallery_link_text = "string"
	      Label of the link to the parent directory.  Default is "Back to parent gallery".
       prev_gallery_link_text = "string"
	      Label of the link to the previous gallery.  Default is "Previous gallery ".
       next_gallery_link_text = "string"
	      Label of the link to the next gallery.  Default is "Next gallery ".
       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&gt;&gt;".
       next_slide_link_text = "string"
	      Label of the link from a slide to the next one.  Default is "Next&gt;&gt;".
       MVI_link_text = "string"
	      Text prefixing the filename when generating link text for movies without a captions file.  Default is "Open movie ".
       FIL_link_text = "string"
	      Text prefixing the filename when generating link text for files without a captions file.	Default is "Download file ".
       DIR_link_text = "string"
	      Text prefixing the filename when generating link text for directories without a captions file.  Default is "Open subgallery ".
       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 "Scaled image ".
       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 "Film Tile".
       over_scaled_text = "string"
	      Text shown when the mouse pointer is over a scaled image in a slide.  Default is "Click to see full size ".
       over_thumbnail_text = "string"
	      Text shown when the mouse pointer is over a thumbnail.  Default is "Click to enlarge ".
       over_index_link_text = "string"
	      Text shown when the mouse pointer is over a link from a slide to the index.  Default is "Return to the index".
       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 "Previous slide ".
       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 "Next slide ".
       show_size_unit = "string"
	      Unit to be used when printing sizes [--asu <s>] Default is "kB".
       timestamp_format_in_caption = timestamp format
	      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 "created with <a href="http://home.gna.org/llgal">llgal</a>".

What files to insert in the gallery:
       image_extensions = "|-separated strings"
	      Extensions that are matched when searching images Default is "jpg|jpeg|png|gif|tif|tiff|bmp".
       movie_extensions = "|-separated strings"
	      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".

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).

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).

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  THUMBNAILS  AND
	      SCALED IMAGES GENERATION 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 THUMBNAILS AND
	      SCALED IMAGES GENERATION 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".

SEE ALSO

       llgal(1)

       The llgalrc template file provided within the documentation directory.

AUTHOR

       Brice Goglin

								   NOVEMBER 2006							llgalrc(5)