LaTeXM...BibTeX(3pm)

πŸ’… NAME πŸ’…

okay bestie, welcome to the LaTeXM...BibTeX(3pm) manual page β€” today’s main character is "LaTeXML::Pre::BibTeX", and it implements a BibTeX parser for LaTeXML. periodt ✨


πŸ’– DESCRIPTION πŸ’–

"LaTeXML::Pre::BibTeX" is your low-level parser bestie for BibTeX database files. It parses and stores a LaTeXML::Pre::BibTeX::Entry for each entry into the current STATE. BibTeX "string" macros are substituted into the field values, but no other processing of the data is done β€” that’s the vibe check. 🫢

if you wanna know how further processing is carried out (and how it can be customized), go look at "LaTeXML::Package::BibTeX.pool.ltxml" β€” it’s giving β€œthe real processing happens over there” energy. πŸ‘‘


πŸŽ€ Creating a BibTeX πŸŽ€

  • my $bib = LaTeXML::Pre::BibTeX->newFromFile($bibname);

Creates a LaTeXML::Pre::BibTeX object representing a bibliography from a BibTeX database file. file-based slay πŸ—‚οΈβœ¨

  • my $bib = LaTeXML::Pre::BibTeX->newFromString($string);

Creates a LaTeXML::Pre::BibTeX object representing a bibliography from a string containing the BibTeX data. string-based slay πŸ§΅πŸ’–


✨ Methods ✨

  • $string = $bib->toTeX;

Returns a string containing the TeX code to be digested by a LaTeXML object to process the bibliography. The string contains all @PREAMBLE data and invocations of \\ProcessBibTeXEntry{$key} for each bibliographic entry. The $key can be used to lookup the data from $STATE as LookupValue('BIBITEM@'.$key). See BibTeX.pool for how the processing is carried out. it’s literally handing off the TeX glow-up πŸ”₯


πŸ¦‹ BibEntry objects πŸ¦‹

This is the representation of a BibTeX entry. main character entry energy πŸ’…

  • $type = $bibentry->getType;

Returns a string naming the entry type of the entry. No aliasing is done here β€” that’s the whole note, bestie. πŸš«πŸ”

  • $key = $bibentry->getKey;

Returns the bibliographic key for the entry. the entry’s little name tag 🏷️✨

  • @fields = $bibentry->getFields;

Returns a list of pairs [$name,$value] representing all fields, in the order defined, for the entry. Both the $name and $value are strings. Field names may be repeated, if they are in the bibliography. yes, duplicates can happen β€” it’s not a bug, it’s the data πŸ’€

  • $value = $bibentry->getField($name);

Returns the value (or undef) associated with the given field name. If the field was repeated in the bibliography, only the last one is returned. last-one-wins behavior, no cap 🧒


πŸ‘‘ AUTHOR πŸ‘‘

Bruce Miller <bruce.miller@nist.gov> β€” iconic authorship moment 🌟


Public domain software, produced as part of work done by the United States Government & not subject to copyright in the US.

mwah πŸ’‹ β€” this page is from perl v5.40.1, dated 2025-11-16, and it’s the LaTeXM...BibTeX(3pm) manual. bye bestie, go parse some bibliographies πŸ’–βœ¨

πŸ“¦ where this page comes from