XML::Generator::RSS10::egms

XML::Generator::RSS10::egms is a Perl module that offers an extension to Dave Rolsky's XML::Generator::RSS10, specifically catering to the UK e-Government Metadata Standard (egms) RSS 1.0 specification.

For UK government RSS feeds, much of the mandatory eGMS metadata is already covered by the standard Dublin Core module. However, the subject category metadata is mandatory and utilizes more complicated RDF XML notation than regular Dublin Core. This is primarily because you're encouraged to pass more than one category for each item.

This module follows the specification for using eGMS metadata in RSS feeds from the LAWS Syndication Guidelines, which ensures that the eGMS category metadata is mandated at both the item and channel levels. For the SubjectCategory element, this module expects to receive an array of categories, where each category is itself an array comprising the name of the controlled list from which the category was taken, and then the category value.

You may pass as many categories as you wish, and for each, the module will assess whether the category is taken from the GCL or LGCL lists and build the RSS code appropriately. In case your category is taken from a different list, such as the APLAWS list, the module treats it in a generic way, as per the guidelines.

In terms of implementation, this is how you can use this module:

 p;$rss->item(
#title, link, description, dc, etc...
egms => {
SubjectCategory => [
['APLAWS','Council and democracy']
]
}
);

Alternatively, you may choose to pass a scalar SubjectCategory, which will be handled as a single, generic category.

 p;$rss->item(
#title, link, description, dc, etc...
egms => {
SubjectCategory => 'news'
}
);

The SYNOPSIS section shows how to use this module, utilizing XML::Generator::RSS10 and other relevant modules. It is a simple matter of passing the relevant metadata through the egms parameter in the format described earlier.