Man Linux: Main Page and Category List

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
              begining   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_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.

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
              generate 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
              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 (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  overriden  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 begining 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 begining each
              section [--Ps].  Default is 0 (disabled).
       separate_sections = <0/1>
              Add a horizontal line at the begining 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)