PCD2HTML(1)

NAME
pcd2html - scripts to build HTML pages from Kodak Photo CD images

SYNOPSIS
pcd2html [options]

DESCRIPTION
pcd2html certain images will be included in HTML pages. The user has to ship "rules" files in some subdirectories to tell pcd2html how to convert the images from the Kodak Photo CD to JPG images which will be included in the pages.

OPTIONS

none
    pcd2html searches for a rules file which specifies in which subdirectories pcd2html should work. According to the rules files in these subdirectories the JPG images and HTML pages with thumb-nails and links are build.

data
    store all files called rules and extra as well as files with the extensions ".eng", ".deu", ".tec" and "drf" into a tar.gz archive.

html
    store all created HTML and JPG files into a tar.gz archive

clean
    clean unnecessary data files used temporarily by pcd2html

distclean
    clean all files which pcd2html has created

SYNTAX OF THE rules FILE
# Comments start with a `#` in the first column of a row <key:nnn> <image_name> [[<convert_options>]] [!<i>] [Q<q>]

To descibe an image a specifying <key> for the Kodak Photo CD and the number of the image <nnn> is required. Used are only the last three digits (because they are significant). So you have to type three valid digits specifying the file
   photo_cd/images/img0<nnn>.pcd
on a Photo CD.
The <key>s of all used Kodak Photo CDs are stored in the file $(HOME)/.pcd2html> for each user. It is generated when a new Kodak Photo CD is used and can be determined automatically from internal data later.

The image_name is the second required value which tells pcd2html how to name the JPG image. This is build the following way:
   <key_nnn><image_name>.jpg
It is considered to be useful to save the original number for reasons of sorting the images later and comparing with the Photo CD index. The image name should be reasonable human readable.

The optional convert_options given in [] could contain any valid option for the convert program of the ImageMagick package (see convert(1)).

The optional argument !<i> specifies the magnification of the Photo CD image that should be used. i has to be a number between 1 and 5. By default i is 3 and can be left out.

To change the Jpeg quality Q<q> the user has the possibility to get the result more or less compressed. By default a compression of 75% (convert -quality 75) is used. The number q will be used as quality argument of convert and all values which are valid in this case are valid here.

CAVEATS
The system was tested very rarely. Expect to get failures.

Please send any comment about the style of the HTML pages (which is defined in pcd.css) to <tille@debian.org>.

DEPENDS
The package depends from convert which is contained in the ImageMagick package available from

ftp://ftp.wizards.dupont.com/pub/ImageMagick/

SEE ALSO
perl(1p), make(1), bash(1), sed(1), grep(1)

BUGS
Expect each kind of bugs. Expect destroying your hard-disk, cdrom, the whole computer and the children of your cat. Don't say you was not warned!

AUTHOR
Andreas Tille <tille@debian.org>
http://fam-tille.de/