Provided by: jigl_2.0.1+20060126-4_all bug

NAME

       jigl - Generates a static html photo gallery from one or more directories of images

SYNOPSIS

       jigl [ options ] [ directory ] [ directory ... ]

DESCRIPTION

       jigl  (pronounced jiggle) is a perl script that generates a static html photo gallery from
       one  or  more  directories  of  gif/jpg/png  images.  It  supports  themes  and  is   very
       customizable.  It includes the ability to display comments and EXIF info for each image in
       a simple clean layout.

OPTIONS

       These programs follow the usual GNU command line syntax, with long options  starting  with
       two  dashes  (`-').  A summary of options is included below.  For further details, see the
       documentation in /usr/share/doc/jigl/

       -h, --help
              Show summary of options.

       -v, --version
              Show version of program.

       -cg --create-gallerydat
              Create a gallery.dat file and exit

       -uec --use-exif-comment
              Use the comment field in the exif header (if it exists) as the slide comment.  This
              will  overwrite  the  description that is written in a gallery.dat file. If used in
              conjunction with the -cg option, the comment field will be saved in the gallery.dat
              file.  Default is DISABLED. (can be negated).

       -rs --replace-spaces <a|y|n>
              Replaces spaces with underscores "_" in filenames.

              a -- (default) Ask the user if they want to

              y -- replace and do no ask

              n -- do not replace and do no ask

       -it --index-title <string>
              Sets  the title and title-bar of the index.html page to string. This is meant to be
              used when you are not using a gallery.dat file.

       -iw --index-width <1-255>
              How many thumbnails per line you want on the index page.  Default is 5

       -ir --index-row <0-255>
              The number of thumbnail rows you want on the index page before a new index page  is
              generated.  If  0,  there  is  no  limit and only one index page will be generated.
              Default is 0

       -ut --update-templates
              Remove the template files from the local directory and  the  global  default  theme
              directory. This will cause new default template files to be generated in the global
              default theme directory.  Default is DISABLED. (can be negated).

       -ft --force-thumb
              Force thumbnail regeneration (can be negated)

       -fs --force-slide
              Force slide regeneration (can be negated)

       -skb --slide-kbsize
              Print the file size of the slide on the index page under the  thumbnails.   Default
              is ENABLED (can be negated)

       -sxy --slide-xysize
              Print  the  slide  dimensions  under  the thumbnails on the index page.  Default is
              ENABLED (can be negated)

       -uo --use-original
              Use the original images for the slides - do not  generate  a  scaled  slide  image.
              Default is DISABLED. (can be negated)

       -lo --link-original
              Link  to  the  original  images  from  the  slides.   Default  is DISABLED. (can be
              negated).

       -aro --auto-rotate-originals
              Do a lossless rotation of the original images. This option is only useful  if  your
              digital  camera  sets  the  Orientation  field  in the EXIF header. All EXIF header
              information will be kept and the Orientation field will be updated to  reflect  the
              rotation.  Default is DISABLED. (can be negated).

       -gs --generate-slides
              Gererate  slide  pages  and  link them to the thumbnails.  If this option is turned
              off, slides will not be generated  and  the  info  pages  will  be  linked  to  the
              thumbnails  instead.  If  neither slide or info pages are generated, the thumbnails
              will not link to anything.  Default is ENABLED. (can be negated).

       -gi --generate-info
              Generate info pages and link them to the "info" link on the slide  pages.  If  this
              option  is  turned off, info pages will not be generated and the "info" link on the
              slide pages will dissapear.  If no slides are generated, then the info  pages  will
              be linked directly to the thumbnails.  Default is ENABLED. (can be negated).

       -sy --slideY <int>
              Maximum size of slide image in the Y direction. If the height of the original image
              is greater than this value the slide will be scaled to this  value.  Otherwise  the
              slide is simply a copy of the original.  Default is 480 pixels

       -ty --thumbY <int>
              Size of the scaled thumbnail image in the Y direction Default is 75 pixels

       -iy --infoY <int>
              Maximum  size  of  the info image in the Y direction. This is simply a scale of the
              slide image using HTML height and  width  tags.  A  new  image  is  not  generated.
              Default is 240 pixels

       -ws --watermark-slides
              Enable  watermarking of the slide images. A watermark file must be present for this
              option to work.  Default is DISABLED. (can be negated).

       -wf --watermark-file <filename>
              Name of the watermark file to use when -ws is enabled.  Default is "watermark.png".

       -wg --watermark-gravity <north|south|east|west|northeast|northwest|southeast|southwest>
              Where to display the watermark on the slide.  Default is southeast.

       -gb --go-back
              Prepend a "Go Back" link  to  the  header  in  the  index.html  file.  If  used  in
              conjunction with -cg, the Go Back link will be added to the INDEX-HEADER tag in the
              newly created gallery.dat file.  Default is DISABLED. (can be negated).

       -gbs --go-back-string <string>
              String to use for the go-back-url link. You could even make this an image  to  help
              round out a theme by making this string something like: "<img src=theme/myimage.gif
              border=0>" Default is "Go Back".

       -gburl --go-back-url <url>
              URL to use when -gb is enabled. Any URL can be used.  Default is '..', the previous
              directory.

       --theme <themeName>
              Name of theme to use. Themes files are defined as "themeName.theme". You would just
              enter the "themeName" portion of the file.  Default is "default".

       -wd --web-dir <dir>
              Directory to put all the gallery files (html, slides, thumbnails and possibly theme
              files)  into. Unless a fully qualified path is used, this directory will be created
              in the current directory.  This option is not used if the -lo or -uo option is set.
              Default is "web".

       -r --recurse
              Recurse  through  all  directories  on the command line.  This option will omit all
              directories named "slides", "thumbs", "theme", "web" and the value of -wd  if  that
              option  is  set.  This option will ONLY be recognized from the command line to help
              prevent accidents.  Note: Any  options  listed  on  the  command  line  when  using
              recursion will be applied to all directories.  Default is DISABLED.

       -h --help
              Display this information and exit

       -v --version
              Display version and exit

       -d --debug <0-5>
              Set debug level. Default is 0

       [directories]
              Directories to process.  Default is . (current).

       Note: If an option listed says it can be negated you can prefix it with "no"
              and  the  opposite effect will happen. Useful for overriding options on the command
              line that are set elsewhere.  e.g.  -nouo  |  --nouse-original  will  NOT  use  the
              original files as slides.

SETTING OPTIONS

       Options can be used in any of three places: (listed ascending precedence)

       -- A single line in the $HOME/.jigl/jigl.opts file in the users home directory.

       -- After the GAL-OPTIONS tag as a single line in the gallery.dat file in each of the album
       directories.

       -- On the command line.

       Regardless of where they are located, they should all be listed in the same  form  as  you
       would use them on the command line. Example: -lo -iw 6 -noskb

       Theme  files  can  be  located  in either the directory jigl is processing or in the .jigl
       directory in the user's home directory.

AUTHOR

       jigl was  written  by  Jason  Paul  <jigl@xome.net>.   Its  project  page  is  located  at
       http://xome.net/projects/jigl/.

       This manual page was adapted from the program help text by Nicholas Breen <nbreen@ofb.net>
       for the Debian project (but may be used by others).

                                         October 8, 2006                                  JIGL(1)