- See Also
Introduction - A Simple Introduction To RSS
Rich Site Summary/Resource Description Framework technology is a simple method of a site describing what it has, so that another site can summarise the content, and provide links back to the original content.
RSS was pioneered by Netscape Communications http://my.netscape.com/publish/formats/rss-spec-0.91.html for their my.netscape portal, and adopted quickly by many others, notably userland http://backend.userland.com/rss092 .
A simple XML http://www.w3.org/XML/ file is produced by the site originating the articles. This file, easily obtainable by HTTP, is downloaded and parsed by the client, allowing the client to present the site summary in a way that suits the client. XML provides a simple human readable format that is easy to generate and read, using typical web tools.
The module came from a simple idea, gather RSS feeds, convert them into HTML fragments and then template them into a web page on a local web server.
Downloading RSS files
Originally I used wget http://www.gnu.org/software/wget/wget.html , to pull files down from their server. Other tools to do this include cURL http://curl.haxx.se/ and any web browser. I cached the RSS feeds on my web server's disk space to reduce unnecessary downloading.
RSS feeds come in several incompatible families. To make conversion to HTML simple I opted to convert all RSS feeds to RSS version 0.91 as this is very simple to convert to HTML via XSLT http://www.w3.org/Style/XSL/ . You can turn off normalisation if you plan to use just one XSLT stylesheet.
The underlying XML::RSS http://perl-rss.sourceforge.net/ (up to version 0.97) core can parse and interconvert RSS Versions 0.9, 0.91 and 1.0, versions of XML::RSS 0.98 and beyond can additionally process RSS version 2.0, though it is unlikely to ever be able to process the largely unused versions 0.92, 0.93, and 0.94, which are the evolutionary steps from 0.91 to 2.0.
Most online examples of RSS use the XML::RSS module to programmatically convert the feed into HTML, either directly or via using one of the many quality HTML templating tools. This I felt was inefficient and so I opted to use "XML Stylesheet Language Transformation", which is industry standard and does not require programming. There are several XSLT processors available: Saxon http://saxon.sourceforge.net/ , Xalan http://xml.apache.org/ , MSXML, and Sablotron http://www.gingerall.com/charlie/ga/xml/p_sab.xml , however the fastest and easiest one for Perl is Matt Sergeant's XML C Library for Gnome http://xmlsoft.org/ based a XML::LibXSL.
Script to Module
After developing the script to do this I realised that much of the code could be converted into a module and distributed to the world. After a popular post to Perlmonks, I have moved the module up to CPAN. The code should be considered as pre-release code, and the API may be extended in the future.
Some basic examples of how to use this module are provided in the examples folder.
http://backend.userland.com/rss092 - the home of key RSS developments
http://soapclient.com/rss/rss.html - a RSS to HTML online tool
Netscape Communications, home of the original specifications - http://my.netscape.com/publish/formats/rss-spec-0.91.html
W3C Standards body: RDF http://www.w3.org/RDF/ and RDF Validator http://www.w3.org/RDF/Validator/
http://blogspace.com/rss/ - Blogspace RSS FAQ
http://www.webreference.com/authoring/languages/xml/rss/1/8.html Webreference.com RSS Versions
http://rss.benhammersley.com/ Ben Hammersley's Webloggery and recent book Content Syndication with RSS - http://www.oreilly.com/catalog/consynrss/
Dave Beckett's Resource Description Framework Resource Guide - http://www.ilrt.bristol.ac.uk/discovery/rdf/resources/
Mark Pilgrim and Sam Ruby's RSS Validator http://feeds.archive.org/validator/
brian d foyhas an interesting, article in The Perl Review - http://www.theperlreview.com/Issues/v0i6.shtml
Mark Pilgrim has some nice RSS articles on XML.com (in Python): http://www.xml.com/lpt/a/2002/12/18/dive-into-xml.html http://www.xml.com/lpt/a/2003/01/22/dive-into-xml.html http://www.xml.com/lpt/a/2003/02/26/dive-into-xml.html and http://www.xml.com/lpt/a/2004/04/07/dive.html
Bob DuCharme wrote a simple introduction to using XSLT with RSS on XML.com: http://www.xml.com/lpt/a/2003/01/02/tr.html
The Perl-RSS Group has a nice selection of articles on http://perl-rss.sourceforge.net/bibliography.html
O'Reilly has a dedicated RSS section in O'Reilly Network: RSS DevCenter http://www.oreillynet.com/rss/
See my RSS Article removed from this module: http://www.iredale.net/articles/rss-xslt.html
Some Example RSS Feeds