MARC::Crosswalk::DublinCore - Convert data between MARC and Dublin Core


MARC-Crosswalk-DublinCore documentation  | view source Contained in the MARC-Crosswalk-DublinCore distribution.

Index


NAME

Top

MARC::Crosswalk::DublinCore - Convert data between MARC and Dublin Core

SYNOPSIS

Top

	my $crosswalk = MARC::Crosswalk::DublinCore->new;

	# Convert a MARC record to Dublin Core (simple)
	my $marc = MARC::Record->new_from_usmarc( $blob );
	my $dc   = $crosswalk->as_dublincore( $marc );

	# Convert simple DC to MARC
	$marc = $crosswalk->as_marc( $dc );

	# Convert MARC to qualified DC instead
	$crosswalk->qualified( 1 );
	$dc = $crosswalk->as_dublincore( $marc );

DESCRIPTION

Top

This module provides an implentation of the LOC's spec on how to convert metadata between MARC and Dublin Core format. The spec for converting MARC to Dublin Core is available at: http://www.loc.gov/marc/marc2dc.html, and from DC to MARC: http://www.loc.gov/marc/dccross.html.

NB: The conversion cannot be done in a round-trip manner. i.e. Doing a conversion from MARC to DC, then trying to go back to MARC will not yield the original record.

INSTALLATION

Top

To install this module via Module::Build:

	perl Build.PL
	./Build         # or `perl Build`
	./Build test    # or `perl Build test`
	./Build install # or `perl Build install`

To install this module via ExtUtils::MakeMaker:

	perl Makefile.PL
	make
	make test
	make install

METHODS

Top

new( %options )

Creates a new crosswalk object. You can pass the "qualified" option (true/false) as well.

	# DC Simple
	$crosswalk = MARC::Crosswalk::DublinCore->new;

	# DC Qualified
	$crosswalk = MARC::Crosswalk::DublinCore->new( qualified => 1 );

qualified( $qualified )

Allows you to specify if qualified Dublin Core should be used in the input or output. Defaults to false (DC simple).

	# DC Simple
	$crosswalk->qualified( 0 );

	# DC Qualified
	$crosswalk->qualified( 1 );

as_dublincore( $marc )

convert a MARC::Record to a DublinCore::Record.

as_marc( $dublincore )

convert a DublinCore::Record to a MARC::Record. NB: Not yet implemented.

TODO

Top

* Implement as_marc()
* add tests

SEE ALSO

Top

* http://www.loc.gov/marc/marc2dc.html
* http://www.loc.gov/marc/dccross.html
* MARC::Record
* DublinCore::Record

AUTHOR

Top

* Brian Cassidy <bricas@cpan.org>

COPYRIGHT AND LICENSE

Top


MARC-Crosswalk-DublinCore documentation  | view source Contained in the MARC-Crosswalk-DublinCore distribution.