.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "XML::Atom::FromOWL 3pm"
.TH XML::Atom::FromOWL 3pm 2024-03-08 "perl v5.38.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
XML::Atom::FromOWL \- export RDF data to Atom
.SH SYNOPSIS
.IX Header "SYNOPSIS"
.Vb 3
\& use LWP::UserAgent;
\& use XML::Atom::OWL;
\& use XML::Atom::FromOWL;
\& 
\& my $ua       = LWP::UserAgent\->new;
\& my $r        = $ua\->get(\*(Aqhttp://intertwingly.net/blog/index.atom\*(Aq);
\& my $atomowl  = XML::Atom::OWL\->new($r\->decoded_content, $r\->base);
\& my $model    = $atomowl\->consume\->graph;  ## an RDF::Trine::Model
\& 
\& my $exporter = XML::Atom::FromOWL\->new;
\& print $_\->as_xml
\&        foreach $exporter\->export_feeds($model);
.Ve
.SH DESCRIPTION
.IX Header "DESCRIPTION"
This module reads RDF and writes Atom feeds. It does the reverse
of XML::Atom::OWL.
.SS Constructor
.IX Subsection "Constructor"
.IP \(bu 4
\&\f(CWnew(%options)\fR
.Sp
Returns a new XML::Atom::FromOWL object.
.Sp
There are no valid options at the moment \- the hash is reserved
for future use.
.SS Methods
.IX Subsection "Methods"
.IP \(bu 4
\&\f(CW\*(C`export_feeds($input, %options)\*(C'\fR
.Sp
Returns a list of feeds found in the input, in no particular order.
.Sp
The input may be a URI, file name, RDF::Trine::Model or anything else
that can be handled by the \f(CW\*(C`parse\*(C'\fR function of RDF::TrineX::Functions.
.Sp
Each item in the list returned is an XML::Atom::Feed.
.IP \(bu 4
\&\f(CW\*(C`export_feed($input, $subject, %options)\*(C'\fR
.Sp
As per \f(CW\*(C`export_feeds\*(C'\fR but exports just a single feed.
.Sp
The subject provided must be an RDF::Trine::Node::Blank or
RDF::Trine::Node::Resource of type awol:Feed.
.IP \(bu 4
\&\f(CW\*(C`export_entries($input, %options)\*(C'\fR
.Sp
Returns a list of entries found in the input, in no particular order.
.Sp
The input may be a URI, file name, RDF::Trine::Model or anything else
that can be handled by the \f(CW\*(C`parse\*(C'\fR function of RDF::TrineX::Functions.
.Sp
Each item in the list returned is an XML::Atom::Entry.
.IP \(bu 4
\&\f(CW\*(C`export_entry($input, $subject, %options)\*(C'\fR
.Sp
As per \f(CW\*(C`export_entry\*(C'\fR but exports just a single entry.
.Sp
The subject provided must be an RDF::Trine::Node::Blank or
RDF::Trine::Node::Resource of type awol:Entry.
.SS "RDF Input"
.IX Subsection "RDF Input"
Input is expected to use AtomOwl
<http://bblfish.net/work/atom\-owl/2006\-06\-06/#>.
.SS "Feed Output"
.IX Subsection "Feed Output"
This module doesn't attempt to enforce many of OWL's semantic
constraints (e.g. it doesn't enforce that an entry has only one
title). It relies on XML::Atom::Feed and XML::Atom::Entry
for that sort of thing, but if your input is sensible that
shouldn't be a problem.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
XML::Atom::OWL, HTML::Microformats, RDF::TrineX::Functions,
XML::Atom::Feed, XML::Atom::Entry.
.PP
<http://bblfish.net/work/atom\-owl/2006\-06\-06/>.
.PP
<http://www.perlrdf.org/>.
.SH AUTHOR
.IX Header "AUTHOR"
Toby Inkster <tobyink@cpan.org>.
.SH "COPYRIGHT AND LICENCE"
.IX Header "COPYRIGHT AND LICENCE"
This software is copyright (c) 2011\-2012 by Toby Inkster.
.PP
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
.SH "DISCLAIMER OF WARRANTIES"
.IX Header "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.