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

SYNOPSIS
           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
   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
   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
 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
   * Implement as_marc()
   * add tests

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

AUTHOR
   * Brian Cassidy <[email protected]>

COPYRIGHT AND LICENSE
   Copyright 2005 by Brian Cassidy

   This library is free software; you can redistribute it and/or modify it
   under the same terms as Perl itself.