HTML::...Context(3pm)

💖 NAME 💖

ok so bestie, welcome to HTML::Microformats::DocumentContext — it's literally the context for microformat objects ✨ (perl v5.32.1 vibes, and yes this page is the HTML::...Context(3pm) one 🎀)

---

🌸 DESCRIPTION 🌸

okay so here's the tea: microformat objects are like, needy. They need context to actually make sense when you're parsing them 🫶 For example, you need a base URI to resolve relative URI references, and you need a full copy of the DOM tree to implement the include pattern. No context, no slay. Periodt.

✨ Constructor ✨

• $context = HTML::Microformats::DocumentContext->new($dom, $baseuri) — creates a new context from a DOM document and a base URI 💅

⚠️ heads up bestie: $dom will be modified, so if you care about keeping it pristine, make a clone first. this is not a drill 😭

🦋 Public Methods 🦋

• $context->cache — a Microformat cache for the context 💖 This prevents the same microformat object from being parsed and reparsed — like, an adr parsed first in its own right, and later as a child of an hCard. obsessed with the efficiency honestly.
• $context->document — returns the modified DOM document 📄
• $context->uri( [$relative_reference] ) — called without a parameter, it returns the context's base URI. Called with a parameter, it resolves the URI reference relative to the base URI ✨
• $context->document_uri — returns a URI representing the document itself 🎀 (usually the same as the base URI.)
• $context->make_bnode( [$element] ) — mint a blank node identifier or a URI 💅 If an element is passed, this may be used to construct a URI in some way.
• $context->profiles — a list of profile URIs declared by the document 🌈
• $context->has_profile(@profiles) — returns true iff any of the profiles in the array are declared by the document 👑
• $context->add_profile(@profiles) — declare these additional profiles 🫶
• $context->representative_hcard — returns the hCard for the person that is "represented by" the page (in the XFN sense), or undef if no suitable hCard could be found 😭
• $context->representative_person_id( [$as_trine] ) — equivalent to calling $context->representative_hcard->id($as_trine, 'holder'), however it magically works even if $context->representative_hcard returns undef ✨ lowkey iconic behaviour
• $context->contact_hcard — returns the hCard for the contact person for the page, or undef if none can be found 💜

hCards are considered potential contact hCards if they are contained within an HTML <address> tag, or their root element is an <address> tag. If there are several such hCards, then the one in the shallowest <address> tag is used; if there are several <address> tags equally shallow, the first is used. iykyk 🌸

• $context->contact_person_id( [$as_trine] ) — equivalent to calling $context->contact_hcard->id($as_trine, 'holder'), however it magically works even if $context->contact_hcard returns undef 💫 again with the magic, we love her for it

---

💀 BUGS 💀

please report any bugs to <http://rt.cpan.org/> 🐛 bestie if you find one, tell the people, don't just suffer in silence 🙈

---

🌈 SEE ALSO 🌈

• 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. 🫡 no cap, it really says that, read it and weep

---

okay bestie that's the whole page, you ate it up 💖 this was perl v5.32.1, dated 2021-09-12, and it's the HTML::...Context(3pm) manual — go forth and parse those microformats, main character energy only 👑✨