Greetings Anonymous Monk,

From what you describe in your post, I think HTML::Calender::Simple would be perfect. The whole $type/$info thing for date events didn't work for me, so I ended up just writing a simple subroutine to handle the link creation myself, then passed that into the daily_info method.

use strict;
use warnings;
use CGI;
use HTML::Calendar::Simple;

my $cgi = CGI->new;
print $cgi->header;

my $cal = HTML::Calendar::Simple->new({
    'month' => 6,
    'year'  => 2005,
});

sub _display_events {
    my $events = shift;
    return join('<br/>', map {
        $cgi->a({ href => $_->[0] }, $_->[1])
    } (@{$events}));
}

$cal->daily_info({
    'day'    => 21,
    'events' => _display_events([
        ['http://perlmonks.org', 'PerlMonks'],
        ['http://whitepages.com', 'Whitepages']
    ]),
});

print $cal->calendar_month;
[download]

Looks pretty easy to me:

Update: The join/split in the print is not required, it breaks up the output a little though to make it easier to check.

I rolled my own, but have you even tried HTML::Calendar::Simple yet? I'd try it first and see if it answers your own question and solves your problem.

basic usage:

$c = HTML::CalendarMonth->new( month => 10, year => 1980 );
print $c->as_HTML;
[download]

It's actually a tree structure made of HTML::Element nodes, so if you're using that it's a natural fit. You can alter the attributes or add/change content to each node before generating the HTML.

Cheers,
Matt