Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

rdf::icalendar::exporter(3pm) [debian man page]

RDF::iCalendar::Exporter(3pm)				User Contributed Perl Documentation			     RDF::iCalendar::Exporter(3pm)

NAME

       RDF::iCalendar::Exporter - export RDF data to iCalendar format

SYNOPSIS

	use RDF::iCalendar;

	my $input    = "http://example.com/calendar-data.ics";
	my $exporter = RDF::iCalendar::Exporter->new;

	print $_ foreach $exporter->export_calendars($input);

DESCRIPTION

       This module reads RDF and writes iCalendar files.

       This is a subclass of RDF::vCard::Exporter, so it can also export vCards.

   Constructor
       o   "new(%options)"

	   Returns a new RDF::iCalendar::Exporter object.

	   There are no valid options at the moment - the hash is reserved for future use.

   Methods
       o   "export_calendars($input, %options)"

	   Returns a list of iCalendars found in the input, in no particular order.

	   The input may be a URI, file name, RDF::Trine::Model or anything else that can be handled by the "rdf_parse" method of
	   RDF::TrineShortcuts.

	   Each item in the list returned is an RDF::iCalendar::Entity, though that class overloads stringification, so you can just treat each
	   item as a string mostly.

       o   "export_calendar($input, $subject, %options)"

	   As per "export_calendars" but exports just a single calendar.

	   The subject provided must be an RDF::Trine::Node::Blank or RDF::Trine::Node::Resource of type icaltzd:Vcalendar.

       o   "export_component($input, $subject, %options)"

	   Exports a component from a calendar - e.g. a single VEVENT

	   The subject provided must be an RDF::Trine::Node::Blank or RDF::Trine::Node::Resource of type icaltzd:Vevent, icaltzd:Vtodo or similar.

       o   "export_cards($input, %options)"

	   See RDF::vCard::Exporter.

       o   "export_card($input, $subject, %options)"

	   See RDF::vCard::Exporter.

   RDF Input
       Input is expected to use the newer of the 2005 revision of the W3C's vCard vocabulary <http://www.w3.org/TR/rdfcal/>. (Note that even
       though this was revised in 2005, the term URIs include "2002" in them.)

       Some extensions from the namespace <http://buzzword.org.uk/rdf/icaltzdx#> are also supported.

   iCalendar Output
       The output of this module aims at iCalendar (RFC 2445) compliance.  In the face of weird input data though, (e.g. an DTSTART property that
       is a URI instead of a literal) it can pretty easily descend into exporting junk, non-compliant iCalendars.

       The output has barely been tested in any iCalendar-supporting software, so beware.

SEE ALSO

       RDF::iCalendar.

       RDF::vCard, HTML::Microformats, RDF::TrineShortcuts.

       <http://www.w3.org/TR/rdfcal/>.

       <http://www.perlrdf.org/>.

AUTHOR

       Toby Inkster <tobyink@cpan.org>.

COPYRIGHT

       Copyright 2011 Toby Inkster

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

perl v5.14.2							    2012-06-23					     RDF::iCalendar::Exporter(3pm)

Check Out this Related Man Page

HTML::Microformats::Format::hCalendar(3pm)		User Contributed Perl Documentation		HTML::Microformats::Format::hCalendar(3pm)

NAME

       HTML::Microformats::Format::hCalendar - the hCalendar microformat

SYNOPSIS

	use HTML::Microformats::DocumentContext;
	use HTML::Microformats::Format::hCalendar;

	my $context = HTML::Microformats::DocumentContext->new($dom, $uri);
	my @cals    = HTML::Microformats::Format::hCalendar->extract_all(
			  $dom->documentElement, $context);
	foreach my $cal (@cals)
	{
	  foreach my $event ($cal->get_vevent)
	  {
	    printf("%s: %s
", $ev->get_dtstart, $ev->get_summary);
	  }
	}

DESCRIPTION

       HTML::Microformats::Format::hCalendar inherits from HTML::Microformats::Format. See the base class definition for a description of property
       getter/setter methods, constructors, etc.

   Additional Method
       o   "to_icalendar"

	   This method exports the data in iCalendar format. It requires RDF::iCalendar to work, and will throw an error at run-time if it's not
	   available.

MICROFORMAT

       HTML::Microformats::Format::hCalendar supports hCalendar as described at http://microformats.org/wiki/User:TobyInk/hcalendar-1.1
       <http://microformats.org/wiki/User:TobyInk/hcalendar-1.1>.

RDF OUTPUT

       Data is returned using the W3C's revised iCalendar vocabulary (<http://www.w3.org/2002/12/cal/icaltzd#>) with some supplemental terms from
       Toby Inkster's revised iCalendar extensions vocabulary (<http://buzzword.org.uk/rdf/icaltzdx#>) and occasional other terms.

BUGS

       Please report any bugs to <http://rt.cpan.org/>.

SEE ALSO

       HTML::Microformats::Format, HTML::Microformats.

AUTHOR

       Toby Inkster <tobyink@cpan.org>.

COPYRIGHT

       Copyright 2008-2011 Toby Inkster

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

DISCLAIMER OF WARRANTIES

       THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
       MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.

perl v5.14.2							    2011-12-06				HTML::Microformats::Format::hCalendar(3pm)
Man Page