First, you must download and install ImageMagick. They have binary releases for various platforms (Linux, FreeBSD, Mac OS X, Solaris and Windows with Cygwin). The example below was tested with version 6.2.4 on Linux and version 6.0.4 on Windows (with Cygwin).

Once ImageMagick is installed, you can test it by doing:

  % convert logo: logo.gif

and displaying the resulting logo.gif file in a browser.

Next, you install pubpics:

  % tar zxf pubpics-1.31-linux-glibc-2.2.tar.gz -C /usr/local
  % cd /usr/local/bin
  % ln -s ../pubpics-1.31/pubpics .

The above will install the binaries into /usr/local/pubpics-1.31/ and make a symbolic link to the binaries in /usr/local/bin. Now, test it out:

  % pubpics

You should see a help message from pubpics when it is given no command line arguments.

On Windows, put the contents of the zip file into some directory, say c:\pubpics131, and put that directory in your PATH. The rest of the instructions will work the same for Windows and Linux, or any platform.

For this example, we have a directory named pictures containing photos we want to publish. On Windows:

  bash$ pubpics -B c:/cygwin/bin -t foo pictures webdir
  collecting information: 12 pictures
  make html pages: small medium large
  make index pages: index.htm index_small.htm index_large.htm
  generate images:
    [1 of 12] 20050807-1241-1600-S1IS.JPG: thumbnail large medium small
    [2 of 12] 20050807-1241-2600-S1IS.JPG: thumbnail large medium small
    [3 of 12] 20050807-1244-4300-S1IS.JPG: thumbnail large medium small
    [4 of 12] 20050807-1245-4300-S1IS.JPG: thumbnail large medium small
    [5 of 12] 20050807-1245-4700-S1IS.JPG: thumbnail large medium small
    [6 of 12] 20050807-1245-5500-S1IS.JPG: thumbnail large medium small
    [7 of 12] 20050807-1246-0200-S1IS.JPG: thumbnail large medium small
    [8 of 12] 20050807-1246-0500-S1IS.JPG: thumbnail large medium small
    [9 of 12] 20050807-1248-1300-S1IS.JPG: thumbnail large medium small
    [10 of 12] 20050807-1248-4100-S1IS.JPG: thumbnail large medium small
    [11 of 12] 20050807-1249-5100-S1IS.JPG: thumbnail large medium small
    [12 of 12] 20050807-1250-1200-S1IS.JPG: thumbnail large medium small
  bash$ ls -l webdir
  total 19
  -rw-r--r--  1 layer None  853 Oct 16  2002 blank.gif
  -rw-r--r--  1 layer None  388 Dec 31  2000 home.gif
  -rw-r--r--  1 layer None 4064 Aug 24 10:29 index.htm
  -rw-r--r--  1 layer None 4040 Aug 24 10:29 index_large.htm
  -rw-r--r--  1 layer None 4040 Aug 24 10:29 index_small.htm
  drwxr-xr-x  2 layer None    0 Aug 24 10:30 large
  drwxr-xr-x  2 layer None    0 Aug 24 10:30 medium
  -rw-r--r--  1 layer None  374 Dec 31  2000 next.gif
  drwxr-xr-x  5 layer None    0 Aug 24 10:29 pages
  -rw-r--r--  1 layer None  384 Dec 31  2000 previous.gif
  drwxr-xr-x  2 layer None    0 Aug 24 10:30 small
  drwxr-xr-x  2 layer None    0 Aug 24 10:30 thumbs
  bash$ 

The -B c:/cygwin/bin was needed because on the Windows computer the test was run there is exists a convert.exe in the Windows system32 directory.

There are three important files created by pubpics in the webdir directory:

• index.htm: medium images are linked on this index page
• index_small.htm: small images are linked on this index page
• index_large.htm: small images are linked on this index page

You can publish any of the tree index files.

The rest of the files are support files and are needed for the correct rendering of the generated web pages.