RDF::R...:Config(3pm)

💖 NAME 💖

okay so this is RDF::RDFa::Parser::Config — it's the module that hands you configuration sets for the RDFa parser. that's it, that's the vibe. 🎀

✨ DESCRIPTION ✨

bestie, listen. when you build an RDF::RDFa::Parser object, the third argument you pass to the constructor is a configuration set. and guess what — this module is where those configuration sets come from. 🦋

why do they even exist? because the parser has to know how to handle certain features, and those features vary depending on which host language you're in or which RDFa version you're doing. so like, it needs the tea. 💅

the constructor (the only thing you truly need)

$config = RDF::RDFa::Parser::Config->new($host, $version, %options);

$host is the host language. you'd normally pass one of these constants — and the default is HOST_XHTML. internet media types are accepted too (like 'text/html' or 'image/svg+xml'), but ngl it's usually better to use a constant, because some media types are shared (HTML4 and HTML5 both use the same media type, iykyk).

• RDF::RDFa::Parser::Config->HOST_ATOM
• RDF::RDFa::Parser::Config->HOST_DATARSS
• RDF::RDFa::Parser::Config->HOST_HTML32
• RDF::RDFa::Parser::Config->HOST_HTML4
• RDF::RDFa::Parser::Config->HOST_HTML5
• RDF::RDFa::Parser::Config->HOST_OPENDOCUMENT_XML — flat XML, so like "FODT", "FODS", etc
• RDF::RDFa::Parser::Config->HOST_OPENDOCUMENT_ZIP — the zipped ones, "ODT", "ODS", etc
• RDF::RDFa::Parser::Config->HOST_SVG
• RDF::RDFa::Parser::Config->HOST_XHTML
• RDF::RDFa::Parser::Config->HOST_XHTML5
• RDF::RDFa::Parser::Config->HOST_XML

$version is the RDFa version. again, you'd generally supply one of these constants, and the default is RDFA_LATEST. 👑

• RDF::RDFa::Parser::Config->RDFA_10
• RDF::RDFa::Parser::Config->RDFA_11
• RDF::RDFa::Parser::Config->RDFA_GUESS
• RDF::RDFa::Parser::Config->RDFA_LATEST

version guessing, because of course: the root element gets inspected for an attribute called 'version'. if that attribute exists and matches /\bRDFa\s+(\d+\.\d+)\b/i then that match is the version. otherwise, the latest version is assumed. periodt.

%options is a hash of extra options that override the defaults. and yeah, a lot of them are useful, but heads up — they probably also reduce conformance to the official RDFa specifications. 🙈 here's everything that exists; the defaults for XHTML+RDFa1.0 and XHTML+RDFa1.1 are chillin' in brackets.

