HTML::...hAudio(3pm)

💖 NAME 💖

HTML::Microformats::Format::hAudio — the hAudio microformat, bestie. that's it, that's the whole vibe ✨

---

🎀 SYNOPSIS 🎀

okay so here's how you actually use it, copy-paste girlies rise:

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

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

like. look at her go. she extracts. she prints. she slays 💅

---

🌸 DESCRIPTION 🌸

so HTML::Microformats::Format::hAudio inherits from HTML::Microformats::Format. that's her mother, her blueprint, her blueprint-mother if you will 🫶

and if you wanna know about property getter/setter methods, constructors, all that foundational lore? go read the base class definition, because that's where it lives, not here. iykyk.

---

🦋 MICROFORMAT 🦋

HTML::Microformats::Format::hAudio supports hAudio 0.91 exactly as described at <http://microformats.org/wiki/hAudio>, and then she's like "and also, bonus" with these:

• 'publisher' property — you can have a 'publisher' property with an embedded hCard in it, and that's how you say who published the audio item. like. the record label. the whole entity. iconic.
• 'title' property — okay so in earlier drafts of hAudio (yes the original literally says "pf hAudio", we don't fix typos, we honor them 💀), the 'fn' property used to be called 'title'. this module supports the older class name for backwards compatibility, because she's thoughtful like that. but — and this is the important part — when both are provided, only 'fn' will be used. 'title' gets ghosted. periodt.

---

🌈 RDF OUTPUT 🌈

RDF output uses Manu Sporny's audio vocabulary over at <http://purl.org/media/audio>. that's the whole sentence. no cap.

---

💀 BUGS 💀

found a bug? pls report it to <http://rt.cpan.org/>. she wants to know. she wants to grow. 🌱

---

👑 SEE ALSO 👑

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

---

💜 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. (same terms as Perl, bestie, go check those.)

---

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

translation: she comes with NO promises, no guarantees, nothing, zero, nada. if it breaks, that's between you and the universe 😭

---

okay that's the whole page 🫶 this was written for perl v5.32.1 and dated 2021-09-12 — and it lives under User Contributed Perl Documentation, which is exactly the energy we're bringing. mwah. 💖✨