biblio::citation::parser::jiao(3pm) [debian man page]

Biblio::Citation::Parser::Jiao(3pm)			User Contributed Perl Documentation		       Biblio::Citation::Parser::Jiao(3pm)

NAME

       Biblio::Citation::Parser::Jiao - citation parsing using Zhuoan Jiao's parsing module.

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}."
";

DESCRIPTION

       Biblio::Citation::Parser::Jiao uses a reference parsing module written by Zhuoan Jiao (zj@ecs.soton.ac.uk). This is a good module to use if
       titles are not required (if they are in double-quotes they will be picked up, however).

       For more information see: http://arabica.ecs.soton.ac.uk/code/doc/ref/Parser/about_Citation_module.html

       The module has been repackaged to comply with the ParaCite metadata style and uses the Citation parser interface to preserve
       interoperability with the other modules.

METHODS

       $parser = Biblio::Citation::Parser::Jiao->new()
	   The new() method creates a new parser.

       $metadata = $parser->parse($reference, [$notrim]);
	   This method provides a wrapper to the functions within the Jiao module that carry out the parsing. Simply pass a reference string, and
	   a metadata hash is returned. Note that this is trimmed to comply to OpenURL standards (thus removing some information that you may wish
	   to keep). To prevent this from occurring, ensure that $notrim is non-zero.

AUTHOR

       Original Author: Zhuoan Jiao <zj@ecs.soton.ac.uk>

       Ported to Biblio interface by: Mike Jewell <moj@ecs.soton.ac.uk>

perl v5.10.1							    2009-11-15				       Biblio::Citation::Parser::Jiao(3pm)

Biblio::Citation::Parser::Utils(3pm)			User Contributed Perl Documentation		      Biblio::Citation::Parser::Utils(3pm)

NAME

       Biblio::Citation::Parser::Utils - OpenURL utility functions

DESCRIPTION

       This module contains methods for the parsing of reference metadata into OpenURLs. Although we have aimed to make it 1.0 compliant, there
       may well be errors (please let us know if there are!).

METHODS

       $openurl_hash = Biblio::Citation::Parser::Utils::trim_openurl($openurl)
	   This method takes a hash of metadata, and returns a hash that contains only valid OpenURL fields.

       $openurl_hash = Biblio::Citation::Parser::Utils::decompose_openurl($openurl)
	   This method aims to enrich an OpenURL metadata hash by applying various parsing techniques to the fields.  It decomposes dates into
	   years, months, and days if possible, fills in the appropriate fields if SICIs are present, and ensures URLs, ISBNs, etc, are valid. It
	   returns a pointer to a hash containing the modified metadata, and an array of errors (if any).

       $openurl = Biblio::Citation::Parser::create_openurl($metadata)
	   This method creates and returns an OpenURL from a metadata hash.  No base URLs are prepended to this, so this should be done before
	   using it as a link. URI::OpenURL should be used to generate OpenURLs in place of this function.

       $valid_isbn = Biblio::Citation::Parser::Utils::isbn_check(@isbn_chars)
	   This is a simple function that takes an array of ISBN characters, and returns true if it is a valid ISBN.

       $sici_hash = Biblio::Citation::Parser::Utils::parse_sici($sici)
	   This function takes a SICI string, and returns a hash of information parsed from it, including date information, issn numbers, etc.

       $bici_hash = Biblio::Citation::Parser::Utils::parse_bici($bici)
	   This is not yet implemented, but will eventually be the BICI alternative for parse_sici.

       $escaped_url = ParaTools::Utils::url_escape($string)
	   Simple function to convert a string into an encoded URL (i.e. spaces to %20, etc). Takes the unencoded URL as a parameter, and returns
	   the encoded version.

AUTHOR

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

perl v5.10.1							    2009-11-15				      Biblio::Citation::Parser::Utils(3pm)