---
name: "Publican::Translate"
section: "3pm"
platform: "linux"
package: "publican"
version: "4.3.2-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Publican::Translate"
---

# Publican::Translate(3pm)

Module for manipulating POT and PO files.

## NAME

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

## 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.

### 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.

### detag

Format a string for use in a PO file.

### 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::Path Term::ANSIColor DateTime Locale::PO XML::TreeBuilder String::Similarity

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