xome -> projects -> jigl -> options

jigl

Photo/Image Gallery Software
Linux & Windows 2K/XP
jigl @ xome . net

Jason's Image Gallery

Main | About | Demos | Download | Themes | Usage | Options | Windows Users

Options

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

Regardless of where options 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
Usage: jigl.pl [options] [directories]
[options]
-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 : Gererate 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
 
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.
 
[directories]
Default directory is "."
 
Options can be used in any of three places: (listed ascending precedence)
- A single line in the $HOME/.jigl/jigl.opts file.
- 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 users home directory.