NAME¶

Publican::Translate - Module for manipulating POT and PO files.

VERSION¶

This document describes Publican::Translate version $VERSION

SYNOPSIS¶

        use Publican::Translate;
        my $po = Publican::Translate->new();
        $po->update_pot();
        $po->update_po({ langs => 'fr-FR,de-DE' });
        $po->update_po({ langs => 'all' });
        $po->merge_xml({ lang  => 'fr-FR' });

DESCRIPTION¶

Creates, updates and merges POT and PO files for Publican projects.

INTERFACE¶

new¶

Create a new Publican::Translate object.

update_pot¶

Update the pot files

po2xml¶

Merge XML and PO into a translated XML file.

update_po¶

Update the PO files using msgmerge

update_po_all¶

Update the PO files for all languages

get_msgs¶

Get the strings to translate from an XML::TreeBuilder object

merge_msgs¶

Merge translations in to XML

translate¶

Replace strings with translated strings.

print_msgs¶

Print the translation strings in an XML::TreeBuilder object to a POT file

header¶

Returns a valid PO header string.

normalise¶

Remove extraneous white space.

po_format¶

Format a string for use in a PO file.

po_unformat¶

Remove PO formatting from a string.

po_report¶

Generate translation statistics for the supplied language.

DIAGNOSTICS¶

"unknown args %s"

All subs with named parameters will return this error when unexpected named arguments are provided.

"%s is a required argument"

Any sub with a mandatory parameter will return this error if the parameter is undef.

CONFIGURATION AND ENVIRONMENT¶

Publican requires no configuration files or environment variables.

DEPENDENCIES¶

Carp version Publican File::Copy::Recursive File::Path

INCOMPATIBILITIES¶

None reported.

BUGS AND LIMITATIONS¶

No bugs have been reported. Please report any bugs or feature requests to "publican-list@redhat.com", or through the web interface at <https://bugzilla.redhat.com/bugzilla/enter_bug.cgi?product=Publican&amp;component=publican>.

AUTHOR¶

Jeff Fearn "<jfearn@redhat.com>"