**** Gphoto2html 1.x : Kees Lemmens, TU Delft 2003-2008 ****

Gphoto2html is simple a GTk based application which generates a set of
webpages complete with thumbnails from a set of digital or scanned photos.

Usage :
=======

- Create a <WORK> directory (eg. "mkdir /tmp/work")

- Copy the photos to <WORK> or a subdir from <WORK> (eg. /tmp/work/Fullsize)
  and make sure they have a format like :
   <BASENAME>xxxx.<EXTENSION> (e.g. dcp_1234.jpg or 100_123.JPG)

- Change to <WORK>

- Start the "gphoto2html" application

- Set the <BASENAME> for the photos (on Kodak cameras it is "dcp_" or "100_" )

- Set the <EXTENSION> (eg. jpg, JPG or jpeg)

- Set the <FULLSIZE> directory to the subdirectory where you stored the photos
  (DO NOT USE absolute paths: the path will be stored in your HTML files !)
  If you simply stored the photos in <WORK> you should specify a dot (".")
  instead.
  
- Set the <THUMBNAILS> directory to the subdirectory where you want the
  thumbnails to be stored. Thumbnails are small versions of the images that
  can be loaded MUCH faster from a webserver than the original photo
  (depending on the size :-) If you want them to be in <WORK> simply specify
  a dot "."

- Set the maximum number of photos per indexpage <NRPERINDEX>. Gphoto2html
  generates a new (sub)webpage after having processed <NRPERINDEX> photos.
  Note that it currently should be a multiple of 8 (2 x blocksize, that is
  set to 4).
  
- Set the width or height for the thumbnails (in pixels). Good sizes are
  something between 50 and 250 (but the larger, the slower the webpage will
  load !) NOTE: you can't set both them of them : it is either width != 0 
  and height = 0 or vice versa.

- Optionally set the number of the first and last photo to be processed. 
  NOTE: gphoto2html will only generate indexes for photos that really exist
  so it doesn't harm to have <first> set to a lower value or <last> to a
  larger one than the actual number of photos.

- Click on <Create Thumbnails> to generate the thumbnails if not already
  done. gphoto2html will check if a thumb already exists and skip generation
  in that case, so it doesn't harm if they are already there.
  NOTE: Generating thumbs may take quite sometime, especially for a large
  number of photos !

- Click on <Create HTML> to generate the indexpages and their masterpage

- View the website using <View HTML>

- Upload the <WORK> tree to your webserver if you are satisfied (or keep it
  on your local disk to be able to view your pictures easily ;-)

Installation :
==============

- In most cases it is enough to copy the precompiled "gphoto2html" binary
  as root to eg. /usr/local/bin or to your local $HOME/bin directory and the 
  gphoto2html.glade-3 XML file to a directory /usr/local/gphoto2html/etc.

- If you want to recompile from source :

  - unpack the tar (probably already done if you read this ;-)
  - ./configure
  - make
  - mkdir -p /usr/local/gphoto2html/{bin,etc}
  - cp src/gphoto2html /usr/local/gphoto2html/bin
  - cp pixmaps/arrows.xpm gphoto2html.glade-3 /usr/local/gphoto2html/etc
  - ln -s /usr/local/gphoto2html/bin/gphoto2html /usr/local/bin

  Or if you are not root and have to install in your own homedir :

  - unpack the tar (probably already done if you read this ;-)
  - ./configure
  - make
  - mkdir -p $HOME/gphoto2html/{bin,etc}
  - cp src/gphoto2html $HOME/gphoto2html/bin
  - cp pixmaps/arrows gphoto2html.glade-3 $HOME/gphoto2html/etc
  - ln -s $HOME/gphoto2html/bin/gphoto2html $HOME/bin
  - export GPHOTO2HTMLDIR=$HOME/gphoto2html
  - export PATH=${PATH}:$HOME/bin # if not already done so

Dependencies :
==============

- The executable is now build using libglade and needs the "libglade.so"
  library to be installed on your system or else the xml file for GUI layout
  can not be loaded.

- The "Create thumbnails" button depends on having "djpeg", "pnmscale" and
  "cjpeg" installed, which is the case for most Linux distributions.

- The "View HTML" button currently starts the "mozilla" browser so you need
  to have that installed. Change the macro in src/stuff.h and recompile if
  you want to use another browser.

License :
=========

GPL, but I really don't want it be used on any MS-Windows based system ;-)

Any comments, bug fixes etc. are welcome !
Happy Linuxing !

Kees Lemmens,
TU Delft,
2003-2008,
c.w.j.lemmens <at> ewi <dot> tudelft <dot> nl