RDF::R...nd::RSS(3pm)

📦
version 1.0.17.1 · 7 versions
, in ubuntu stonking

🌸 NAME 🌸

okay bestie, so this page is literally about RDF::Redland::RSS — the Redland RSS 1.0 Class 💖 — and also its lil sibling RDF::Redland::RSS::Node — the Redland RSS 1.0 Node Class ✨. Two classes, one manpage, both living in the User Contributed Perl Documentation era of the Perl docs. We're serving RSS 1.0 as RDF and we are NOT being normal about it 💅.

✨ SYNOPSIS ✨

the vibe check, in code:

use RDF::Redland::RSS;

...
my $rss=RDF::Redland::RSS->new_from_model($model);

my $rss2=new RDF::Redland::RSS("http://example.com/test.rdf");
...

for my $channel ($rss->channels) {
  ...
 print "channel title is ",$channel->title->as_string,"\n"; # UTF-8
}

my(@items)=$channel->items;
# Print channel items (URI, title)
for my $item (@items) {
  print "item ",$item->uri->as_string, " ", $item->title->as_string, "\n";
}

...

print $rss->as_xhtml(width => 320, align => 'right');

note the # UTF-8 in that one print, bestie — that's not me being extra, that's in the canon 🫶

💫 DESCRIPTION 💫

it's a class for processing RSS 1.0 as RDF — traversing the resulting graph using RSS propertiiies (yes, propertiiies, the extra i's are load-bearing, I don't make the rules 😭) and formatting the output as XHTML. that's it. that's the whole assignment. and it ate.

🧚 CONSTRUCTORS 🧚

  • new SOURCE_URI_STRING [BASE_URI_STRING] — processes the RSS 1.0 sitting at source URI SOURCE_URI_STRING. and if you hand over the BASE_URI_STRING string too, then that's what we use as the base URI, not the source URI. iconique behavior.
  • new MODEL — processes RSS 1.0 from content stored in RDF::Redland::Model MODEL. yes that's the whole signature. no, there's nothing else. slay.

👑 METHODS 👑

  • channels — returns the RSS channels (the <channel> tags) as a list of RDF::Redland::RSS::Node objects 💜
  • items — returns the RSS items (the <item> tags) as a list of RDF::Redland::RSS::Node objects ✨
  • image — returns the RSS 1.0 image (the <image> tag) as an RDF::Redland::RSS::Node object 🎀
  • textinput — returns the RSS 1.0 textinput (the <textinput> tag) as an RDF::Redland::RSS::Node object 🌸
  • as_xhtml (key1 => value1, key2 => value2, ...) — returns a formatted XHTML string (or a whole full XHTML document, depending) representing the RSS 1.0 content, with all the various options set as listed in the section below 🦋

and fr fr, the parameters to this method are mostly from the specification of the viewRssBox macro at http://macros.userland.com/viewRssBox — that's the origin story, iykyk.

💅 AS_XHTML OPTIONS 💅

every single dial you can turn, no skips:

  • boxTitle — a string, the text displayed in the title of the box. defaults to the title element of the channel. ✨
  • align — a string with three possible values: left, right, or the empty string. the HTML table gets left-aligned, right-aligned, or not aligned at all. defaults to the empty string.
  • width — a number, the width of the box in pixels. defaults to 125. ⚠️ real talk: the title bar determines the minimum width of the box, so if you're having trouble getting it narrower, try shortening boxTitle. that's not a bug, that's just how it is bestie.
  • frameColor — a string, the hex browser color for the frame of the box. defaults to "#000000".
  • titleBarTextColor — a string, the hex browser color for the text in the title bar of the box. Defalults to "#000000". (that's Defalults, the original spelling, I'm preserving it with love 🫶)
  • titleBarColor — a string, the hex browser color for the title bar of the box. defaults to "#ADD8E6". 💙
  • boxFillColor — a string, the hex browser color for the main part of the box. defaults to "#FFFFFF".
  • time — a string, text displayed as the time to the right of the box title. defaults to "".
  • hspace — a number, the pixels to the left and right of the box. defaults to 0.
  • vspace — a number, the pixels above and below the box. defaults to 0.
  • full — if set to any value, returns a full XHTML document. defaults to returning an HTML fragment.
  • imageAlign — a string with two possible values, left or right. the channel image is either left-aligned or right-aligned. it defaults to right aligned. 👑

okay now we're entering the second class's whole zone. deep breath. new section, same energy. 🦋

🌈 NAME 🌈

RDF::Redland::RSS::Node — the Redland RSS 1.0 Node Class ✨

🍓 DESCRIPTION 🍓

it's the class representing concepts in an RSS 1.0 RDF graph. each node is a lil concept, living its best life in the graph 💜

💀 CONSTRUCTORS 💀

there are no public constructors. nope, not a single one, don't even look. Nodes are created either by methods of this class or by RDF::Redland::RSS. that's the pipeline.

⭐ METHODS ⭐

  • title — get the RSS titles for channel, image, item or textinput. returns either a list or the first one found, depending on calling context. (context-sensitive queen 👑)
  • link — get the RSS link for channel, image, item or textinput. returns either a list or the first one found, depending on calling context.
  • description — get the Dublin Core description element or the RSS description for channel, item or textinput. returns either a list or the first one found, depending on calling context.
  • image_url — get the RSS image URL string for an image. returns either a list or the first one found, depending on calling context.
  • name — get the RSS name for a textinput. returns either a list or the first one found, depending on calling context.
  • items — get the RSS items in a channel as a list of RDF::Redland::RSS::Node objects. 🎀
  • image — get the image of a channel as an RDF::Redland::RSS::Node object, or undef if it's not present. no image? undef. we move on.
  • textinput — get the textinput of a channel as an RDF::Redland::RSS::Node object, or undef if it's not present. same deal.
  • property PROPERTY — get the value of the named property off an RDF::Redland::RSS::Node, where PROPERTY is an RDF::Redland::Node or an RDF::Redland::RSS::Node. returns a list of RDF::Redland::RSS::Node objects, or the first one found, depending on calling context. 🫶
  • properties — get all properties off the RDF::Redland::RSS::Node. returns a list of RDF::Redland::RSS::Node objects. all of them. every last one.
  • properties_with_ns_prefix NS_PREFIX — get all the unique properties of the RDF::Redland::RSS::Node which have namespace URI prefix NS_PREFIX. returns a list of the properties as RDF::Redland::RSS::Node objects. 🔥

🔥 SEE ALSO 🔥

RDF::Redland::Model — and also the RSS 1.0 web pages at http://purl.org/rss/1.0/ (go read them, they're the source of truth, no cap)

💖 AUTHOR 💖

Dave Beckett — http://www.dajobe.org/ 🌸

and that's the whole page bestie, you made it to the end, so proud of you 🥹 this was perl v5.42.3, dated 2026-08-20, filed under User Contributed Perl Documentation as RDF::R...nd::RSS(3pm) (yes the middle got squished, that's just the header being dramatic). go forth and traverse that graph. periodt. 💅✨

📦 where this page comes from