Requirements for the gallery program:

Python 2.4

Site additions required, but not included:
  PIL - Python Image Library - always required
  wxPython 2.6 - IF using the GUI interface.  It is not required if you use the
                 console version, invoked with the flag -c:
                        make_gallery.py -c ...  
                                            
Files:
  make_gallery.py   few line driver to speed operations
  gallery_cmd.py    cmd line parser, main program for pure console operation
  gallery_gui.py    GUI with embedded pic doc editor, link to browser
  main_gallery.py   main processing engine
  gallery.py        support code, Gallery and other classes
  gallery_html.py   html generation code
  gallery_param.py  constants, defaults and parameter format
  gallery.css       default cascading style sheet
  setter.py         support GUI parameter bindings
  dirbrowse2.py     dir browser starts from last place selected if possible

To get the command line documentation, run: 
  [python-path]python [gallery-path]make_gallery.py -H
where the actual paths are included if necessary in your system setup.


History:

version 2.1.1 bug fix: check if user modified an orignal file name to make it
             be a duplicate.
version 2.1  Friendly GUI: parameters to set, help, tooltips, repaired layout
version 2.0  Added *primative* GUI option
version 1.6  Allow all Windows file names,with quotes if blanks included,
             as sources and results unless --remove_blanks=y
version 1.5  Refactored to have Gal_Param class with constants 
               in gallery_param
             Separated modules for commandline parsing, gallery_cmd,
               and for html, gallery_html
             Removed --include to force docs in PICFILENAME
version 1.4  Environment string implicily in command line arguments
             Make conversions with PIL only happen when needed.
version 1.3  Replaced ImageMagick with PIL: Python Image Library,
             Allow merging of separate galleries
             Remembers user-set new file names, overriding -uy
             Made galleries into objects, in separate module
version 1.2  '?' in dimensions for thumb and medium pic
version 1.1  DIMENSION_FILE, --force added
version 1.0  Basic command line version

Features omitted so far:  (Let me know if you want to add any!)
    Put sub-gallery links in the index:
        If a child directory has a picdocs.txt file,
          insert a section of links showing the first pic
          of each sub gallery. 
        Leave just one copy of gallery.css in the tree.
    Other picture file types
    Bulletproof if wierd file error
    Put more of the command line parameters into the GUI also, for instance 
        allow more than one pic directory to be combined in the GUI.
    Generate zips
    Built in SSH/ftp option to upload the results
    Make the process more reversible:  
        saved old picdocs.txt versions are not useful to back up if
           any picture file names are modified.
    Syntax highlight the text file, at least marking ###.

If you wish to redistribute any portion of this software, please see 
LICENSE.txt.