NAME

HTML::Revelation - Reveal HTML document structure in a myriad of colors

Synopsis

        #!/usr/bin/perl

        use strict;
        use warnings;

        use HTML::Revelation;

        # -------------------

        my($reveal) = HTML::Revelation -> new
        (
         caption          => 1,
         comment          => "DBIx::Admin::CreateTable's POD converted to HTML with my pod2html.pl",
         css_output_file  => 'CreateTable.css',
         css_url          => '/',
         html_output_file => 'CreateTable.html',
         input_file       => 'misc/CreateTable.html',
        );

        $reveal -> run();

Sample output:

http://savage.net.au/Perl-modules/html/CreateTable.html

Description

HTML::Revelation is a pure Perl module.

Constructor and initialization

new() returns a HTML::Revelation object.

This is the class's contructor.

You must pass a hash to new().

Options:

caption => 0 | 1

Use this key to display or suppress a caption (a table of information) at the start of the HTML output file.

The default is 0.

This key is optional.

comment => $s

Use this key to add a comment to the caption (if displayed).

The default is '' (the empty string).

This key is optional.

css_output_file => $s

Use this key to specify the name of the CSS output file.

The default is '' (the empty string).

This key is mandatory.

css_url => $s

Use this key to specify the URL of the CSS output file.

This URL is written into the HTML output file.

The default is '' (the empty string).

This key is mandatory.

html_output_file => $s

Use this key to specify the name of the HTML output file.

The default is '' (the empty string).

This key is mandatory.

input_file => $s

Use this key to specify the name of the HTML input file.

The default is '' (the empty string).

This key is mandatory.

Method: add_caption()

Factor out the code which formats the caption.

Method: build_css_file()

Factor out the code which build the body of the CSS output file.

Method: load_colors()

Factor out the code which stores the data defining the available colors.

Method: run()

As shown in the synopsis, you must call run() on your HTML::Revelation object in order to generate the output files.

FAQ

Where did the colors come from?

From the Image::Magick web site. I extracted them from a web page there using the amazing HTML::TreeBuilder module. See scripts/extract.colors.pl.

Why do you discard the first 220 colors?

Because they are too dark for my liking.

Why does the caption use CSS class c0003?

I like that color - it's nice and restful. I seriously considered using c0201.

I want to know which CSS class produces which color.

Patch line 743 to put ' $class_name' just inside the '|' at the end of the line.

Modules Used

accessors::classic

File::Spec

HTML::Entities::Interpolate

HTML::Tagset

HTML::TreeBuilder

List::Cycle

Author

HTML::Revelation was written by Ron Savage <ron@savage.net.au> in 2008.

Home page: http://savage.net.au/index.html

Copyright

        Australian copyright (c) 2008,  Ron Savage.
        All Programs of mine are 'OSI Certified Open Source Software';
        you can redistribute them and/or modify them under the terms of
        the Artistic or the GPL licences, copies of which is available at:
        http://www.opensource.org/licenses/index.html

cpanm HTML::Revelation

perl -MCPAN -e shell
install HTML::Revelation