NAME¶
HTML::Microformats::Format::OpenURL_COinS - 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¶
HTML::Microformats::Format::OpenURL_COinS inherits from
HTML::Microformats::Format. See the base class definition for a description of
property getter/setter methods, constructors, etc.
OpenURL COinS is not technically a microformat. It was developed outside the
microformats community and does not use many of the patterns developed by that
community. Nevertheless it's an interesting format, and perhaps a useful one.
HTML::Microformats::Format::OpenURL_COinS supports COinS as described at
<
http://ocoins.org/>, with the following addition:
- •
- Support for additional elements and attributes
OpenURL COinS is only specified to work on <span> elements. This
module allows its use on arbitrary HTML elements. When used with <q>
or <blockquote> the 'cite' attribute is 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. This allows for the attibute values to be published as
proper links.
When <q> or <blockquote> is used, the quote is taken to be
sourced from the entity described by the context object.
RDF OUTPUT¶
Like how HTML::Microformats::Format::hCard differentiates between the business
card and the entity represented by the card, this module differentiates
between the OpenURL context object and the book, journal entry or other
publication represented by it. The former is essentially a set of search
parameters which can be used to find the latter.
The RSS Context module
(<
http://www.openurl.info/registry/fmt/xml/rss10/ctx#>) is used to
describe the context object. 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 not too
complicated.
BUGS¶
Please report any bugs to <
http://rt.cpan.org/>.
SEE ALSO¶
HTML::Microformats::Format, HTML::Microformats.
AUTHOR¶
Toby Inkster <tobyink@cpan.org>.
COPYRIGHT¶
Copyright 2008-2011 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.