Documentación multilenguaje POD

Question

¿Hay alguna forma de escribir documentación en varios idiomas usando POD? Si no, ¿en qué debo escribirlo (ya tengo la documentación de POD en inglés, así que querré convertirla y luego traducirla)?

Answer 1

1. Si está preguntando si POD admite la codificación que no es en inglés, la respuesta es un SÍ rotundo. Aquí está un ejemplo de artículo de Brian D de Foy (en formato POD) traducido al ruso: http://perlrussia.ru/article/brians-guide/brian%27s_guide.ru.pod

2. Si se preguntan si es posible pegar POD en varios idiomas en el mismo archivo, hay una bastante curioso ejemplo aquí: http://cpansearch.perl.org/src/HIO/Unicode-Japanese-0.47/lib/Unicode/Japanese.mlpod

   utiliza Pod::Multilang

   sin embargo, no estoy del todo seguro de cómo (o incluso si) funciona, ya que no pude encontrar dos ejemplos de hTML generados directamente de que mlpod.

3. Ver http://perldoc2.sourceforge.net/ - este es un proyecto para perldoc internacional

Answer 2

Si usted está preparando su módulo para la distribución en CPAN, crear .pod archivos separados para las traducciones de la documentación.

Por ejemplo, si ha incluido la documentación en Inglés My/Module.pm, podría crear los archivos My/Module-jp.pod, My/Module-ru.pod, etc .:

=head1 NAME 

My::Module-pl - Atin-lay Ig-pay ocumentation-day or-fay y-may odule-may 

=head1 ERSION-VAY 

1.01 

=head1 ESCRIPTION-DAY 

...