HTML::...at::XFN(3pm)

💖 NAME 💖

HTML::Microformats::Format::XFN — it's giving... the XFN microformat, bestie ✨

---

🌸 SYNOPSIS 🌸

okay so here's the vibe, copy-paste core:

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

my $context = HTML::Microformats::DocumentContext->new($dom, $uri);
my @links   = HTML::Microformats::Format::XFN->extract_all(
                  $dom->documentElement, $context);
foreach my $link (@links)
{
  printf("<%s> %s\n", $link->get_href, join(" ", $link->get_rel));
}

like... grab a context, pull all the links, print the href and the rel. iconic behavior honestly 🫶

---

🦋 DESCRIPTION 🦋

HTML::Microformats::Format::XFN inherits from HTML::Microformats::Format. no cap. so if you wanna know about property getter/setter methods, constructors, all that foundational lore — go read the base class definition, that's where it lives 💅

🎀 Additional Public Methods 🎀

• $xfn->subject_hcard — hands you the hCard for the subject of the relationship. like, if Mary has parent Sue, then Mary is the subject. main character of the sentence fr. if the subject can't be figured out, it may return undef 😭
• $xfn->object_hcard — hands you the hCard for the object of the relationship. same example: if Mary has parent Sue, then Sue is the object. but listen — the person who's the object of the relationship might not even have an hCard on this page, or the parser might just not be able to figure out the right hCard. in either case, it may return undef 🙈

---

✨ MICROFORMAT ✨

HTML::Microformats::Format::XFN supports:

• XHTML Friends Network 1.0 and 1.1, as described at <http://gmpg.org/xfn/1> and <http://gmpg.org/xfn/11>
• the relationship profile described at <http://purl.org/vocab/relationship/>
• XHTML Enemies Network 1.0, as described at <http://xen.adactio.com/>

by default? only XFN 1.1 gets parsed. that's the default setting, periodt. but if the context has profiles matching those other URIs up there, then the other vocabularies are supported too 🔥

---

🌈 RDF OUTPUT 🌈

data comes back using DERI's XFN vocabulary (<http://vocab.sindice.com/xfn#>) — and when appropriate, also Ian Davis' RDF relationship vocab (<http://purl.org/vocab/relationship/>) and Toby Inkster's XEN vocab (<http://buzzword.org.uk/rdf/xen#>). obsessed with the crossover event ngl 💜

---

💀 BUGS 💀

please report any bugs to <http://rt.cpan.org/>. bestie we need the receipts, don't just suffer in silence 🙏

---

⭐ SEE ALSO ⭐

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

---

👑 AUTHOR 👑

Toby Inkster <tobyink@cpan.org>. legend behavior, honestly.

---

💅 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.

okay that one's in all caps for a reason bestie, it means business 😭 no promises, no take-backs, read it and weep (affectionately).

---

and that's the whole page, mwah 💋 — this was perl v5.32.1, dated 2021-09-12, and yeah the manual name is HTML::...at::XFN(3pm) because the directory got truncated like that, we don't make the rules. go slay some microformats 🧚‍♀️✨