Publican::Translate(3pm)

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.

  trans_drop
Snapshot the source to give translation a stable base.

  update_pot
Update the pot files

  po2xml
Merge XML and PO into a translated XML file.

  update_po
Update the PO files using internal process or msgmerge

  merge_po
Merge updated POT files in to existing PO files.

TODO Impliment this...

  match_strings
Compare 2 strings and return how closely they match.

Returns a vlaue between 0 and 1, weighted for string length.

  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>"