NAME
HTML::Stream - HTML output stream class, and some markup utilities
DESCRIPTION
This module provides you with an object-oriented (and subclassable)
way of outputting HTML. Basically, you open up an "HTML stream"
on an existing filehandle, and then do all of your output to the
HTML stream (you can intermix HTML-stream-output and ordinary-print-output,
if you like).
Here's small sample of the different ways you can use this module:
use HTML::Stream;
$HTML = new HTML::Stream \*STDOUT;
# The vanilla interface...
tag $HTML 'A', HREF=>"$href";
tag $HTML 'IMG', SRC=>"logo.gif", ALT=>"LOGO";
text $HTML "My caption!";
tag $HTML '_A';
text $HTML $a_lot_of_text;
# The chocolate interface (with whipped cream)...
$HTML -> A(HREF=>"$href")
-> IMG(SRC=>"logo.gif", ALT=>"LOGO")
-> t("My caption!")
-> _A
-> t($a_lot_of_text);
# The strawberry interface...
output $HTML [A, HREF=>"$href"],
[IMG, SRC=>"logo.gif", ALT=>"LOGO"],
"My caption!",
[_A];
output $HTML $a_lot_of_text;
MODULE SPECIFICATIONS
Module DSLI Description Info
---------- ---- ---------------------------------------- ----
HTML::
::Stream adpO OO "stream" for outputting HTML ERYQ
REQUIREMENTS
Perl5.002 or better (an eval bug in Perl5.001l will probably cause
core dumps during AUTOLOAD, and I have no idea if 5.001m fixed it).
INSTALLATION
Pretty simple:
1. Gunzip and de-tar the distribution, and cd to the top level.
2. Type: perl Makefile.PL
3. Type: make # this step is optional
4. Type: make test # this step is optional
5. Type: make install
Other interesting targets in the Makefile are:
make config # to check if the Makefile is up-to-date
make clean # delete local temp files (Makefile gets renamed)
make realclean # delete derived files (including ./blib)
CHANGE LOG
1.19 Base release.
TERMS AND CONDITIONS
Copyright (c) 1996 by Eryq. All rights reserved. This program is free
software; you can redistribute it and/or modify it under the same terms as
Perl itself.
See the COPYING file in the distribution for details.
AUTHOR
Eryq, eryq@rhine.gsfc.nasa.gov
15 July 1996