gif2html.pl


NAME

gif2html.pl - create html files for images with caption and height width tags

v1.25 - http://www.bewley.net/perl/gif2html.pl


SYNOPSIS

gif2html.pl [ -h ] | [ -v ] [ -c captions file ] [ -t template file ] [ -b baseref ] filenames

Example: gif2html.pl -v -t template.html *.gif *.jpg

Sample Output: http://www.bewley.net/vacation/sf-alcatraz1.jpg.html


DESCRIPTION

Use gif2html.pl in batch jobs. It takes a butt load of graphics and creates an html file for each one, giving you complete control over the html. Simply create an html Template with an empty <img src=> in it. Gif2html.pl will copy the template for each image and fill in each <img src=> with the appropriate URL and width/height tags. It will also include unique Captions for each image.

Tested with UNIX of course and also Win95 Perl5.001m b107

Give your graphics descriptive names. Use full words seperated by a '-'. Dashes will be converted to spaces and possibly placed in the title depending on your template. Better yet, use the captions.

What's New

Can make use of the Image::Size module. The advantage is width and height tags can be generated for many more formats than just gif or jpeg. See your nearest http://www.ind.net/pub/mirrors/CPAN/ node.

Template support

You have complete control over how the image will be presented. Create an html file like so:

<HTML> <HEAD><TITLE><S-INSERT TITLE></TITLE> <!-- This file created by gif2html.pl by Dale Bewley dale@bewley.net http://www.bewley.net/perl/ --> </HEAD> <BODY> <center> <HR width=80%> <TABLE border=1> <TR> <TD><IMG SRC=""></TD></TR> </TABLE> <HR width=80%> <H3><S-INSERT CAPTION></H3> </center> </BODY> </HTML>

This template will be copied for each image to a file having the same name as the image but ending in .html. Also see the default template in sub readTemplate.

Notice the empty <IMG SRC=``''> tag. This will automagically be filled in with the URL of the graphic along with its width and height tags.

Also notice the <S-INSERT TITLE> and <S-INSERT CAPTION>. If you do not insert a title then the name of the graphic file will become the default title of the HTML file although dashes and underscores will be converted to spaces. The <S-INSERT CAPTION> will be filled in with the corresponding caption for the image.

Captions

Of course you can put html in them!

It is possible to create a custom caption for each image. Simply create a file that looks like so:

dale.gif | <h2>Vegan guy</h2> Means he don't eat no animal pieces or excretions. no-meat-graphic.jpg | Use this logo to make stickers for your local McD's jill.jpg | <B>Bestest</B> gurly in the <em>world</em>!

The first word must be a graphics filename followed by a | with optional spaces around it. The caption continues until a blank line and will be stuffed in place of the <S-INSERT CAPTION> tag in the template. Captions may span lines and must be seperated by a BLANK line. If you need a blank line in your caption for some reason (maybe you are useing &lt;PRE&gt;) then you need to put a space on the blank line.

If a graphic does not have a caption then gif2html.pl will put the graphics name in as a caption, just as in the title.

Tell gif2html.pl where to find this file by either specifying it on the command line with the -c option or putting its name in the $CAPTION_FILE user variable.


OPTIONS

Command Line

-b URL
Baseref for all URLs in output.

-g URL
Background for output files (unused)

-c filename
Use this file for caption mappings. Default is .gif2html.cap.

-h
Help.

-t filename
Use this template file. Default is .gif2html.tmp.

-v
Verbose. Gives you a little feedback.

.

Script Variables

You may modify these variables to your heart's content.

$CAPTION_FILE = ``.gif2html.cap'';
Default file of captions.

$BASEREF = ``./'';
Where are the graphics located? This will prefix IMG SRC's. You might want to use this if you are running gif2html.pl on a different box or in a different directory than where you will publish the output.

$TEMPLATE_FILE = ``.gif2html.tmp'';
Default HTML template in current dir.

.


TODO

.


SEE ALSO

Output of this program is particularly suited for http://www.bewley.net/perl/slideshow.html and http://www.bewley.net/perl/thumbindex.html .

Old versions still hanging around: http://www.bewley.net/perl/gif2html.pl-0.9 http://www.bewley.net/perl/gif2html.pl-1.1


AUTHOR

Dale Bewley <dale@bewley.net>

Dale has recently started a business, Bewley Internet Solutions http://www.bewley.net/ if you like this script why not send him a job, a check, or maybe just a book?