NAME XML::NewsML_G2 - generate NewsML-G2 news items VERSION v0.1.2 INSTALLATION To install this module, run the following commands: perl Build.PL ./Build ./Build test ./Build install SYNOPSIS use XML::NewsML_G2; my $ni = XML::NewsML_G2::News_Item->new(%args); my $writer = XML::NewsML_G2::Writer_2_12(news_item => $ni); my $dom = $writer->create_dom(); DESCRIPTION This module tries to implement the creation of XML files conforming to the NewsML-G2 specification as published by the IPTC. It does not aim in implementing the complete standard, but in covering the most common use cases. For the full specification of the format, visit http://www.iptc.org/site/News_Exchange_Formats/NewsML-G2/ CURRENT STATUS The implementation currently support text items only - no support for images, videos, graphics or multimedia packages yet. Version 2.9 of the standard is frozen, so the output should not change when you update this distribution. Version 2.12 however is not yet frozen, changes in the output are to be expected. SCHEMES AND CATALOGS Before starting to use schemes or catalogs with this module, read the chapter 13 of the NewsML-G2 implementation guide. Go on, do it now. I'll wait. You don't need to use either schemes or catalogs in order to use this module, unless you are required to do so by the NewsML-G2 standard (e.g. the `service' attribute). If you specify a value for such an attribute and don't add a corresponding scheme, creating the DOM tree will die. For all attributes where a scheme is not required by the standard, you can start without specifying anything. In that case, a `literal' attribute will be created, with the value you specified in the `qcode' attribute. For instance: my $org = XML::NewsML_G2::Organisation->new(name => 'Google', qcode => 'gogl'); $ni->add_organisation($org); will result in this output: Google If the qcodes used in your organisation instances are part of a controlled vocabulary, you can convey this information by creating a XML::NewsML_G2::Scheme instance, specifying a custom, unique `uri' for your vocabulary, and registering it with the XML::NewsML_G2::Scheme_Manager: my $os = XML::NewsML_G2::Scheme->new(alias => 'xyzorg', uri => 'http://xyz.org/cv/org'); my $sm = XML::NewsML_G2::Scheme_Manager->new(org => $os); The output will now contain an inline catalog with your scheme: and the literal will be replaced by a qcode: Google If you have multiple schemes, you can package them together into a single catalog, which you publish on your website. Simply specify the URL of the catalog when creating the XML::NewsML_G2::Scheme instance: my $os = XML::NewsML_G2::Scheme->new(alias => 'xyzorg', catalog => 'http://xyz.org/catalog_1.xml'); and the inline catalog will be replaced with a link: API XML::NewsML_G2::News_Item XML::NewsML_G2::Desk XML::NewsML_G2::Genre XML::NewsML_G2::Location XML::NewsML_G2::Media_Topic XML::NewsML_G2::Organisation XML::NewsML_G2::Product XML::NewsML_G2::Provider XML::NewsML_G2::Service XML::NewsML_G2::Topic XML::NewsML_G2::Scheme XML::NewsML_G2::Scheme_Manager XML::NewsML_G2::Writer XML::NewsML_G2::Writer_2_9 XML::NewsML_G2::Writer_2_12 DEPENDENCIES Moose, XML::LibXML, DateTime, DateTime::Format::XSD, UUID::Tiny BUGS AND LIMITATIONS No bugs have been reported. Please report any bugs or feature requests to `bug-xml-newsml_g2@rt.cpan.org', or through the web interface at http://rt.cpan.org. Be aware that the API for this module *will* change with each upcoming release. SEE ALSO XML::NewsML - Simple interface for creating NewsML documents AUTHOR Philipp Gortan `' LICENCE AND COPYRIGHT Copyright (c) 2013, APA-IT. All rights reserved. This module is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This module is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this module. If not, see http://www.gnu.org/licenses/.