NAME

XML::Generator::RSS10::gcl - Support for the UK Government Category List (gcl) specfication

SYNOPSIS

    use XML::Generator::RSS10;
    
    my $rss = XML::Generator::RSS10->new( Handler => $sax_handler, modules => [ qw(dc egms gcl lgcl) ] );
    
    $rss->item(
                title => '2004 Council By-Election Results',
                link  => 'http://www.example.gov.uk/news/elections.html',
                description => 'Results for the 2004 Council by-elections',
                dc => {
                   date    => '2004-05-01',
                   creator => 'J. Random Reporter, Example Borough Council, j.r.reporter@example.gov.uk',
                },
                egms => {
                   SubjectCategory => [
                                         ['GCL','Local government'],
                                         ['LGCL','Elections'],
                                         ['LGCL','News announcements']
                                      ]
                }
              );
    
    $rss->channel(
                   title => 'Example Borough Council News',
                   link  => 'http://www.example.gov.uk/news/',
                   description => 'News releases from Example Borough Council',
                   dc => {
                      date       => '2004-05-01',
                      creator    => 'J. Random Administrator, Example Borough Council, j.r.administrator@example.gov.uk',
                      publisher  => 'Example Borough Council',
                      rights     => 'Copyright (c) Example Borough Council',
                      language   => 'en',
                      coverage   => 'Example, County, UK'
                   },
                   egms => {
                      SubjectCategory => [
                                            ['GCL','Local government'],
                                            ['LGCL','News announcements']
                                         ]
                   }
                 );

DESCRIPTION

This module extends Dave Rolsky's XML::Generator::RSS10 to support categories taken from the UK Government Category List (gcl), a controlled vocabulary for use in the UK e-Government Metadata Standard (egms).

The module is intended for use only with XML::Generator::RSS10::egms. Please see the documentation accompanying that module for further information.

CAVEAT

This module has no awareness of what categories are actually in the GCL. Moreover, it calculates the appropriate reference to the GCL RDF schema by taking the category you supply and putting it in CamelCase. I'm not aware of any categories for which this would result in an incorrect reference, but exceptions would constitute a bug.

BUGS

Please let me know of any you find. You can use the CPAN bug tracker for this by emailing bug-XML-Generator-RSS10-gcl@rt.cpan.org.

SEE ALSO

XML::Generator::RSS10, XML::Generator::RSS10::egms.

AUTHOR

Andrew Green, <andrew@article7.co.uk>.

Sponsored by Woking Borough Council, http://www.woking.gov.uk/.

LICENSE

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