Dist::Zilla::App::Command::msg_merge - Merge localization strings into translation catalogs
In dist.ini:
[LocaleTextDomain] textdomain = My-App lang_dir = po
On the command line:
dzil msg-init fr de
Later, after adding or modifying localizations strings:
dzil msg-merge
This command merges localization strings into translation catalog files. The strings are merged from a GNU gettext-style language translation template, which can be created by the msg-scan command. If no template file is found or can be found, the Perl sources will be scanned to create a temporary one.
msg-scan
This command relies on the settings from the LocaleTextDomain plugin for its settings, and requires that the GNU gettext utilities be available.
LocaleTextDomain
--xgettext
The location of the xgettext program, which is distributed with GNU gettext. Defaults to just xgettext (or xgettext.exe on Windows), which should work if it's in your path. Not used if --pot-file is specified.
xgettext
xgettext.exe
--pot-file
--msgmerge
The location of the msgmerge program, which is distributed with GNU gettext. Defaults to just msgmerge (or msgmerge.exe on Windows), which should work if it's in your path.
msgmerge
msgmerge.exe
--encoding
The encoding to assume the Perl modules are encoded in. Defaults to UTF-8.
UTF-8
The name of the template file to use to merge the message catalogs. If not specified, $lang_dir/$textdomain.pot will be used if it exists. Otherwise, a temporary template file will be created by scanning the Perl sources.
$lang_dir/$textdomain.pot
--copyright-holder
Name of the application copyright holder. Defaults to the copyright holder defined in dist.ini. Used only to generate a temporary template file.
--bugs-email
Email address to which translation bug reports should be sent. Defaults to the email address of the first distribution author, if available. Used only to generate a temporary template file.
--backup
Back up each language file before merging it. The backup files will have the suffix ~.
David E. Wheeler <david@justatheory.com>
Charles McGarvey <ccm@cpan.org>
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.
To install Dist::Zilla::LocaleTextDomain, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Dist::Zilla::LocaleTextDomain
CPAN shell
perl -MCPAN -e shell install Dist::Zilla::LocaleTextDomain
For more information on module installation, please visit the detailed CPAN module installation guide.