rdf::rdfa::parser::opendocumentobjectmodel(3pm) [debian man page]
RDF::RDFa::Parser::OpenDocumentObjectModel(3pm) User Contributed Perl Documentation RDF::RDFa::Parser::OpenDocumentObjectModel(3pm)NAME
RDF::RDFa::Parser::OpenDocumentObjectModel - DOM representation of an OpenDocument Format 1.2 file
DESCRIPTION
You should hopefully not need to use this module to be able to use RDF::RDFa::Parser. It's used internally by the parser to deal with
OpenDocument Format input.
This class provides a "new" constructor and "parse_file", "parse_fh" and "parse_string" methods offering rought compatibility with the
parsing interface described in XML::LibXML::Parser.
It represents an OpenDocument Format 1.2 file (internally a ZIP file containing various XML, RDF/XML and other files) into a single
XML::LibXML::Document with a root element "od:Document". The root element has several child elements with tag names "od:Data" and "od:Meta"
which each contain a single child corresponding to the root element of (respectively) an XML or RDF/XML file found inside the ZIP.
("od:Data" and "od:Meta" elements each have a "file" attribute indicating which file.) This representation is necessarily different to the
"Flat XML" format offered by OpenOffice - trust me.
The "od" namespace URI is http://purl.org/NET/cpan-uri/dist/RDF-RDFa-Parser/opendocument-dom-wrapper <http://purl.org/NET/cpan-
uri/dist/RDF-RDFa-Parser/opendocument-dom-wrapper>.
SEE ALSO
RDF::RDFa::Parser.
XML::LibXML::Parser, HTML::HTML5::Parser.
AUTHOR
Toby Inkster <tobyink@cpan.org>.
COPYRIGHT AND LICENCE
Copyright 2008-2012 Toby Inkster
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system 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.
perl v5.14.2 2012-06-05 RDF::RDFa::Parser::OpenDocumentObjectModel(3pm)
Check Out this Related Man Page
HTML::HTML5::Outline(3pm) User Contributed Perl Documentation HTML::HTML5::Outline(3pm)NAME
HTML::HTML5::Outline - implementation of the HTML5 Outline algorithm
SYNOPSIS
use JSON;
use HTML::HTML5::Outline;
my $html = <<'HTML';
<!doctype html>
<h1>Hello</h1>
<h2>World</h2>
<h1>Good Morning</h1>
<h2>Vietnam</h2>
HTML
my $outline = HTML::HTML5::Outline->new($html);
print to_json($outline->to_hashref, {pretty=>1,canonical=>1});
DESCRIPTION
This is an implementation of the HTML5 Outline algorithm, as per <http://www.w3.org/TR/html5/sections.html#outlines>.
The module can output a JSON-friendly hashref, or an RDF model.
Constructor
o "HTML::HTML5::Outline->new($html, %options)"
Construct a new outline. $html is the HTML to generate an outline from, either as an HTML or XHTML string, or as an
XML::LibXML::Document object.
Options:
o default_language - default language to assume text is in when no lang/xml:lang attribute is available. e.g. 'en-gb'.
o element_subjects - rather advanced feature that doesn't bear explaining. See USE WITH RDF::RDFA::PARSER for an example.
o microformats - support "<ul class="xoxo">", "<ol class="xoxo">" and "<whatever class="figure">" as sectioning elements (like
"<section>", "<figure>", etc). Boolean, defaults to false.
o parser - 'html' (default) or 'xml' - choose the parser to use for XHTML/HTML. If the constructor is passed an
XML::LibXML::Document, this is ignored.
o suppress_collections - allows rdf:List stuff to be suppressed from RDF output. RDF output - especially in Turtle format - looks
somewhat nicer without them, but if you care about the order of headings and sections, then you'll want them. Boolean, defaults to
false.
o uri - the document URI for resolving relative URI references. Only really used by the RDF output.
Object Methods
o "to_hashref"
Returns data as a nested hashref/arrayref structure. Dump it as JSON and you'll figure out the format pretty easily.
o "to_rdf"
Returns data as a n RDF::Trine::Model. Requires RDF::Trine to be installed. Otherwise this method won't exist.
o "primary_outlinee"
Returns a HTML::HTML5::Outline::Outlinee element representing the outline for the page.
Class Methods
o "has_rdf"
Indicates whether the "to_rdf" object method exists.
USE WITH RDF ::RDFA::PARSER
This module produces RDF data where many of the resources described are HTML elements. RDFa data typically does not, but RDF::RDFa::Parser
does also support some extensions to RDFa which do (e.g. support for the "cite" and "role" attributes). It's useful to combine the RDF data
from each, and RDF::RDFa::Parser 1.093 and upwards contains a few shims to make this possible.
Without further ado...
use HTML::HTML5::Outline;
use RDF::RDFa::Parser 1.093;
use RDF::TrineShortcuts;
my $rdfa = RDF::RDFa::Parser->new(
$html_source,
$base_url,
RDF::RDFa::Parser::Config->new(
'html5', '1.1',
role_attr => 1,
cite_attr => 1,
longdesc_attr => 1,
),
)->consume;
my $outline = HTML::HTML5::Outline->new(
$rdfa->dom,
uri => $rdfa->uri,
element_subjects => $rdfa->element_subjects,
);
# Merging two graphs is pretty complicated in RDF::Trine
# but a little easier with RDF::TrineShortcuts...
my $combined = rdf_parse();
rdf_parse($rdfa->graph, model => $combined);
rdf_parse($outline->to_rdf, model => $combined);
my $NS = {
dc => 'http://purl.org/dc/terms/',
o => 'http://ontologi.es/outline#',
type => 'http://purl.org/dc/dcmitype/',
xs => 'http://www.w3.org/2001/XMLSchema#',
xhv => 'http://www.w3.org/1999/xhtml/vocab#',
};
print rdf_string($combined => 'Turtle', namespaces => $NS);
SEE ALSO
HTML::HTML5::Outline::RDF, HTML::HTML5::Outline::Outlinee, HTML::HTML5::Outline::Section.
HTML::HTML5::Parser, HTML::HTML5::Sanity.
AUTHOR
Toby Inkster, <tobyink@cpan.org>
ACKNOWLEDGEMENTS
This module is a fork of the document structure parser from Swignition <http://buzzword.org.uk/swignition/>.
That in turn includes the following credits: thanks to Ryan King and Geoffrey Sneddon for pointing me towards [the HTML5] algorithm. I also
used Geoffrey's python implementation as a crib sheet to help me figure out what was supposed to happen when the HTML5 spec was ambiguous.
COPYRIGHT AND LICENCE
Copyright (C) 2008-2011 by Toby Inkster
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
perl v5.14.2 2011-10-20 HTML::HTML5::Outline(3pm)