View on
MetaCPAN is shutting down
For details read Perl NOC. After June 25th this page will redirect to
Charles McGarvey > Dist-Zilla-LocaleTextDomain > Dist::Zilla::App::Command::msg_compile



Annotate this POD


New  2
Open  0
View/Report Bugs
Module Version: 0.91   Source  

Name ^

Dist::Zilla::App::Command::msg_compile - Compile language translation files

Synopsis ^

In dist.ini:

  textdomain = My-App
  lang_dir = po

On the command line:

  dzil msg-compile po/fr.po

Description ^

This command compiles one or more GNU gettext-style language catalogs into a directory in your distribution. The idea is to be able to easily compile a catalog while working on it, to see how it works, without having to compile the entire distribution. It can either compile the specified translation files, or will scan the language directory to compile all the translation files in the distribution. It relies on the settings from the LocaleTextDomain plugin for its settings, and requires that the GNU gettext utilities be available.




Destination directory for the compiled catalogs. The compiled language files will be stored in this directory as LocaleData/$language/LC_MESSAGES/$ As long as the specified directory is in Perl's @INC, Locale::TextDomain should be able to find them there. Defaults to the current directory.


The location of the msgfmt program, which is distributed with GNU gettext. Defaults to just msgfmt (or msgfmt.exe on Windows), which should work if it's in your path.

Author ^

David E. Wheeler <>

Contributor ^

Charles McGarvey <>

Copyright and License ^

This software is copyright (c) 2012-2017 by David E. Wheeler.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

syntax highlighting: