html

HTML::Perlinfo::HTML Perl module contains HTML documentation for the perlinfo library.

SUMMARY

NOTE: THIS IS THE LAST RELEASE OF THIS MODULE IN THIS NAMESPACE. WHEN THE NEXT VERSION APPEARS, OLDER VERSIONS WILL BE DELETED FROM CPAN

In the perlinfo library, HTML::Perlinfo and HTML::Perlinfo::Modules use the internal module HTML::Perlinfo::Common for HTML generation. This document provides information on that HTML and its manipulation.

CUSTOMIZING THE HTML

You can capture the HTML output by assigning it to a scalar. Then you can alter the HTML before printing it or doing something else with it. Here is an example that uses the perlinfo function from HTML::Perlinfo:

use HTML::Perlinfo;

my $example = perlinfo(); # Now I can do whatever I want with $example
$example =~ s/Perl/Java/ig; # Make everyone laugh
print $example;

Another option is to use object attributes which make altering some HTML elements less helter skelter.

OBJECT ATTRIBUTES

These object attributes allow you to change the HTML CSS settings to achieve a stylish effect. Please see your favorite HTML guide for acceptable CSS values. Refer to the HTML source code of the perlinfo page for the defaults.
Attribute name/Corresponding CSS element

title / page title (only non-CSS element)
bg_image / background_image
bg_position / background_position
bg_repeat / background_repeat
bg_attribute / background_attribute
bg_color / background_color
ft_family / font_familty
ft_color / font_color
lk_color / link color
lk_decoration / link text-decoration
lk_bgcolor / link background-color
lk_hvdecoration / link hover text-decoration
header_bgcolor / table header background-color
header_ftcolor / table header font color
leftcol_bgcolor / background-color of leftmost table cell
leftcol_ftcolor / font color of left table cell
rightcol_bgcolor / background-color of right table cell
rightcol_ftcolor / font color of right table cell

HTML::EP is a system for embedding Perl into HTML.

SYNOPSIS

< html >< head >< title >CGI-Env< /title >< /head >
< ep-comment >
This is an HTML document. You see. Perhaps you wonder about
the unknown HTML tags like ep-comment above? They are part
of the EP system. For example, this comment section will
be removed and you wont see it in your browser.
< /ep-comment >
< ep-perl >
# This is an example of embedding Perl into the page.
# We create a variable called time, containing the current
# time. This variable will be used below.
my $self = $_;
$self->{time} = localtime(time());
; # Return an empty string; result becomes embedded into the
# HTML page
< /ep-perl >
< body >< h1 >The current time< /h1 >
Your HTML::EP system is up and running: The current time is $time$.
< /body >
< /html >

NEWS

HTML::EP does now have a homepage, a CVS repository and a bug tracking system. Try
http://html-ep.sourceforge.net/

Have you ever written a CGI binary? Easy thing, isnt it? Was just fun!

Have you written two CGI binaries? Even easier, but not so much fun.

How about the third, fourth or fifth tool? Sometimes you notice that you are always doing the same:

· Reading and parsing variables
· Formatting output, in particular building tables
· Sending mail out from the page
· Building a database connection, passing CGI input to the database and vice versa
· Talking to HTML designers about realizing their wishes

You see, its soon to become a pain. Of course there are little helpers around, for example the CGI module, the mod_perl suite and lots of it more. Using them make live a lot easier, but not so much as you like. CGI(3). mod_perl(3).

On the other hand, there are tools like PHP or WebHTML. Incredibly easy to use, but not as powerfull as Perl. Why not get the best from both worlds? This is what EP wants to give you, similar to ePerl or HTML::EmbPerl. I personally believe that EP is simpler and better extendible than the latter two. ePerl(1). HTML::EmbPerl(3).

In short, its a single, but extensible program, that scans an HTML document for certain special HTML tags. These tags are replaced by appropriate output generated by the EP. What remains is passed to the browser. Its just like writing HTML for an enhanced browser!

HTML TIDY is a free utility to fix mistakes made while editing HTML and to automatically tidy up sloppy editing into nicely layed out markup. It also works great on the atrociously hard to read markup generated by specialized HTML editors and conversion tools, and can help you identify where you need to pay further attention on making your pages more accessible to people with disabilities.

When editing HTML its easy to make mistakes. Wouldnt it be nice if there was a simple way to fix these mistakes automatically and tidy up sloppy editing into nicely layed out markup? Well now there is! Dave Raggetts HTML TIDY is a free utility for doing just that. It also works great on the atrociously hard to read markup generated by specialized HTML editors and conversion tools, and can help you identify where you need to pay further attention on making your pages more accessible to people with disabilities.

Tidy is able to fix up a wide range of problems and to bring to your attention things that you need to work on yourself. Each item found is listed with the line number and column so that you can see where the problem lies in your markup. Tidy wont generate a cleaned up version when there are problems that it cant be sure of how to handle. These are logged as "errors" rather than "warnings".

Dave Raggett has now passed the baton for maintaining Tidy to a group of volunteers working together as part of the open source community at Source Forge. The source code continues to be available under an open source license, and you are encouraged to pass on bug reports and enhancement requests at http://tidy.sourceforge.net.

If you find HTML Tidy useful and you would like to say thanks, then please send me a (paper) postcard or other souvenir from the area in which you live along with a few words on what you are using Tidy for. It will be fun to map out where Tidy users are to be found! My postal address is given at the end of this file.

The W3C public email list devoted to HTML Tidy is: . To subscribe send an email to html-tidy-request@w3.org with the word subscribe in the subject line (include the word unsubscribe if you want to unsubscribe). The archive for this list is accessible online. If you would like to contact the developers, or you just want to submit an enhancement request or a bug report, please visit http://tidy.sourceforge.net.

Tidy can now perform wonders on HTML saved from Microsoft Word 2000! Word bulks out HTML files with stuff for round-tripping presentation between HTML and Word. If you are more concerned about using HTML on the Web, check out Tidys "Word-2000" config option! Of course Tidy does a good job on Word97 files as well!

Here are some key features of "HTML Tidy":

· Missing or mismatched end tags are detected and corrected
· End tags in the wrong order are corrected
· Fixes problems with heading emphasis
· Recovers from mixed up tags
· Getting the in the right place
· Adding the missing "/" in end tags for anchors
· Perfecting lists by putting in tags missed out
· Missing quotes around attribute values are added
· Unknown/Proprietary attributes are reported
· Proprietary elements are recognized and reported as such
· Tags lacking a terminating > are spotted

HTML Picture is freeware application that converts any JPEG or BMP file to HTML.

HTML::FormRemove is a Perl module to remove form tags from HTML.

SYNOPSIS

my $html =
"< FORM > < INPUT TYPE=TEXT NAME=Test VALUE=Hello World! > < /FORM >";
use HTML::FormRemove
print RemoveFormValues($html);

HTML::FormRemove is a module that removes form tags from HTML, while otherwise leaving the HTML intact. This allows for forms to be converted into something printable and usable.

RemoveFormValues ( HTML [, HTML [, HTML [...]]] )
Removes the form values. Exported by default. Returns an array of lines containing the updated HTML, or one single like containing them separated by newlines.

NOTES

This module is a work in progress; Ive only got basic functionality working at the moment.

HTML::BBReverse is a Perl module to convert HTML to BBCode and back.

SYNOPSIS

use HTML::BBReverse

my $bbr = HTML::BBReverse->new();

# convert BBCode into HTML
my $html = $bbr->parse($bbcode);
# convert generated HTML back to BBCode
my $bbcode = $bbr->reverse($html);

HTML::BBReverse is a pure perl module for converting BBCode to HTML and is able to convert the generated HTML back to BBCode.

And why would you want to reverse the generated HTML? Well, when you have a nice dynamic website where you and/or visitors can post messages, and in those messages BBCode is used for markup. In normal cases, your website has a lot more pageviews than edits, and saving all those messages as HTML will be a lot faster than saving them as the original BBCode and parsing them to HTML for every visit.

So now all BBCode gets converted to HTML before it will be saved, but what if you want to edit a message? Just reverse the generated HTML back to BBCode, edit your message, and save it as HTML again.

HTML::ElementSuper is a Perl extension for HTML::Element(3).

SYNOPSIS

use HTML::ElementSuper;

### Positional extension
$e = new HTML::ElementSuper font;
$sibling_number = $e->addr();
$e2 = new HTML::ElementSuper p;
$e2->push_content($e);
#
@coords = $e->position();
$depth_in_pos_tree = $e->depth();

### Replacer extension
$er = new HTML::ElementSuper font;
# Tree beneath $er, if present, is dropped.
$er->replace_content(new HTML::Element p);

### Wrapper extension
$ew = new HTML::ElementSuper;
$ew->push_content("Tickle me, baby");
$ew->wrap_content(new HTML::Element font, color => pink);
print $ew->as_HTML();

### Maskable extension
$em = new HTML::ElementSuper td;
$em->mask(1);
print $em->as_HTML; # nada
$em->mask(0);
print $em->as_HTML; # $e and its children are visible

### Cloning of own tree or another elements tree
### (is this the correct clomenature? :-)
$a = new HTML::ElementSuper font, size => 2;
$b = new HTML::ElementSuper font, color => red;
$a_clone = $a->clone;
$b_clone = $a->clone($b);
# Multiple elements can be cloned
@clone_clones = $a_clone->clone($a_clone, $b_clone);