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/
01/20/1999 PCD2HTML(1)