HTML::...L_COinS(3pm)

💖 NAME 💖

HTML::Microformats::Format::OpenURL_COinS — bestie, it's the OpenURL COinS poshformat ✨

---

🦋 SYNOPSIS 🦋

use HTML::Microformats::DocumentContext;
use HTML::Microformats::Format::OpenURL_COinS;
use Data::Dumper;

my $context = HTML::Microformats::DocumentContext->new($dom, $uri);
my @objects = HTML::Microformats::Format::OpenURL_COinS->extract_all(
                  $dom->documentElement, $context);
my $object = $objects[0];
print Dumper($object->data);

---

🌸 DESCRIPTION 🌸

So HTML::Microformats::Format::OpenURL_COinS inherits from HTML::Microformats::Format. That's the whole vibe. Go read the base class definition if you wanna know about property getter/setter methods, constructors, all that stuff — it's all described over there, not here. 💅

---

🎀 MICROFORMAT 🎀

Okay so real talk: OpenURL COinS is not technically a microformat. It got developed outside the microformats community and it does not use a lot of the patterns that community came up with. But like... it's still an interesting format, and lowkey maybe even a useful one? 👑

HTML::Microformats::Format::OpenURL_COinS supports COinS as described at http://ocoins.info/, with the following addition:

• Support for additional elements and attributes 👀

OpenURL COinS is only specified to work on <span> elements. This module is like "bestie, why limit ourselves" and allows its use on arbitrary HTML elements. So:

• When used with <q> or <blockquote>, the cite attribute gets consulted in preference to title.
• When used with <link>, <a> or <area>, href is used in preference to title.

When either of the cite or href attributes is used, any leading string ending with a question mark is removed from the attribute value prior to OpenURL processing. Why? So the attribute values can be published as proper links. slay 💖

And when <q> or <blockquote> is used, the quote is taken to be sourced from the entity described by the context object. iykyk ✨

---

🌈 RDF OUTPUT 🌈

So the way HTML::Microformats::Format::hCard differentiates between the business card and the entity represented by the card? This module does that same little split, but for the OpenURL context object versus the book, journal entry, or other publication represented by it. The former is essentially just a set of search parameters you can use to go find the latter. 🔍

The RSS Context module (http://www.openurl.info/registry/fmt/xml/rss10/ctx#) is what describes the context object. Then the Bibo ontology (http://purl.org/ontology/bibo/) and Dublin Core (http://purl.org/dc/terms/) are used to describe the work itself — with data being "back-projected" from the context object where it's not too complicated. No cap. 🫶

---

💀 BUGS 💀

Found a bug? Please report it to http://rt.cpan.org/. Do it. Be a main character. 🙈

---

⭐ SEE ALSO ⭐

• HTML::Microformats::Format
• HTML::Microformats

---

👑 AUTHOR 👑

Toby Inkster <tobyink@cpan.org>.

---

💜 COPYRIGHT AND LICENCE 💜

Copyright 2008-2012 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.

---

And that's the whole page, bestie — brought to you by perl v5.32.1, dated 2021-09-12, from the User Contributed Perl Documentation. Go forth and extract those COinS. 💅✨🍓