• alt_stylesheet — the magic rel="alternate stylesheet". [0]
• atom_elements — process <feed> and <entry> specially. [0]
• atom_parser — extract Atom 1.0 native semantics. [0]
• auto_config — go look at the "Auto Config" section. [0]
• bookmark_start, bookmark_end, bookmark_name — elements to treat like OpenDocument's <text:bookmark-start> and <text:bookmark-end> element, plus the associated text:name attribute. you have to set all three to actually use this feature. use Clark Notation to specify namespaces. [all undef]
• cite_attr — support @cite. [0]
• datetime_attr — support the @datetime attribute and the HTML5 <time> element. [0]
• default_profiles — 🚨 THIS OPTION IS NO LONGER SUPPORTED!
• dom_parser — the parser used to turn a markup string into a DOM. 'html', 'opendocument' (i.e. zipped XML) or 'xml'. ['xml']
• embedded_rdfxml — find plain RDF/XML chunks inside the document. 0=no, 1=handle, 2=skip. [0]
• full_uris — support full URIs in CURIE-only attributes. [0, 1]
• graph — turn on support for named graphs. [0]
• graph_attr — the attribute to use for named graphs. use Clark Notation to specify a namespace. ['graph']
• graph_type — graph attribute behaviour, either 'id' or 'about'. ['about']
• graph_default — default graph name. [undef]
• initial_context — space-separated list of URIs, which must be keys in %RDF::RDFa::Parser::InitialContext::Known. [?]
• inlist_attr — support @inlist. [0, 1]
• longdesc_attr — support @longdesc. [0]
• lwp_ua — an LWP::UserAgent to use for HTTP requests. [undef]
• ns — namespace for RDFa attributes. [undef]
• prefix_attr — support @prefix instead of just @xmlns:*. [0, 1]
• prefix_bare — support CURIEs with no colon+suffix. [0]
• prefix_default — URI for the default prefix (like rel=":foo"). ['http://www.w3.org/1999/xhtml/vocab#']
• prefix_nocase — DEPRECATED — it's just a shortcut for prefix_nocase_attr and prefix_nocase_xmlns.
• prefix_nocase_attr — ignore case-sensitivity of CURIE prefixes defined via the @prefix attribute. [0, 1]
• prefix_nocase_xmlns — ignore case-sensitivity of CURIE prefixes defined via xmlns. [0, 1]
• profile_attr — 🚨 THIS OPTION IS NO LONGER SUPPORTED!
• profile_pi — 🚨 THIS OPTION IS NO LONGER SUPPORTED!
• property_resources — @property works for resources. [0, 1]
• role_attr — support for XHTML @role. [0]
• safe_anywhere — allow Safe CURIEs in @rel/@rev/etc. [0, 1]
• safe_optional — allow Unsafe CURIEs in @about/@resource. [0, 1]
• skolemize — mint URIs instead of blank node identifiers. [0]
• src_sets_object — @src sets the object URI (like @href). [0, 1]
• tdb_service — use thing-described-by.org to name some bnodes. [0]
• typeof_resources — allow @typeof to occasionally apply to objects rather than subjects. [0, 1]
• user_agent — a User-Agent header to use for HTTP requests. ignored if lwp_ua is provided. [undef]
• use_rtnlx — use RDF::Trine::Node::Literal::XML. 0=no, 1=if available. [0]
• value_attr — support the @value attribute (like @content). [0]
• vocab_attr — support @vocab from RDFa 1.1. [0, 1]
• vocab_default — default vocab URI (like rel="foo"). [undef]
• vocab_triple — generate a triple from @vocab. [0, 1]
• xhtml_base — process the <base> element. 0=no, 1=yes, 2=use it for RDF/XML too. [1]
• xhtml_elements — process <head> and <body> specially. (different special handling for XHTML+RDFa 1.0 and 1.1, btw.) [1, 2]
• xhtml_lang — support @lang rather than just @xml:lang. [0]
• xml_base — support for the 'xml:base' attribute. 0=only RDF/XML; 1=except @href/@src; 2=always. [0]
• xml_lang — support for the 'xml:lang' attribute. [1]
• xmllit_default — generate XMLLiterals enthusiastically. [1, 0]
• xmllit_recurse — look for RDFa inside XMLLiterals. [0, 1]
• xmlns_attr — support for 'xmlns:foo' to define CURIE prefixes. [1]

there's also an alternative constructor, tagsoup, which comes preloaded with a genuinely useful set of options for dealing with content "from the wild". 🧚

---

🌸 EXAMPLES 🌸

this full example parses RDFa 1.1 inside an Atom document, and it also flips on the non-default 'atom_parser' option so native Atom elements get parsed into the graph too. 💖

use RDF::RDFa::Parser;

$config = RDF::RDFa::Parser::Config->new(
  RDF::RDFa::Parser::Config->HOST_ATOM,
  RDF::RDFa::Parser::Config->RDFA_11,
  atom_parser => 1,
  );
$parser = RDF::RDFa::Parser->new_from_url($url, $config);
$data   = $parser->graph;

this next configuration set parses XHTML+RDFa 1.1 while also parsing any RDF/XML chunks embedded in the document. two for one, we love to see it. ✨

use RDF::RDFa::Parser::Config qw(HOST_XHTML RDFA_11);
$config = RDF::RDFa::Parser::Config->new(
  HOST_XHTML, RDFA_11, embedded_rdfxml=>1);
$parser = RDF::RDFa::Parser->new_from_url($url, $config);
$data   = $parser->graph;

and this one? this one is the config for dealing with (X)HTML content from the wild. iconic. 🦋

$config = RDF::RDFa::Parser::Config->tagsoup;
$parser = RDF::RDFa::Parser->new_from_url($url, $config);
$data   = $parser->graph;

---

👀 SEE ALSO 👀

RDF::RDFa::Parser. that's the one. go read it. 🫶

💜 AUTHOR 💜

Toby Inkster <tobyink@cpan.org>. king behaviour, honestly. 👑

🎀 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. so like, go off. 💅

⚠️ 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.

no cap, it's giving "you're on your own" and honestly? that's the whole disclaimer. 😭

---

and that's the page, bestie!! this was pulled from perl v5.32.1, dated 2021-09-11, and it lives in the RDF::RDFa::Parser::Config section 3pm of the User Contributed Perl Documentation. mwah, go configure something cute. 💖✨🎀