Biblio...::Jiao(3pm)

💖 Biblio::Citation::Parser::Jiao — the 3pm girlies' citation parser 💖

okay so bestie, you know how you have a messy reference string and you need it to become a tidy little metadata hash? That's literally this. This is the Biblio::Citation::Parser::Jiao page from the User Contributed Perl Documentation, and it's giving citation parsing with the actual muscle coming from Zhuoan Jiao's parsing module. 🦋

---

✨ NAME ✨

Biblio::Citation::Parser::Jiao — citation parsing using Zhuoan Jiao's parsing module. That's the whole vibe. No notes. 💅

---

🌸 SYNOPSIS 🌸

use Biblio::Citation::Parser::Jiao;
# Parse a simple reference
$parser = new Biblio::Citation::Parser::Jiao;
$metadata = $parser->parse("M. Jewell (2002) Citation Parsing for Beginners. Journal of Madeup References 4(3).");
print "The title of this article is ".$metadata->{atitle}."\n";

See how easy that was?? You make a parser, you feed it a reference, you pull out $metadata->{atitle} and you print it. Iconic behaviour, honestly. 😌

---

🎀 DESCRIPTION 🎀

Biblio::Citation::Parser::Jiao runs on a reference parsing module written by Zhuoan Jiao (zj@ecs.soton.ac.uk). This one is a great pick if you don't actually need titles — but heads up, if a title is sitting in double-quotes, it will get picked up anyway. The module simply cannot resist a quoted title. 💀

Wanna read more? The link is:

http://arabica.ecs.soton.ac.uk/code/doc/ref/Parser/about_Citation_module.html

Also super important: this module has been repackaged to comply with the ParaCite metadata style, and it uses the Citation parser interface so it stays interoperable with all the other modules. Bestie behaviour. Team player energy. 🫶

---

💅 METHODS 💅

• $parser = Biblio::Citation::Parser::Jiao->new() — the new() method makes you a brand new parser. Fresh out the box, ready to serve. ✨
• $metadata = $parser->parse($reference, [$notrim]) — this is the main character. It's a wrapper around the functions inside the Jiao module that do the actual parsing work. You pass in a reference string, and a metadata hash comes back to you.

⚠️ Real talk: the result gets trimmed to comply with OpenURL standards — which means some info you might have wanted to keep gets yeeted. If you want to stop that from happening, make sure $notrim is non-zero. Don't say I didn't warn you. 😭

---

👑 AUTHOR 👑

• Original Author: Zhuoan Jiao <zj@ecs.soton.ac.uk>
• Ported to Biblio interface by: Mike Jewell <moj@ecs.soton.ac.uk>

Shoutout to both of them, fr fr. 🎀

---

And that's the page!! This was perl v5.36.0, dated 2022-11-19, and it's filed under Biblio...::Jiao(3pm) in the User Contributed Perl Documentation — so you already know where to find it when you need it again. Byeee, go parse something cute 💖🌸✨