HTML::...::hCard(3pm)

💖 HTML::...::hCard 💖

okay so bestie, we're looking at HTML::Microformats::Format::hCard — the hCard microformat, from the HTML::...::hCard(3pm) page in your perl man pages. sit down, grab a boba, this is gonna be good 🧋✨

---

✨ NAME ✨

HTML::Microformats::Format::hCard — the hCard microformat. that's it, that's the whole name, iconic 👑

---

🦋 SYNOPSIS 🦋

the vibe, in code:

use HTML::Microformats::DocumentContext;
use HTML::Microformats::Format::hCard;

my $context = HTML::Microformats::DocumentContext->new($dom, $uri);
my @cards   = HTML::Microformats::Format::hCard->extract_all(
                  $dom->documentElement, $context);
foreach my $card (@cards)
{
  print $card->get_fn . "\n";
}

like, you make a context, you extract all the cards, you loop and print the fn. slay 💅

---

🌸 DESCRIPTION 🌸

HTML::Microformats::Format::hCard inherits from HTML::Microformats::Format. so if you wanna know about the property getter/setter methods, the constructors, all of that — go read the base class definition. it's giving "family business" fr fr 🫶

💜 Additional Method 💜

• to_vcard — this one exports the hCard as a vCard 3.0. it needs RDF::vCard to work, and ngl if that's not available it will throw an error at run-time. no cap 😭
• to_vcard4 — this one exports the hCard as a vCard 3.0. it needs RDF::vCard to work, and yep, it will throw an error at run-time if it's not available 💀
• to_vcard4_xml — exports the hCard as a vCard XML. it needs RDF::vCard and XML::LibXML to work, and it will throw an error at run-time if it's not available. two dependencies, main character energy ✨

---

🎀 MICROFORMAT 🎀

HTML::Microformats::Format::hCard supports hCard as described at <http://microformats.org/wiki/hcard> — with the following additions, and bestie these additions eat:

• vCard 4.0 terms — this module includes extra property terms taken from the latest vCard 4.0 drafts. for example, the property impp may be used to mark up instant messaging addresses for a contact. so you can put someone's IM handles in there, lowkey genius 📱 the vCard 4.0 property kind is used to record the kind of contact described by the hCard (an individual, an organisation, etc). in many cases this is automatically inferred. the module just knows 🔮
• Embedded species microformat — if the species microformat (see HTML::Microformats::Format::species) is found embedded within an hCard, then this is taken to be the species of a contact. cute 🐾
• Embedded hMeasure — if the hMeasure microformat (see HTML::Microformats::Format::hMeasure) is found embedded within an hCard, and no item property is provided, then the measurement is taken to pertain to the contact described by the hCard. it's giving "this height belongs to this person" 📏

---

🌈 RDF OUTPUT 🌈

data is returned using the W3C's vCard vocabulary (<http://www.w3.org/2006/vcard/ns#>) with some supplemental terms from Toby Inkster's vCard extensions vocabulary (<http://buzzword.org.uk/rdf/vcardx#>) and occasional other terms. a little mix, a little remix, we love a curated selection 💖

now, after long deliberation on the "has-a/is-a issue" — drama, honestly — the author of this module decided that the holder of a vCard and the vCard itself should be modelled as two separate resources, and this is how the data is returned. periodt. so some information about the holder of the vCard can be inferred from information about the vCard; for instance, the vCard's fn property can be used to determin the holder's foaf:name. this module uses FOAF (<http://xmlns.com/foaf/0.1/>) to represent information about the holder of the vCard. two resources, one friendship 💞

---

😭 BUGS 😭

please report any bugs to <http://rt.cpan.org/>. don't suffer in silence bestie, tell RT 🫶

---

🔥 SEE ALSO 🔥

HTML::Microformats::Format, 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.

like, no promises, bestie, it is what it is 💀

---

and that's the whole page!! this was perl v5.32.1, dated 2021-09-12, from the HTML::...::hCard(3pm) manual. go forth and mark up your contacts, you absolute legend 🌟💖