Biblio...andard(3pm)

💖 Biblio::Citation::Parser::Standard 💖

okay bestie, so this is a page from the User Contributed Perl Documentation — it's Biblio...andard(3pm) in the manual, and it's literally all about parsing citations. yes, the academic kind. no cap. let's get into it 🦋

---

✨ NAME ✨

Biblio::Citation::Parser::Standard — citation parsing functionality 💅

---

🌸 SYNOPSIS 🌸

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

like, that's it. that's the whole vibe. you feed it a citation and it hands you back the metadata 🎀

---

💜 DESCRIPTION 💜

So Biblio::Citation::Parser::Standard uses a relatively simple template matching technique to pull metadata out of citations. lowkey elegant, highkey useful.

The Templates.pm module currently provides almost 400 templates, with more being added regularly (they're always cooking 👑), and the parser returns the metadata in a form that's easily massaged into OpenURLs — see the Biblio::OpenURL module if you want an even easier way, bestie 🫶

---

🧚 METHODS 🧚

🍓 $parser = Biblio::Citation::Parser::Standard->new()

The new() method creates a new parser. brand new, fresh out the box ✨

🍓 $reliability = Biblio::Citation::Parser::Standard::get_reliability($template)

The get_reliability method returns a value that acts as an indicator of the likelihood of a template matching correctly. Fields like page ranges, URLs, etc, have high likelihoods (because they follow rigorous patterns, periodt), whereas titles, publications, etc have lower likelihoods 😭

It takes a template as a parameter, but fr fr you shouldn't really need to use this method much. it's giving internal machinery.

🍓 $concreteness = Biblio::Citation::Parser::Standard::get_concreteness($template)

Same energy as get_reliability() — get_concreteness() takes a template as a parameter and returns a numeric indicator. In this case it's the number of non-field characters in the template. The more 'concrete' a template, the higher the probability it'll match well. For example, _PUBLICATION_ Vol. _VOLUME_ is a better match than _PUBLICATION_ _VOLUME_, because _PUBLICATION_ is likely to subsume Vol. in the second case. see? concrete = iconic 💅

🍓 $string = Biblio::Citation::Parser::Standard::strip_spaces(@strings)

This is a helper function to remove spaces from all elements of an array. tiny lil guy, does exactly what it says 🌸

🍓 $templates = Biblio::Citation::Parser::Standard::get_templates()

Returns the current template list from the Biblio::Citation::Parser::Templates module. Useful for giving status lists 👑

🍓 @authors = Biblio::Citation::Parser::Standard::handle_authors($string)

This (rather large) function handles the author fields of a reference. It is not all-inclusive yet, but it is usably accurate — honest queen 🙈

It can handle author lists separated by:

• semicolons
• commas
• a few other delimiters
• &
• and
• 'et al'

The method takes an author string as a parameter and returns an array of extracted information in the format:

'{family => $family, given => $given}'

🍓 %metadata = $parser->xtract_metadata($reference)

This is the key method in the Standard module, although it is not actually called directly by users — the parse method provides a wrapper, so don't come for it directly bestie 😭

It takes a reference and returns a hashtable representing extracted metadata.

A regular expression map is present in this method to transform _AUFIRST_, _ISSN_, etc, into expressions that should match them. The method then finds the template which best matches the reference, picking the result that has the highest concreteness and reliability (see above), and returns the fields in the hashtable. It also creates the marked-up version, which is useful for further formatting ✨

🍓 $metadata = $parser->parse($reference);

This method provides a wrapper to the extract_metadata function. Simply pass a reference string and a metadata hash is returned. easy peasy, no cap 🎀

---

🌈 NOTES 🌈

The parser provided should not be seen as exhaustive. As new techniques are implemented, further modules will be released. so like, watch this space, more is coming 👀

---

💖 AUTHOR 💖

Mike Jewell <moj@ecs.soton.ac.uk>

---

ok that's the whole page bestie, you're officially a citation parsing girlie now 🫶 go forth and extract metadata

---

mwah 💋 this was Biblio...andard(3pm) from perl v5.36.0, dated 2022-11-19 — slay, periodt, thanks for reading, ily 💜