NAME

Pod::Parser::I18N - Internationalized POD

SYNOPSIS

use Pod::Parser::I18N;

my $parser = Pod::Parser::I18N->new(
    localizer => [
        { class => 'Gettext', path => '/path/to/data/*.po' }
    ],
    handler   => MyHandler->new()
);

$parser->prse_from_file('/path/to/pod.pod');

DESCRIPTION

This module exists in cases you want to display internationalized/translated versions of your POD.

The idea is to have a thin layer that consumes POD, and runs the text in there through Data::Localize before your actual processor gets to it.

This software is still in its very early stage. Please feel free to send me patches comments. The repository is at:

http://github.com/lestrrat/pod-parser-i18n/tree/master

METHODS

new(%opts)

localizer => $object | \@list | \%hash

Specifies the localizer object to use. If given a hash, it is taken as the parameters passed to Data::Localize::add_localizer(). Given a list, the values are expected to be hash references, each of which are taken as the values to be passed to add_localizer().

handler => $object

Specifies the actual handler that does the POD processing. It must be either a Pod::Parser subclass or an object that implements Pod::Parser::I18N::Handler role.

AUTHOR

Daisuke Maki <daisuke@endeworks.jp>

LICENSE

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