---
name: "iCal::Parser::HTML"
section: "3pm"
platform: "linux"
package: "libical-parser-html-perl"
version: "1.07-4"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/iCal::Parser::HTML"
---

# iCal::Parser::HTML(3pm)

Generate HTML calendars from iCalendars

## NAME

iCal::Parser::HTML - Generate HTML calendars from iCalendars

## SYNOPSIS

```
  use iCal::Parser::HTML;
  my $parser=iCal::Parser::HTML->new;
  print $parser->parse(type=>$type,start=>$date,files=>[@icals]);
```

## DESCRIPTION

This module uses iCal::Parser::SAX and XML::LibXSLT with included stylesheets to generates html calendars from icalendars.

The html document generated includes (when appropriate) a sidebar containing a legend, a list of todos and a three month calendar for the previous, current and next months.

The stylesheets are stored in the HTML/stylesheet directory under the installed package directory.

Also included in this package are an optionally installed command line program "ical2html" in scripts and, in the example directory, a cgi handler ("ical.cgi" in examples) and a stylesheet ("calendar.css" in examples) for formatting the html output. Note that the html output will look quite broken without the stylesheet.

## ARGUMENTS

The following arguments are processed by this module. Any addtional arguments are passed to iCal::Parser::SAX.

- type

  The type of calendar to generate. One of: `"day"`, `"week"`, `"month"` or `"year"`.  The daily, weekly and monthly calendars include the sidebar. The calendar generated will be for the specified period (day, week, etc.) which includes the specified date.

- start

  The date to generated the calendar for. The date only needs to be specified to the precision necessary for the type of calendar. That is, `"YYYY"` for a yearly calendar, `"YYYYMM"` for a monthly, and `"YYYYMMDD"` for daily and weekly. In addition, the date can be in one of the following forms:

  - YYYY\[MM\[DD\]\]

    - YYYY\[-MM\[-DD\]\]

    - A DateTime object initialized to the necessary precision

    - files

  An array reference to the list of icalendars to include in the results.

- url

  If this params is specified, then the html output will contain links back to this url for getting other calendar periods. The params `"type"` and `"date"` will be appended to this url  when generating the links.

## AUTHOR

Rick Frankel, cpan@rickster.com

## COPYRIGHT

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

The full text of the license can be found in the LICENSE file included with this module.

## SEE ALSO

iCal::Parser::SAX, XML::LibXML::SAX::Builder, XML::LibXSLT, DateTime