Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

template::plugin::xml::rss(3pm) [debian man page]

Template::Plugin::XML::RSS(3pm) 			User Contributed Perl Documentation			   Template::Plugin::XML::RSS(3pm)

NAME

       Template::Plugin::XML::RSS - Plugin interface to XML::RSS

SYNOPSIS

	   [% USE news = XML.RSS('news.rdf') %]

	   [% FOREACH item IN news.items %]
	      [% item.title %]
	      [% item.link  %]
	   [% END %]

DESCRIPTION

       This Template Toolkit plugin provides a simple interface to the XML::RSS module.

	   [% USE news = XML.RSS('mysite.rdf') %]

       It creates an XML::RSS object, which is then used to parse the RSS file specified as a parameter in the USE directive.  A reference to the
       XML::RSS object is then returned.

       An RSS (Rich Site Summary) file is typically used to store short news 'headlines' describing different links within a site.  This example
       is extracted from http://slashdot.org/slashdot.rdf.

	   <?xml version="1.0"?>
	   <rdf:RDF
	     xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
	     xmlns="http://my.netscape.com/rdf/simple/0.9/">

	     <channel>
	       <title>Slashdot:News for Nerds. Stuff that Matters.</title>
	       <link>http://slashdot.org</link>
	       <description>News for Nerds.  Stuff that Matters</description>
	     </channel>

	     <image>
	       <title>Slashdot</title>
	       <url>http://slashdot.org/images/slashdotlg.gif</url>
	       <link>http://slashdot.org</link>
	     </image>

	     <item>
	       <title>DVD CCA Battle Continues Next Week</title>
	       <link>http://slashdot.org/article.pl?sid=00/01/12/2051208</link>
	     </item>

	     <item>
	       <title>Matrox to fund DRI Development</title>
	       <link>http://slashdot.org/article.pl?sid=00/01/13/0718219</link>
	     </item>

	     <item>
	       <title>Mike Shaver Leaving Netscape</title>
	       <link>http://slashdot.org/article.pl?sid=00/01/13/0711258</link>
	     </item>

	   </rdf:RDF>

       The attributes of the channel and image elements can be retrieved directly from the plugin object using the familiar dotted compound nota-
       tion:

	   [% news.channel.title  %]
	   [% news.channel.link   %]
	   [% news.channel.etc... %]

	   [% news.image.title	  %]
	   [% news.image.url	  %]
	   [% news.image.link	  %]
	   [% news.image.etc...   %]

       The list of news items can be retrieved using the 'items' method:

	   [% FOREACH item IN news.items %]
	      [% item.title %]
	      [% item.link  %]
	   [% END %]

AUTHORS

       This plugin was written by Andy Wardley inspired by an article in Web Techniques by Randal Schwartz.

       The XML::RSS module, which implements all of the functionality that this plugin delegates to, was written by Jonathan Eisenzopf.

COPYRIGHT

       Copyright (C) 1996-2006 Andy Wardley.  All Rights Reserved.

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

SEE ALSO

       Template::Plugin, XML::RSS, XML::Parser

perl v5.8.8							    2008-03-01					   Template::Plugin::XML::RSS(3pm)

Check Out this Related Man Page

Template::XML(3pm)					User Contributed Perl Documentation					Template::XML(3pm)

NAME

       Template::XML - XML plugins for the Template Toolkit

SYNOPSIS

	   [% USE XML;

	      dom    = XML.dom('foo.xml');
	      xpath  = XML.xpath('bar.xml');
	      simple = XML.simple('baz.xml');
	      rss    = XML.simple('news.rdf');
	   %]

DESCRIPTION

       The Template-XML distribution provides a number of Template Toolkit plugin modules for working with XML.

       The Template::Plugin::XML module is a front-end to the various other XML plugin modules.  Through this you can access XML files and direc-
       tories of XML files via the Template::Plugin::XML::File and Template::Plugin::XML::Directory modules (which subclass from the Tem-
       plate::Plugin::File and Template::Plugin::Directory modules respectively).  You can then create a Document Object Model (DOM) from an XML
       file (Template::Plugin::XML::DOM), examine it using XPath queries (Template::Plugin::XML::XPath), turn it into a Perl data structure (Tem-
       plate::Plugin::XML::Simple) or parse it as an RSS (RDF Site Summary) file.

       The basic XML plugins were distributed as part of the Template Toolkit until version 2.15 released in May 2006.	At this time they were
       extracted into this separate Template-XML distribution and an alpha version of this Template::Plugin::XML front-end module was added.

AUTHORS

       Andy Wardley wrote the Template Toolkit plugin modules, with assistance from Simon Matthews in the case of the XML::DOM plugin.	Matt
       Sergeant wrote the XML::XPath module.  Enno Derksen and Clark Cooper wrote the XML::DOM module.	Jonathan Eisenzopf wrote the XML::RSS mod-
       ule.  Grant McLean wrote the XML::Simple module.  Clark Cooper and Larry Wall wrote the XML::Parser module.  James Clark wrote the expat
       library.

COPYRIGHT

       Copyright (C) 1996-2006 Andy Wardley.  All Rights Reserved.

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

SEE ALSO

       Template, Template::Plugins, Template::Plugin::XML, Template::Plugin::XML::DOM, Template::Plugin::XML::RSS, Template::Plugin::XML::Simple,
       Template::Plugin::XML::XPath

perl v5.8.8							    2008-03-01							Template::XML(3pm)
Man Page